If your project requires lookup data, you must select the Lookup check box in the Basic Info tab of the Project Metadata page. Selecting this check box adds the Project Lookup Files sub-tab to the Basic Info tab.
To add lookup data to your project:
Navigate to the Project Lookup Files sub-tab. This sub-tab can have two parts if you want to add curation data to the project, or just one if you want to add taxonomy details.
Adding Taxonomy Files
Taxonomy files are typically CSV or XLS files that contain classification values that must be populated in the labeling UI so annotators can select them from drop-down lists. For example, taxonomy values for a writing pencil could be: Office Supplies > Writing & Drawing Supplies > Pens & Pencils > Pencils > Writing Pencils.
To add a taxonomy file:
Click choose File in the Taxonomy sub-tab and select the file that you want to add.
Click Submit.
If your file is structured correctly, your file is now uploaded to your project, and the page now displays your new file in the Annotation sub-tab. To know more about structuring your taxonomy files, see Understanding Taxonomy Files.
Understanding Taxonomy Files
Taxonomy files help you specify the category to which an item belongs and provide additional information that can help the annotator understand--or search for--the item reliably.
Taxonomy files in Taskmonk can have the following details, with each detail type listed as a column header in the taxonomy file:
| | |
---|
category_id | The ID of the category to which the item belongs. | writing_pencils |
---|
category_path | The category path that contains the category ID. | Office Supplies > Writing & Drawing Supplies > Pens & Pencils > Pencils |
---|
category_name | The name of the category. | Writing Pencils |
---|
Description | Description of the item. Depending on the requirement, details from the description can be used to provide curation details for the item. | Pencils that one can write with, with eraser tip or otherwise. |
---|
images links | Links to images that can help the labeler understand the item better. | NA |
---|
Plural | The plural form of the item. This is useful while searching for the item while labeling. | writing pencils |
---|
Singular | The singular form of the item. This is useful while searching for the item while labeling. | writing pencil |
---|
While using taxonomy files, you must use column heads exactly as listed above.
Sample Taxonomy File
For best results, download this Sample Taxonomy File and update it with the required details. If you wish to provide additional details in your taxonomy, please contact support@taskmonk.ai.
Adding Curation Files
Curation files are typically CSV or XLS files that contain additional details that must be populated in the labeling UI so annotators can select them from drop-down lists. For example, curation values for a writing pencil could be brand, size, color, and so on. This helps users distinguish between two items that have the same taxonomy but are different in particular respects. Thus a writing pencil could be of a specific brand that the labeler must select from a dropdown, thus distinguishing it from writing pencils that belong to other brands.
To add a curation file:
Click choose File in the Curation sub-tab and select the file that you want to add.
Click Submit.
If your file is structured correctly, your file is now uploaded to your project, and the page now displays your new file in the Curation sub-tab. To know more about structuring your curation files, see Understanding Curation Files.
Understanding Curation Files
Curation files typically comprise two sheets:
Sheet1: Contains curation properties organized as column headers.
Attributes Closed list: Contains lists of values associated with attributes in Sheet1 that need closed lists. Open lists do not need these values.
Ensure that the names of these sheets remains unchanged. Otherwise, the upload may fail.
Sheet1
The Sheet1 worksheet contains the list of attributes that must be associated with specific categories in the taxonomy file, as detailed below.
| | |
---|
Category | The name of the category to which the item belongs. | Writing Pencils |
---|
Attribute | The attribute that must be associated with the category name. You can associate multiple attributes to the same category by creating a separate row for each attribute. Use camel case when listing out your attributes. | itemsPerPack, brand, displayColor, withEraserTip |
---|
Properties | Lists the properties associated with the attribute. Taskmonk supports the following properties for each attribute: Open List (OR) Closed List: Specifies whether the attribute requires an open or closed list of properties. Single value attribute (OR) Multiple value attribute: Specifies whether the attribute can take one or more properties.
| Open List Single value attribute |
---|
Attributes Closed List
The Attributes Closed List worksheet contains the list of properties that must be associated with specific attributes in the Sheet1 worksheet, as detailed below.
| | |
---|
<attributeName> | The name of the attribute used in Sheet1 of the curation file. You must create one column for each attribute in the order in which they are listed in the Sheet1 worksheet. You must add property values for attributes that use closed lists. To do so, add property values in separate rows under the column headed by that attribute. | itemsPerPack, brand, displayColor, withEraserTip For an example of how to list out attribute properties, see the screenshots below. |
---|
Sample Curation File
For best results, download this Sample Curation File and update it with the required details. If you wish to provide additional details in your curation file, please contact support@taskmonk.ai.