CCP logo



User Interface Tour

Annotation schema

The left hand side of Knowtator shows the classes that are part of the annotation schema. In this contrived example, the class definitions are taken from the Protégé newspaper example project. If the instances pane is visible, then selection of a class in the top window will cause the bottom window to display all of the direct instances of the selected class. Annotations can be created by selecting text in the text viewer (see below) and then right clicking (or double-clicking) on a class or instance.

The root class that is displayed can be changed from the menu.

Text sources

The upper right hand side of Knowtator shows the text sources that are annotated. At the top of this section are several buttons that help navigate a set of text sources. The right most button allows one to open a text source collection. The two left most buttons allow one to iterate through a collection of text sources one at a time.

The text viewer at the bottom of this section allows one to view the text and the spans of the annotations that have been created for the text. To create an annotation simply select some span of text and then right click a class or instance in the annotation schema (described above).

The space to the right of the text viewer provides extra information about a text source. In this example there is only a comment field. However, other arbitrary information associated with a text source can be displayed here.

A text source collection is some arbitrary set of text sources that will be annotated. There is a very simple API that allows one to define a text source collection. One implementation of this interface that is provided with Knowtator allows one to read all of the text files in a single directory. However, a text source collection could easily be implemented that reads text from an XML or from a database. For more information see the page on text source collections.


The lower right hand side of Knowtator displays the annotations that have been created for the displayed text source. This section is divided into three parts. The left most section lists all the annotations that have been created for the selected text source. Selection of an annotation causes information about the annotation to be displayed in the other two sections. The buttons that are provided directly above the list of annotations allow one to grow and shrink the span associated with an annotation.

The middle section shows information about the annotation's relationships to other annotations. Each annotation is directly associated with a class or instance from the annotation schema. The properties (called slots in Protégé parlance) of these classes and instances inform Knowtator as to how annotations can relate to other annotations. In this screenshot which uses Protégé's default newspaper example, the selected annotation has "newspaper" as its annotated class. In the middle section, you can see some of the slots associated with newspaper - the top one is labelled contents. One could relate an annotation about the sports section with the "newspaper" annotation via the contents slot.

The right most section shows some of the book keeping information for the selected annotation. Information such as the span or spans that have been assigned to the annotation, the annotator who created the annotation, the annotation sets that the annotation belongs to, the text source, etc. can all be viewed an manually edited here. Typically, these values are automatically filled when an annotation is created.

If an annotation requires multiple spans do the following:


The Knowtator menu allows one to configure Knowtator in several important ways. The first menu item labelled configure allows one to set the default annotator and annotation set that should be used for new annotations. One can also set an annotation filter which allows one to look at only a subset of the available annotations.

The other menu items allow one to show/hide instances in the annotation schema, change the root class of the annotation schema, and assign a color to a class in the annotation schema, respectively.