Taxonomies
Taxonomies provides a structured way of defining your object label categories. Taxonomies allow you to re-use a set of label classes and attributes over different projects. A simple taxonomy is shown below.
Taxonomy
JSON Representation
1
{
2
"categories": [
3
{
4
"name": "object",
5
"children": [
6
{
7
"name": "bus",
8
"classId": 0,
9
"children": []
10
},
11
{
12
"name": "traffic light",
13
"classId": 1,
14
"children": []
15
},
16
{
17
"name": "traffic sign",
18
"classId": 2,
19
"children": []
20
},
21
{
22
"name": "person",
23
"classId": 3,
24
"children": []
25
},
26
{
27
"name": "bike",
28
"classId": 4,
29
"children": []
30
},
31
{
32
"name": "truck",
33
"classId": 5,
34
"children": []
35
},
36
{
37
"name": "motor",
38
"classId": 6,
39
"children": []
40
},
41
{
42
"name": "car",
43
"classId": 7,
44
"children": []
45
},
46
{
47
"name": "train",
48
"classId": 8,
49
"children": []
50
},
51
{
52
"name": "rider",
53
"classId": 9,
54
"children": []
55
}
56
]
57
}
58
],
59
}
Copied!
Each taxonomy entry has:
  • A unique category name
  • A unique category ID [0,n) where n is the number of classes.
  • A color that will be used when displaying the label.
Each taxonomy entry can have child categories as well, up to a depth of 3 levels.
Nested categories
Creating nested taxonomies through interactive UI is coming soon. Nested taxonomies can be created through the JSON editor.

Creating a taxonomy

You can either create a simple non-nested taxonomy using simple creation, or build a taxonomy from scratch using the JSON editor. Type a category name and press enter to add it to the taxonomy list.
The taxonomy JSON is a list of single taxonomy entries of the following format:
1
{
2
"name": "classname",
3
"classId": 0,
4
"children": []
5
}
Copied!
The name field is a unique string for the object class, classId is a corresponding unique integer, any subclasses for this object will be inside the children field. In the complete example below, you can see that the root taxonomy entry name: object doesn't require a classId.
1
[
2
{
3
"name": "object",
4
"children": [
5
{
6
"name": "outdoor",
7
"classId": 0,
8
"children": [
9
{
10
"name": "sports",
11
"classId": 1,
12
"children": []
13
}
14
]
15
},
16
{
17
"name": "indoor",
18
"classId": 2,
19
"children": []
20
}
21
]
22
}
23
]
Copied!

Attributes

Label attributes are coming soon.
Last modified 4mo ago