> 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/ko/python-sdk/mindkosh.md).

# Mindkosh 포인트클라우드 주석 형식

포인트클라우드의 큐보이드, 폴리라인 및 분할 주석을 위한 Mindkosh 주석 형식 설명.

### 버전 관리

1. v1.1 - 이 형식은 모든 프레임의 주석을 하나의 JSON 파일에 포함합니다.
2. v1.2 - 이 형식은 각 프레임마다 별도의 JSON 파일을 사용합니다.
3. v2.0 - 이 형식에는 다음 추가 필드가 포함됩니다:
   1. 버전
   2. 작업 이름

다음 설명은 형식 버전 2.0에 해당합니다. 다른 형식의 내보내기 파일이 있다면 변환 스크립트를 사용할 수 있습니다 - `mindkosh1_1tomindkosh2.py`  및  `mindkosh1_2tomindkosh2.py`  (Python SDK에서 찾을 수 있음) 이를 새 형식으로 변환합니다. 2025년 6월 28일 이후에 생성된 모든 내보내기는 v2.x 형식입니다

### 내보내기 구조

#### JSON 파일

각 프레임의 주석은 해당 프레임의 JSON 파일에 지정됩니다. 예를 들어, 프레임 5의 모든 cuboid 주석은 `cuboids/5.json` 파일에서 찾을 수 있습니다.

#### 파일 목록

해당 `frames_list.text` 에는 프레임 번호와 파일명이 공백으로 구분된 목록이 포함되어 있습니다. 각 프레임은 별도의 줄에 지정됩니다.

#### 라벨 사양

해당 `label_attrspec.json` 파일은 라벨과 해당 속성을 설명합니다. 각 라벨은 id, 이름, 색상, 속성으로 설명됩니다.

각 속성은 id, 이름, 입력 유형, 기본값으로 지정됩니다. 입력 유형은 `라디오`, `텍스트`, `숫자`, `체크박스`.

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

###