- 04 Apr 2023
- Updated On 04 Apr 2023
Dataloops' taxonomy is based on 2 main entities - Recipe and Ontology.
Recipe – Recipe is a container for work instructions, and includes a single Ontology entity, and work instructions as a collections of:
* Annotation tools - mapped to labels from the Ontology
* Annotation settings
* PDF instructions file
The recipe is used when creating a Task (annotation task or QA) - the task binds the Recipe (labels, attributes, instrcutions) with the data and the team to work.
Ontology - Contains the labels (classes) and attributes used in the project. The dataset ontology is the building block of a model and helps defining the information applied on data to represent the knowledge models are then trained to inference.
* Labels (like classes) are the names uses for classifying annotations.
* Attributes allow additional independent degrees of freedom to define labels
- Create, manage and clone recipes
- Change the default recipe of a dataset (switch recipe)
- Add hierarchical labels
- Set label color
- Import labels from TXT file
- Create attributes
- Section ID identifies attributes when using the SDK
- Supports different types of attributes
- Multi-select (check-box)
- Single-select (radio button)
- Import/Export Ontology
To learn how to work with recipes via SDK, read here
- By default, every Dataset is linked with a single Recipe.
- When creating a new Dataset, users can select if to link it with a new Recipe carrying the same name as the Dataset, or link it with an existing one.
- Annotation and QA tasks are linked with a recipe as the work instructions. By default, the recipe is set to be the one linked with the Dataset from which data in the task is taken. However the recipe can be changed when creating/editing a task, therefore a single item can be worked in multiple tasks, each with a different taxonomy.
To open the recipe page for a specific Dataset, use one of the following options:
- In the project dashboard's dataset table, click the 'Recipe' icon for the selected Dataset.
- From the left=side-menu
1. Navigate to Data-Management >> Recipes
2. Locate/search the recipe from the list
3. Click on 'open recipe'
- From an annotation-studio, click the 'Recipe' icon in the Item-Info tab, or the 'Recipe' link above the label-picker section.
The Recipes pages enable performing several actions on recipes.
- Clone - Version a recipe by creating clones and working on different versions of it.
- Delete - delete a recipe.
Deleting a recipe from a dataset that has been set as the recipe for other datasets too (switched recipe), it will be deleted from all linked dataset.
To change the recipe linked with a dataset to another:
- Click on the 3-dots action button of a dataset entry (from either the project-overview or the Datasets page)
- Select 'Switch Recipe'
- Select a different recipe from the list and approve.
Ontologies contain the labels and attributes of a recipe. They do not have representation outside of a specific recipe, and currently reusing an ontology on different recipes requires exporting them from one and importing into another.
To Export or Import an ontology as a JSON file:
- Open the respective recipe
- From bottom right side, select the respective option to either export the ontology, or import one.
To import label/attributes from the platforms' interface:
- Imported labels should be in a TXT file following these guidelines:
1. Every label in a new line
2. Labels hierarchy is by separating them with ".", e.g. "Car.Type.SUV"
- Open the respective recipe
- From the 'Labels & Attributes' tab, select the import option for labels
- Select a TXT file