Guide To: Ontology Manager for cml:shapes

The Ontology Manager allows job owners to create and edit the ontology within an image annotation job. The Ontology Manager supports up to 1,000 unique classes for image shapes, video annotation, and text annotation. For pixel labeling jobs, the class limit is 250 unique classes.

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 three columns: color, title, and description.

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:

  1. To add a new class, click ‘Add Class’. This will insert another row below the last class created.
  2. To delete a class, hover over its row in the table and click the trash icon to the right.
  3. Once you’ve created your ontology, click ‘Save’.

Note: To edit the color, title, description, and output value for each class click on the pencil icon

Creating an ontology via CSV upload

You can also create an ontology by uploading a CSV. To do so, you can follow these steps:

  1. Create a UTF-8 encoded CSV with your ontology. You’ll need the following column headers:
    • display_color (requires a hex code)
    • description
    • class_name


Fig. 2: CSV with Ontology Data

  1. Click ‘upload’ from the Ontology Manager.
  2. 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 the bounding box tool


Was this article helpful?
0 out of 1 found this helpful

Have more questions? Submit a request
Powered by Zendesk