문서 목차
라벨링
데이터셋의 영상 클립이나 이미지에 사람이 판정·라벨을 답니다.
QUANTUM C&S
데이터셋의 영상 클립이나 이미지에 사람이 판정 · 라벨을 답니다.
라벨링 작업은 서버에 저장되므로 여러 사람이 한 작업을 나눠 라벨링하고 진척률을 함께 볼 수 있습니다. 메뉴 데이터셋 > 라벨링(/datasets/labeling)에서 엽니다.
주요 기능
| 기능 | 설명 |
|---|---|
| 작업 만들기 | 데이터셋의 특정 버전을 골라 라벨링 작업을 만듭니다. 원본 버전은 바뀌지 않습니다. |
| 클립(영상) 라벨링 | 영상 클립마다 정상 · 이상을 판정하고 결함 유형 · 심각도 · 설명을 기록합니다. 센서 데이터를 영상과 나란히 봅니다. |
| 바운딩박스(이미지) 라벨링 | 이미지에 박스를 그리고 라벨을 붙입니다. |
| 진척 공유 | 작업별 진척률(라벨된 항목 수/전체)을 모든 참여자가 함께 봅니다. |
| 확정 | 클립 작업의 라벨을 병합해 학습에 쓰는 manifest.jsonl 을 만듭니다. |
핵심 개념 — 작업 버전
작업을 만들면 고른 원본 버전이 복제되어 <원본 버전>-labeling 이라는 작업 버전이 데이터셋에 생깁니다. 같은 이름이 이미 있으면 뒤에 -1, -2 … 가 붙습니다.
| 항목 | 설명 |
|---|---|
| 복제 속도 | 파일을 실제로 복사하지 않으므로 즉시 끝납니다. |
| 원본 보호 | 모든 라벨은 작업 버전에만 쌓이고, 원본 버전은 그대로 남습니다. |
| 라벨 저장 위치 | 항목(클립 · 이미지)마다 같은 이름의 .json 파일로 작업 버전에 저장됩니다. 예: clips/COAT-A-001.mp4 → clips/COAT-A-001.json |
| 동시 작업 | 항목 하나씩 즉시 저장하므로 여러 사람이 동시에 작업해도 다른 사람의 라벨을 덮어쓰지 않습니다. |
참고 데이터셋 화면에 처음 보는
…-labeling버전이 나타나는 것은 라벨링 작업 때문이며 정상입니다. 같은 원본으로 작업을 두 번(예: 1차 라벨링, 검수용 2차) 만들 수도 있습니다.
화면 구성 — 작업 목록
| 영역 | 설명 |
|---|---|
| 요약 카드 | 전체, 진행 중, 완료 작업 수 |
| 필터 | 작업 · 데이터셋 이름 검색, 전체 종류(클립(영상) · 바운딩박스(이미지)), 새로고침 |
| 작업 표 | 아래 열 설명 참고 |
| 열 | 설명 |
|---|---|
| 작업 | 작업 이름과 설명 |
| 종류 | 클립(영상) 또는 바운딩박스(이미지) |
| 데이터셋 | 데이터셋 이름과 원본 버전 → 작업 버전 |
| 진척 | 라벨된 항목 수/전체 항목 수 |
| 상태 | 아래 상태 표 참고 |
| 생성 | 만든 날짜 |
| 작업 | 열기(라벨링 화면으로 이동), 삭제(휴지통) |
| 상태 | 설명 |
|---|---|
| 대기 | 만들어졌지만 아직 라벨이 없습니다. |
| 진행 중 | 라벨링이 진행되고 있습니다. |
| 완료 | 라벨링이 끝났습니다. |
| 보관 | 보관 처리된 작업입니다. |
참고 작업을 삭제해도 작업 버전과 그 안의 라벨은 데이터셋에 남습니다. 작업 버전까지 지우려면 데이터셋 상세 화면에서 버전을 따로 삭제하세요.
라벨링 작업 만들기
1단계: 작업 창 열기
오른쪽 위 새 작업을 누르세요.
2단계: 기본 정보 입력
| 항목 | 설명 | 규칙 |
|---|---|---|
| 작업 이름 | 목록에 보일 이름 | 필수 |
| 종류 | 클립(영상) 또는 바운딩박스(이미지). 종류에 따라 라벨링 화면과 산출물 형식이 완전히 다릅니다. | 필수 |
| 데이터셋 | 라벨링할 데이터셋 | 필수 |
| 원본 버전 | 복제할 버전. 슬러그와 버전은 항상 짝으로 기록됩니다. | 필수 |
| 공개 범위 | 전체 공개 · 그룹 · 비공개 | 선택, 기본 전체 공개 |
| 종류 | 라벨 대상 파일 |
|---|---|
| 클립(영상) | .mp4, .mov, .mkv, .webm |
| 바운딩박스(이미지) | .jpg, .jpeg, .png, .webp, .gif, .bmp, .tif, .tiff |
3단계: 종류별 설정 입력
| 항목 | 종류 | 설명 |
|---|---|---|
| 결함 유형 | 클립 | 쉼표로 구분합니다. 라벨러가 고를 선택지가 됩니다(기본 sticking, nozzle_clog). |
| 센서 컬럼 | 클립 | 이름:단위:역할 을 쉼표로 구분합니다. 역할은 action(액션), state(상태), exogenous(외생) 중 하나입니다. |
| 라벨 목록 | 바운딩박스 | 쉼표로 구분합니다. |
4단계: 생성
생성을 누르세요. "작업을 만들었습니다 (작업 버전 …)" 알림과 함께 목록에 작업이 추가됩니다.
주의 원본 데이터셋에 쓰기 권한이 있어야 작업을 만들 수 있습니다.
클립(영상) 라벨링
목록에서 클립 작업의 열기를 누르면 세 칸 화면이 열립니다. 위쪽에는 데이터셋 이름과 작업 버전, 진척(완료/전체와 비율)이 항상 표시됩니다.
| 영역 | 설명 |
|---|---|
| 왼쪽 — 클립 목록 | 클립 수와 각 클립의 라벨 여부. 클립을 누르면 가운데에 열립니다. |
| 가운데 — 영상과 센서 | 영상, 재생 버튼, 현재/전체 시간. 아래 센서 영역에 작업에서 선언한 센서 값이 영상과 같은 시간축으로 그려집니다. |
| 오른쪽 — 판정 | 판정 입력 폼과 저장하고 다음, 저장 버튼 |
| 생산자 필드 (읽기 전용) | 데이터 수집 단계에서 채운 값(lot_id, 시각, 센서 등). 라벨링 화면에서는 고칠 수 없습니다. |
팁 결함 자체만이 아니라 센서 이벤트와 영상 이벤트가 어긋나는 시점도 함께 확인하세요.
1단계: 판정
판정에서 정상 또는 이상을 고르세요.
2단계: 세부 정보 입력
| 항목 | 설명 | 규칙 |
|---|---|---|
| 결함 유형 | 작업에서 정한 선택지 중 하나 | 이상일 때 필수 |
| 심각도 | 1~5 | 이상일 때, 기본 3 |
| 설명 | 무엇이 보이는지 한 문장 | 선택 |
3단계: 저장
저장하고 다음을 누르면 저장한 뒤 다음 라벨 안 된 클립으로 넘어갑니다. 저장은 현재 클립만 저장합니다. 모든 클립을 라벨하면 "모든 클립을 라벨했습니다" 알림이 뜹니다.
| 키 | 동작 |
|---|---|
| N | 정상 |
| A | 이상 |
| Space | 재생/일시정지 |
| Ctrl+Enter | 저장하고 다음 |
4단계: 확정
라벨링을 마치면 오른쪽 위 확정을 누르세요. 사람이 단 라벨과 생산자 manifest 를 병합해 학습이 읽는 manifest.jsonl 을 작업 버전에 만듭니다.
- 라벨 안 된 클립이 남아 있으면 미라벨 클립이 남아 있습니다 확인 창이 뜹니다. 그래도 진행하려면 그래도 확정을 누르세요.
- 완료되면 확정 결과에 클립 수, 라벨됨 · 미라벨 수, 판정 분포, manifest 레코드가 없는 클립, 생산자 필드가 빈 클립이 보고됩니다.
- 규격 검증은 확정 단계가 아니라 학습 작업을 만들 때 수행됩니다.
참고 확정은 클립 작업에만 있습니다. 바운딩박스 작업은 이미지마다 저장된 라벨 파일이 곧 결과물입니다.
안내 메시지
| 메시지 | 의미와 조치 |
|---|---|
| 센서 컬럼이 선언되지 않았습니다 | 작업 설정에 센서 컬럼이 없습니다. 센서가 필요하면 센서 컬럼을 넣어 작업을 다시 만드세요. |
| 이 클립에 대한 센서 데이터가 없습니다 | 해당 클립의 센서 기록이 없습니다. |
| 센서가 parquet 으로 저장되어 브라우저에서 미리보기를 할 수 없습니다 | 화면 표시만 안 될 뿐 학습에서는 정상적으로 읽습니다. |
| 센서 구간이 클립 길이를 다 덮지 않습니다 | 덮이지 않는 구간은 학습 조건으로 쓸 수 없습니다. |
| 이 데이터셋에 manifest.jsonl 이 없습니다 | 라벨링은 되지만 생산자 필드가 비어 학습 검증을 통과하지 못합니다. 데이터 수집 쪽에서 manifest 를 채워야 합니다. |
바운딩박스(이미지) 라벨링
목록에서 바운딩박스 작업의 열기를 누르세요.
1단계: 이미지 고르기
왼쪽 파일 목록에서 이미지를 고르세요. 라벨링 대기만 보기가 기본으로 켜져 있어 아직 라벨이 없는 이미지만 보입니다. 끄면 전체 이미지가 보입니다.
2단계: 박스 그리기
이미지의 빈 영역을 드래그해 박스를 그리세요.
3단계: 라벨 붙이기
오른쪽 라벨 영역에서 박스의 라벨을 입력하거나 최근 사용한 라벨에서 고르세요.
4단계: 저장
저장(Ctrl/Cmd+S)을 누르거나, 저장하고 다음(N)으로 저장한 뒤 다음 미라벨 이미지로 넘어가세요.
| 키 | 동작 |
|---|---|
| Delete / Backspace | 선택한 박스 삭제 |
| Ctrl/Cmd+S | 저장 |
| N | 저장하고 다음 미라벨 이미지 |
주의 저장하지 않은 박스가 있으면 위쪽에 저장 안 함 표시가 뜨고, 페이지를 벗어나려 할 때 경고합니다.
권한
| 작업 | 필요한 권한 |
|---|---|
| 작업 만들기 | 원본 데이터셋 쓰기 권한 |
| 라벨 저장 · 확정 | 작업 쓰기 권한 |
| 작업 보기 | 작업의 공개 범위(전체 공개 · 그룹 · 비공개) 안에 있음 |
다음 단계
- 라벨링 결과는 작업 버전(
…-labeling)에 있습니다. 전처리 · 학습에 쓸 때는 그 작업 버전을 고르세요. - 월드모델 파인튜닝용 학습셋은 확정한 클립 작업 버전을 전처리의 월드모델 프리셋으로 변환해 만듭니다.