Annotate in detail view

Portion of text annotation

To annotate a portion of text:

1. Select the text portion to be annotated.

2. Select the class from the pop-up list.

   

Note

Classes marked as favorite are placed at the top of the list and they are recognizable by the star next to the class name.

To annotate an occurrence of an entity or token:

1. Select the Entities tab or the Tokens one in the right panel.
2. Select an item to highlight all the occurrences in the document.
3. Click the single occurrence.
4. Select the class from the list of the popup.

After an annotation or a change, an icon suggests to refresh the page.

Annotation look

The annotation chip has two colors:

• On the left, the background color of the short class name. You can set it in the Resources tab.

  Note

  Hover over the short class name to display the full class name in the tooltip.

  

• On the right, the background color represents quality, that is the outcome of experiments:

  • Violet = FN (False Negative)
  • Green = TP (True Positive)
  • Orange = FP (False Positive)

The default color is violet which indicates the annotation is a false negative because it does not—or does not yet—correspond to an extraction.

This color is meaningful inside the documents of test libraries and after experiments, when you check extraction results. If, after an experiment, the annotated text is extracted as expected, the color will become green, indicating the annotation was matched (true positive).

The orange indicates a false positive, that is a result that was not annotated but needs confirmation.

Widen or narrow the annotation chip

To widen or narrow the annotation chip:

1. Hover over the side you want to resize.

2. Drag the outline in the desired position.

   

   

   

   

Fast annotation

To annotate a document with the Fast annotation tool:

1. Select Toggle fast mode to display the fast annotation toolbar.
2. Select the class you want to annotate.
3. Select the portion of text or, if you have highlighted the occurrence of entities and/or tokens, click them in the document.

Example

If you want to fast annotate all the ingredients in a recipe:

1. In the fast annotation bar, select ING that is the chip that represents the Ingredients class.

2. Select the ingredients in the document and they will automatically be annotated as ingredients and displayed in the Classes tab.

   

Or:

1. In the fast annotation bar, select ING that is the chip that represents the Ingredients class.
2. In the right panel, select Tokens, then Lemmas

3. Select onion that is a potential ingredient, its occurrences will be highlighted in the document.

   

4. Select the occurrences of the lemma highlighted in the text to annotate them as ingredients

   

Set Fast annotation by default when opening a document

To set the Fast annotation tool by default when opening a document:

1. Select or select Settings , then Annotations.
2. Switch on or off the Fast annotation radio button to enable or disable the feature.

Annotate by propagation

To annotate a document by propagation:

1. Select an annotation in the text: a pop-up toolbar will appear.
2. Select Propagate on the toolbar.
   

As a result, all the portions of text that are deemed similar to the annotation will tentatively be annotated and the propagation toolbar will be displayed.

Use the propagation toolbar to:

• Browse tentative annotations (A)
• Confirm individual tentative annotations (B)
• Delete a tentative annotation (C)
• Confirm all tentative annotations (D)
• Close the toolbar and delete all the tentative annotations (E)

Set the propagation suggestions types

To set the propagation suggestion types:

1. Select or select Settings , then Annotations

2. Select or deselect the suggestion types you need among:

   • Entities
   • Syncons
   • Lemmas
   • Keywords

Annotate extracted values

Annotations and extractions are listed in the Classes tab of the right panel.

Extractions are available after experiments.

Annotate an extracted value in the text

1. If not displayed, show the extractions.
2. Select the extraction that you want to annotate.
3. Select Annotate .

The chip quality color turns from orange (FP = False Positive) into green (TP = True Positive) and the extraction becomes an annotation.

.

Note

It is possible to use Fast annotation and Annotation by propagation.

Annotate an extracted value in the right panel

1. Select the Classes tab in the right panel.
2. Select the extractions to annotate.
3. Select Annotate selected item .

The extraction indicator in the right panel and the chip quality color in the text change from orange (FP = False Positive) to green (TP = True Positive).

Remove annotations

To remove an annotation from the text:

1. If not displayed, select the annotation from the Classes tab or show it with the Ann button.
2. Select the annotation and select Remove from the pop-up toolbar.

To remove an annotation from the document:

1. Select the Classes tab in the right panel.
2. Expand the class.
3. Select the value.
4. Select Remove selected annotations from the panel toolbar.

To remove all the annotations of a class from the document:

1. Select the Classes tab in the right panel.
2. Select the class.
3. Select Remove selected annotations from the panel toolbar.

Change the class of an annotation

To change the class of an annotation:

1. If not displayed, select the annotation from the Classes tab or show it with the Ann button.

2. Select the annotation in the text and then select Replace from the pop-up toolbar.

   

3. In the pop-up menu, select the new class.

   

Edit the value of an annotation

This operation is useful in case you need to change a class value.

For example, if you have two different persons with the same name, it will be possible to discriminate by varying the value or to consider a different measure of the same value.

To edit the value of an annotation:

1. If not displayed, select the annotation from the Classes tab or show it with the Ann button.

2. Select the annotation in the text and then select Edit from the pop-up toolbar.

   

3. Edit the value in the dialog box.

   

4. Select Save.

Or:

1. Select the Classes tab in the right panel.
2. Select the annotation to edit.
3. Select Edit .
4. Edit the value in the dialog box.
5. Select Save.

The change has effect on the annotation but not on the document.

Move annotations

To move annotations from a class to another:

1. If the advanced annotations utilities are not enabled, select the ellipsis , then Enable advanced annotations utilities.
2. Select the class in the right panel, Classes tab.
3. Select Shift selected class .
4. Select the target class from the Class drop-down menu in the Shift class annotations dialog.
5. Select Save to confirm.

Clone annotations

To clone annotations from a class to another:

1. If the advanced annotations utilities are not enabled, select the ellipsis , then Enable advanced annotations utilities.
2. Select the class in the right panel, Classes tab.
3. Select Clone selected class .
4. Select the target class from the Class drop-down menu in the Shift class annotations dialog.
5. Select Save to confirm.

Show annotations in a document

See how to show annotations in the document in the detail view page.

Show annotations or extractions in condensed document view

If you want to focus on the annotations and/or extractions in their sentences and remove the remaining redundant text:

Select the ellipsis , then Show condensed document.

Annotate in immersive view

Annotation management in the immersive view is the same as in the detail view. Just some collateral tools are missing.

Annotate in PDF document view

Annotation management in PDF document view is the same as in detail view. Just there are some light graphical differences.

To display the class short name, hover over the annotation.

Non-positional annotation

The non-positional annotations don't depend on position in the text.

As first you have to create metadata classes in the resources.

To annotate:

1. Select a text portion that you want to annotate.

2. Select the metadata class from the pop-up list,

   

   the metadata annotation is displayed in the upper part .

Or:

1. Select Create metadata annotation .
2. Select the metadata class from the pop-up list.
3. Enter the hit value in the Metadata annotation window, then Save. The metadata annotation is displayed in the upper part .

Open the Settings Annotation tab

To open directly the Annotation tab in the Settings, select

Normalize annotations to their base form

To normalize annotations to their base form:

1. Select .
2. Switch off or on the Normalize annotations radio button to disable or enable the normalization.

Or:

1. Select Project settings , then the Annotation tab.
2. Switch off or on the Normalize annotations radio button to disable or enable the normalization.