이미지 어노테이터 스키마

이미지 어노테이터 전용 스키마

본 문서는 공통 어노테이터 스키마를 상속합니다.

따라서 extra, relations, annotations, annotationsData, annotationGroups, assignmentId의 최상위 구조와 AnnotationBase, Classification 등 공통 객체 정의는 공통 문서를 참고하세요.

1. 이미지 전용 추가 메타데이터(extra)

키 예시	타입	설명
imageWidth	number	원본 이미지 가로 해상도(px)
imageHeight	number	원본 이미지 세로 해상도(px)
cameraModel	string	촬영 기기·렌즈 정보
captureTime	string	ISO-8601 촬영 시각

위 값들은 예시이며, 프로젝트 요구 사항에 따라 자유롭게 확장할 수 있습니다.

2. 어노테이션 툴별 고유 데이터

모든 어노테이션 객체는 AnnotationBase(공통 스키마 정의)를 상속하며,

아래 필드는 해당 툴에서만 추가됩니다.

툴(tool)	고유 필드	타입	설명
bounding_box	coordinate	{ x, y, width, height }	좌상단(x, y) 좌표와 너비 및 높이 정보(px)
cuboid	coordinate	{ x, y, top, left, width, height, perspectiveRatio }	2.5D 박스 투영 정보
• x, y, width, height: 전면 박스 기준 • left, top: 후면 박스의 오프셋 • perspectiveRatio: 후면 크기 비율 (1 = 동일, 0.5 = 절반 크기)
polygon	coordinate	Point[]	닫힌 다각형의 꼭짓점 배열 (최소 3개)
polyline	coordinate	Point[]	선형 어노테이션을 구성하는 점 배열 (최소 2개)
keypoint	shape	string	키포인트 시각화 모양 (예: circle)
	coordinate	{ x, y }	키포인트 위치 좌표
segmentation	pixelIndices	number[]	마스크로 표현된 픽셀 인덱스 배열

coordinate, pixelIndices 등 실제 값은 동일 ID를 가진

3. 간단 예시 (Bounding Box)

annotations.image_1

{
  "id": "Cd1qfFQFI4",
  "tool": "bounding_box",
  "isLocked": false,
  "isVisible": true,
  "classification": {
    "categories": ["vehicle"],
    "attributes": {}
  }
}

// annotationsData.image_1
{
  "id": "Cd1qfFQFI4",
  "coordinate": { "x": 215, "y": 242, "width": 225, "height": 189 }
}

동일 패턴으로 polygon/polyline/keypoint/segmentation도 annotations ↔ annotationsData 쌍으로 관리됩니다.

coordinate, pixelIndices 등 실제 값은 동일 ID를 가진 annotations와 annotationsData에서 쌍으로 관리됩니다.