The ontology manager allows job owners to create and edit the ontology within an image annotation job. When using cml:shapes in conjunction with the parameter ontology=”true”, you will be prompted to create an ontology from the design page of the job. There are two ways to create an ontology:
Creating an ontology via the UI
You can create and edit an ontology using the ontology manager within the job. On this page you’ll see four columns: color, title, description, and output.
Fig. 1: Ontology Manager
- Color defaults to a randomly selected value, but can be customized using a hex selector by clicking on the arrow next to the color.
- Title is a required field. This is the name of the class in the ontology; it’s what contributors will see when annotating an image.
- Description is optional. This gives contributors a brief, inline description of a class.
Actions within the ontology manager:
- To add a new class, click ‘Add Class’. This will insert another row below the last class created.
- To delete a class, hover over its row in the table and click the trash icon to the right.
- Once you’ve created your ontology, click ‘Save’.
Creating an ontology via CSV upload
You can also create an ontology by uploading a CSV. To do so, you can follow these steps:
- Create a UTF-8 encoded CSV with your ontology. You’ll need the following column headers:
- display_color (requires a hex code)
Fig. 2: CSV with Ontology Data
- Click ‘upload’ from the ontology manager.
- You can either drag your file in or upload it using the file selector. Once you’ve chosen your file, your ontology will be reflected in the UI.
To see how this ontology will look for contributors, preview the job:
Fig. 3: Preview of bounding box tool