Working with Ontologies

Create Ontologies from the Schema tab

To create a new ontology, go to Schema > Ontology and click the Create button. This will take you to a new modal where you can create a new ontology. You will need to provide the following:

  • Name: The name of your ontology. You can search by ontology name when setting up a new labeling project.
  • Object Features: Click the + button under Objects to add object features. By default, Labelbox will search for existing object features by name. If you type in a feature name that does not exist, Labelbox will prompt you to create a new object feature.
  • Tool Type: Click the + button under Classifications to add classification tasks. By default, Labelbox will search for existing classification features by name. If you type in a feature name that does not exist, Labelbox will prompt you to create a new classification feature.

Attach Ontologies to a project

To attach or update the ontology for a project, go to the project Settings > Label editor and click Edit. This will take you to the ontology selection screen. To update your project's ontology, enter the ontology name in the search bar and Labelbox will return all ontologies with matching names.

Note: if you type in an ontology name that does not exist, you can create a new ontology.

Update / edit ontologies

Sometimes, you may want to update an existing ontology due to new project parameters or learnings. This is something that should not be done lightly as it will require you to re-work all existing labels in order to make legacy labels fit into the new ontology.

Reorder features in an ontology

To reorder the features in an ontology, go to Schema > Ontology and find the ontology in question. Click on the ontology you want to edit and a new modal will pop up on the right-hand side of the screen. Hit the Edit button at the top to edit the ontology

In the new modal, simply drag and drop the features into the new order you want to display to your labelers.

Add a new feature to an ontology

To add a new feature to an ontology, go to Schema > Ontology and find the ontology in question. Click on the ontology you want to edit and a new modal will pop up on the right-hand side of the screen. Hit the Edit button at the top to edit the ontology. Next, hit the + button under objects or classifications and search for the feature you want to add.

As a reminder, adding a new feature will not automatically trigger all your existing labels to be re-worked. You will need to manually re-enqueue those data rows.

🚧

Adding a new feature may make old labels not valid

Any labels submitted with the old ontology will still be available for you to use but may no longer be valid under the new ontology. For example, if you add a required classification task, only new labels will have that classification added.

Remove or archive features from an ontology

To remove or archive a feature from an ontology go to Schema > Ontology and find the ontology in question. Click on the ontology you want to edit and a new modal will pop up on the right-hand side of the screen. hit the Edit button at the top to edit the ontology.

From this screen, select the feature you want to remove and click the settings button in the top right corner. Then, you will see the option to remove or archive it from the ontology.

Labelbox will show you the option of removal or archive depending on whether or not any projects using this ontology have any annotations with that feature. If you have existing labels with that feature, then Labelbox must archive the tool in order to continue to show those annotations in the existing labels.

Removing Feature
You can remove Feature from an ontology when no annotation exists within an org using that Feature.

Archiving Feature
You can only archive the Feature from the ontology when there are annotations created using that Feature. There are two benefits of archiving:

  • It allows you the ability to keep a record of the Feature that created the annotations within a project.
  • You can unarchive the Feature anytime. All pre-existing annotations created using that Feature will render in the project.

Re-using existing features (highly recommended)

You can re-use an existing feature when creating or updating a new ontology. The existing feature will auto-populate when you add a new feature in an ontology.

Delete unused ontologies and features

A task that you may want to do periodically is to clean up your unused ontologies or features. This can easily be done from the Schema tab by adjusting the filter to "Show: Unused". When this option is selected, you will be presented with a new button to delete all unused features or ontologies.

This action should only be done if you do not intend to use those ontologies or features and cannot be undone!

πŸ“˜

Ontology size limit

Users can add up to a maximum of 1,000 features (assuming no sub-classifications) per ontology. If you are a paying customer, you can request much higher limits. Please reach out to customer support.

Create an ontology with Python SDK

Python Tutorial

Github

Google Colab

Complete tutorial in Python SDK

Open in Github

Open in Google Colab


Did this page help you?