Mindkosh point cloud annotation format

Description of the Mindkosh annotation format for cuboid, polyline and segmentation annotation for point clouds.

Versioning

1. v1.1 - This format contains annotations from all frames in a single JSON file.

2. v1.2 - This format has separate JSON files for each frame.

3. v2.0 - This format contains the following additional fields:

   1. version

   2. task name

The following description corresponds to format version 2.0. If you have export files of other formats, you can use conversion scripts - mindkosh1_1tomindkosh2.py and mindkosh1_2tomindkosh2.py (Found in the Python SDK) to convert them into the newer format. All exports created after June 28 2025, will be in format v2.x

Export structure

JSON files

Each frame's annotations are specified in its own JSON file. For example, all cuboid annotations for frame 5 can be found in the cuboids/5.json file.

File list

The frames_list.text contains a list of the frame number and the filename separated by a space. Each frame is specified on a separate line.

Label specification

The label_attrspec.json file describes the labels and their attributes. Each label is described by an id, name, color, and attributes.

Each attribute is specified by an id, name, input type and default value. Input types can be radio, text, number, checkbox.