> For the complete documentation index, see [llms.txt](https://docs.mindkosh.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mindkosh.com/python-sdk/mindkosh-point-cloud-annotation-format.md).

# 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`.

<figure><img src="https://mindkosh.slite.com/api/files/mzaOT0iqafVnaX/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoibklqZmp0clpOM2tVMVIiLCJpYXQiOjE3ODc5MDg2NTMsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiemNfWEJzUnFOX20ya3oiLCJleHAiOjE3OTA1MDA2NTN9.ZBdgzu9WwqQgAlTc99S7QvQKSyPjhJ3BLpbQJiZNPqU" alt="image.png"><figcaption></figcaption></figure>

###