Export data
How to export the labeled data.
Last updated
How to export the labeled data.
Last updated
In the projects home tab the "Export labels" button is located below the full description. A click on this button creates a new JSON file containing the labeled data. This button is only enabled if labeled data is available.
The exported JSON file starts with an overview of the label classes defined within the label configuration followed by the list of tasks.
For this documentation the following label configuration was used.
The label classes may look like the following snippet:
The class_names are export keys from the classifications and geometries defined in the label configuration. They are also used in the labels and global_classifications sections for each task. The geometry_type or classification_type describe the type of that classes.
Classifications of type option are exported as type radio if they contain up to three options otherwise they are exported as type select.
Every exported task consists of the following properties:
Property | Description |
internal_media_ID | The internal id to identify the media file. This ID can be used to view or download the image. |
external_media_ID | The media's file name. |
labeler | To identify the assigned labeler. |
status | One of the task's states. See the documentation about the task's lifecycle. |
segmentations | This section is optional and appears only if at least one image segmentation is configured. This list contains the urls to export the semantic maps. See the API documentation for more details. |
global_classifications | Uses the label_classes to describe the image. |
labels | Uses the class names listed in the label_classes section to describe a geometry within the image. |
The global_classifications section uses the class_names defined in the label_classes section to describe the image. This section may look like the following:
Nested classifications are possible.
The label object contains an entry for each geometry type defined in the label_classes section with the class_name as key. Every entry contains a geometry of the assigned geometry_type. Each entry in that list consists of the geometry and classifications sections. The content of the geometry depends on the geometry_type and the classifications are treated like the global_classifications. The labels section may look like the following snippet:
For every geometry_type defined in the label_classes sections, a list of objects is created. Every entry describes an area of interest in the image and is defined by its geometry and classifications.
Image segmentation geometries are basically treated the same way as polygon geometries, except for the fact that they have multiple arrays of points.
The first array of points are the outer points of the segmentation, while every following array is an inner segment that was cut out. The above JSON Snippet corresponds to the Segmentation in the image below.
