Manage annotations

Overview

Annotating documents with the categories included in the taxonomy is critical. This action in fact "teaches" the categorization models to "learn" from these examples and gives them the ability to "predict" similar categorizations.

Annotations should be done for all the information resources before generating the categorization model, according to the principle: "no annotations, no categorizations".

In the Documents tab you can manage annotations.

The Main topics strip, at the top of the document in detail view, can be a hint for proper annotations.

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

Note

A colored dot beside the category in the Resources panel in the list view and in the Taxonomy panel in detail view represents the population count.

= Less than 6 documents annotated for the category.
= Between 6 and 20 documents annotated for the category.
No dots = more than 20 annotations

Warning

The annotation features are disabled in documents in a language other than the one selected for the project.

Annotate a document

Annotating a document means to manually select a category for a text. The selected category is visually represented by an indigo chip .

Annotate a document in the list view

Select or hover over the document.
Select Add category .
Enter the category name, then press Enter.

Note

A notification will suggest a category while typing, if it is included in the taxonomy, and will alert, if the category is not included.

Note

Use the Resources panel on the right side to check if a category is in the taxonomy. You can also search for it using the search bar placed above the taxonomy itself.

Or:

Select the documents you want to annotate, multiple selections with CTRL+CLICK and SHIFT+CLICK are allowed.
Drag the documents in the desired category displayed in the Resources panel on the right side.

Or:

Select more documents with CTRL+CLICK and/or SHIFT+CLICK.
Select Annotate documents .
Type the category name and select Annotate.

Note

A notification will suggest a category while typing, if it is included in the taxonomy, and will alert, if the category is not included.

Tip

If you think that the displayed text is not enough to decide the category of the annotation, select show more or switch to the detail view.

Annotate a document in the detail view

Select a document from the left panel list or consider the opened one.
Select Add category .
Enter the category name, then press Enter.

Or:

Select a category in the Taxonomy panel.
Drag it into the text.

After manual annotations, the Ann annotation counter displays the annotations count.

Annotate suggestions coming from Building magic taxonomy procedure

If you create the taxonomy with the Building magic taxonomy procedure, the documents have annotations suggestions displayed with a dashed outline.

To find suggestions for a category, enter $SUG and the category name in the search bar .
To hide the suggestions, select Hide suggestions .
To show suggestions, select Show suggestions .
To annotate the documents categories, the procedure is the same as already described, but the chip visualization is different .

Annotate resulting categories

Annotating categories in a document means confirming or rejecting categories resulting from an experiment, or even change the already annotated ones. This is an operation that is performed after running an experiment.

Suggested resulting categories are represented by a blue chip:

In detail view the categories counter Cat shows the number of resulting categories.

To annotate a category, in list and detail view:

Select the category chip.
Select Annotate .

If you annotate resulting categories, the chips switch to the green color that represents the true positive TP.

Automatically the other possible returned categories are turned into orange chips that represent false positives FP. It is possible to annotate them too if desired.

The annotation counter Ann is then updated accordingly.

Annotate all the categories in the detail view

To annotate all the categories of the document in the detail view, select Annotate all categories .

Show or hide suggested categories

To hide suggested categories and false positives, select Hide extractions .
To show suggested categories and false positives, select Show extractions .

Remove an annotation or a category

To remove an annotation or a category in list or detail view:

Select the annotation.
Select Remove .

Remove all the categories in detail view

In detail view, if you want to remove all the categories from a document, select Remove all categories .

Replace an annotation

To replace an annotation in list and detail view:

Select the annotation.
Select Replace .
Enter the new category name, then press Enter.

Show the resources for a specific annotation or category

To show the resources for a specific annotation or category when in list and detail view

Select the annotation.
Select Show resources .

The Resources tab displays the category in the taxonomy.

Show the overall annotations for a specific annotation category

To show the overall annotations and the broader category for a specific annotation category in list and detail view:

Select the annotation.
Select Show info .

Note

Each time you—or a cowrker—apply changes to the document, a notification warns you.