비디오 어노테이터
Video annotator
어노테이터의 정의 및 기능
비디오 어노테이터는 비디오 형식 데이터의 라벨링 작업을 지원하는 어노테이터입니다.
비디오 어노테이터에서는 프레임 단위로 객체를 식별하고 라벨을 부여할 수 있도록 지원합니다. 바운딩 박스, 폴리곤 등 다양한 라벨링 방식으로 시계열 데이터에 라벨링을 수행하며, 객체 추적과 같은 연속성 있는 작업을 통해 데이터를 생성할 수 있습니다.
비디오 어노테이터의 구조
비디오 어노테이터는 헤더, 툴바, 에디터, 패널, 단축키 및 설정으로 구성되어 있습니다.

비디오 어노테이터 화면 예시
헤더
현재 어노테이터 작동 모드, 라벨(작업) 정보, 사용자 및 워커 정보, 저장/제출 버튼 등이 표시됩니다. 프로젝트에 설정에 따라 작업 보류, 불량 상태를 허용하는 경우에는 헤더 우측에 보류, 불량 버튼이 추가 생성됩니다.
어노테이터의 작동 모드
어노테이터의 작동 모드는 작업 데이터 모드 / 관리자 모드 / 라벨러 모드 / 검수자 모드 가 있습니다.
: 사용자(관리자 측) 프로젝트에서 작업을 불러온 경우에 해당
: 사용자(관리자 측) 프로젝트에서 할당 작업을 직접 불러온 경우에 해당
: 작업자가 할당 작업을 불러온 경우에 해당
: 검수자가 할당 작업을 불러온 경우에 해당
프로젝트 정보 및 할당 번호
- 프로젝트 명 : 현재 작업하는 할당 작업이 포함된 프로젝트의 이름을 의미합니다.
- 할당 번호 : 현재 작업하는 할당 작업 번호(ID)를 의미합니다.
작업 및 검수 상태 정보
- 작업 상태 : 대기/진행중/보류/완료
- 검수 상태 : 대기/반려
사용자/워커 정보
- 사용자 및 워커(작업자/검수자)의 정보 : 사용자 및 작업자/검수자의 이름과 계정이 보여집니다.
(※ 검수자 화면에서는 해당 할당 작업을 진행한 작업자도 확인 가능함) - 작업 시간 : 현재 작업하는 할당작업에 할애하고 있는 작업 시간이 카운팅됩니다.
작업 수행 관련 버튼
: 현재까지 진행한 어노테이션 대상 데이터의 작업을 임시 저장할 수 있습니다. Ctrl+S단축키로도 임시 저장할 수 있습니다.
: 현재 어노테이션 대상 데이터의 작업을 완료하고 제출할 수 있습니다.
: 검수자가 작업자가 진행한 할당 작업에 대해 반려 처리를 할 수 있는 기능입니다. 할당 작업 방식이 묶음인 경우, 마우스 호버(마우스를 버튼 위에 올려놓는 액션)시 '묶음 반려'가 가능합니다.
: 할당 작업의 데이터에 이상이 있거나 해당 프로젝트와 관련이 없는 데이터인 경우 불량 처리를 할 수 있습니다. 프로젝트 설정에서 '불량' 기능을 허용한 경우에만 해당 기능을 활용할 수 있습니다.
: 검수자가 작업자가 진행한 할당 작업에 대한 승인 처리를 할 수 있는 기능입니다.
: 제출 후 수정을 원하는 경우 해당 기능을 활용할 수 있습니다. 버튼을 누르면 불량 처리 혹은 새로운 제출, 반려 처리 등을 할 수 있습니다.
: 작업 데이터 모드에서 사용자(관리자)가 라벨링 한 작업 결과를 적용할 수 있는 기능입니다.
: 작업/검수 중 해당 할당 작업에서 코너 케이스 혹은 기타 이유로 수행이 어려운 경우 보류 기능을 통해 다음 할당 작업물로 넘어갈 수 있는 기능입니다. 보류 횟수는 프로젝트 설정에서 지정한 횟수만큼 수행할 수 있습니다.
제출 시 어노테이션 검증
제출 시 어노테이션이 없거나, 속성 설정이 안 된 어노테이션이 있는 경우 경고 메시지를 어노테이터 우측 하단에 보여줍니다.
어노테이션이 없는 경우 예시 | 속성 설정이 안 된 경우 예시 |
---|---|
![]() | ![]() |
에디터
에디터는 데이터가 표시되어 어노테이션을 추가하는 공간으로, 프레임 바와 구간 정제 위젯이 위치합니다.
비디오 에디터의 특징

비디오 라벨링 시 데이터의 특성을 반영하여 에디터에 추가적인 영역이 나타납니다. 이 영역을 비디오 컨트롤 영역이라고 하며, 컨트롤 영역은 프레임 바(및 구간 어노테이션 위젯), 음성 파형 그래프, 구간 영역 바, 재생 컨트롤, 프레임 번호로 구성되어 있습니다.

프레임 바 및 구간 어노테이션 위젯
비디오를 프레임 단위로 선택할 수 있습니다. 구간 분리 모드일 경우 프레임바 아래에 구간 어노테이션 위젯이 나타납니다.

음성 파형 그래프
음성의 파형을 보여주는 그래프로, 음성의 파형을 참고하여 발화 내용 혹은 장면을 구분하기 쉽게 도와줍니다.

구간 영역 바
구간 어노테이션의 영역이 나타나는 영역 바입니다.

재생 컨트롤
비디오 재생 관련 버튼 및 재생 진행 표시줄이 표시되는 영역입니다.

프레임 번호
현재 프레임 번호와 총 프레임 수, 초당 프레임 수를 나타냅니다.
툴바
어노테이터 좌측의 툴바 도구는 프로젝트에서 다루는 데이터 유형과 라벨링 전략에 따라 보이는 구성이 달라집니다. 크게 라벨링 도구와 보조 도구로 나누어지며, 관리자는 프로젝트 생성/설정시 오토 라벨링 도구를 비롯한 스마트 툴을 배치할 수 있습니다.
툴바의 도구 사용법은 👉 7-2. 라벨링 도구에서 확인해주세요.
패널
패널은 라벨링 작업을 지원하기 위해 편의를 제공하는 다양한 보조 창을 말합니다. 패널은 위치에 따라 크게 하단 가로 패널, 우측 세로 패널로 나누어 활용할 수 있으며, 각 패널들의 보이기/숨기기, 자리 배치는 사용자가 편의에 따라 언제 이동시켜 활용할 수 있습니다.
패널은 확대/할당 라벨/히스토리/검수 코멘트/에러로그/메타정보/클래스 선택/빠른 보기/어노테이션 그룹/어노테이션 속성/관계/가이드라인 등이 있습니다. 어노테이터 종류별 패널이 다르게 탑재되어 있으며, 작업에 주로 활용하는 패널만 설정하여 효율과 편의성을 높일 수 있습니다.
- 패널 명칭 및 기능
패널명칭 | 패널 기능 |
---|---|
할당 라벨 | 워커에게 할당된 작업의 목록. 할당 작업의 작업/검수 상태 확인, 전후 할당 작업로 이동 가능 |
히스토리 | 작업 내역이 기록된 패널. 이전 작업 상태로 돌아갈 수 있음 |
검수 코멘트 | 검수자는 작업에 대한 코멘트를 등록, 작업자는 검수자의 검수 코멘트를 확인할 수 있는 패널 |
메타정보 | 데이터의 기본 메타 정보(데이터 유형, 크기 등)를 확인할 수 있는 공간 |
어노테이션 그룹 | 생성된 어노테이션들의 그룹화 작업 진행하는 공간. +그룹 추가 버튼으로 그룹 추가 가능 |
어노테이션 속성 | 라벨에 부착한 어노테이션을 확인할 수 있는 패널 |
관계 | 어노테이션 간 생성된 관계를 확인할 수 있음 |
가이드라인 | 관리자가 등록한 가이드라인 게시판에 등록한 글을 확인할 수 있음 |
- 패널 보이기/숨기기 기능
하단 가로 패널의 맨 아래, 세로 패널의 가장 오른쪽에 위치한 패널 이름 탭을 누르면 해당 패널을 숨기거나 보이게 만들 수 있습니다.
패널 탭 버튼 가장 오른쪽 또는 아래쪽의 겹 화살표 표시(>>) 를 누르면 가로 또는 세로 패널 전체를 숨기고 보이게 할 수 있습니다.
- 패널 위치 변경 기능
하단 가로/우측 세로 패널 공간 내에서 순서를 변경하거나 다른 패널 공간으로 위치를 변경하여 패널의 레이아웃을 사용자 마음대로 바꿀 수 있습니다.
패널 탭 버튼을 드래그하여 패널 공간 내에서 원하는 순서에 배치합니다.
각 패널의 우측 상단 이동 버튼을 클릭하여 '하단 가로 패널로 이동/ 우측 세로 패널로 이동'을 눌러 위치를 변경할 수 있습니다.
설정
- 저작도구를 설정하는 곳으로 어노테이션, 전역, 패널 등의 기능들을 설정할 수 있음
구분 | 설정 기능 | 기능 설명 |
---|---|---|
어노테이터 설정 | 어노테이션 두께 어노테이션 선 색상 선택된 어노테이션 선 두께(PX) 선택된 어노테이션 선 색상 편집점 크기(PX) 확대/축소 속도 10(기본값:10) | 어노테이터 내 어노테이션 관련 서식(선 두께, 색상, 편집점 등) 설정 기능 |
전역 설정 | 폰트 크기 | 클래스 선택 패널의 글씨 크기를 선택 |
패널 레이아웃 초기화 | 클래스 선택 패널의 레이아웃 초기화 기능 | |
패널 설정 | 메타정보/어노테이션 그룹/어노테이션 속성/관계/가이드라인/할당 라벨/히스토리/검수 코멘트 | 해당 패널들의 보이기/숨기기 기능 |
단축키
- 라벨링 작업에 필요한 각종 기능의 단축키 정보를 확인할 수 있는 곳으로, 단축키는 특정 기능을 빠르게 실행하기 위한 키보드 상의 키 조합을 의미합니다.
- 툴바 하단에 명령(Command, ⌘) 모양의 단축키 버튼이 위치해 있으며, 작업 중 언제든지 단축키를 확인할 수 있습니다.
도형 그리기/속성 선택 확정 : enter
도형 그리기/선택 취소 : esc
선택된 어노테이션 삭제 : D
어노테이션 복사 : Ctrl+C
어노테이션 붙여넣기 : Ctrl+V
어노테이션 같은 위치에 붙여넣기 : Ctrl+Shift+V
폴리곤 편집점 추가 : Ctrl+마우스 좌클릭
폴리곤 편집점 삭제 : Alt+마우스 좌클릭
Updated 28 days ago