데이터셋
데이터셋 목록과 만들기(직접 업로드·외부 소스), 상세의 개요·파일 탭, 파일 미리보기(이미지·PLY 3D·시계열)
필요 권한: 조회
학습에 쓸 데이터를 모아 두는 곳입니다. 데이터셋은 만드는 즉시 쓸 수 있는 상태가 되고, 이후 파일을 자유롭게 더하거나 지울 수 있습니다. 파일을 올리면 서버가 하나씩 검증해 종류(이미지·어노테이션·포인트클라우드·시계열·표 형식)를 판별하고, 이미지와 어노테이션의 짝을 맞추고, 데이터셋 요약(매니페스트)을 자동으로 다시 씁니다.
보기는 모든 멤버, 만들기·파일 올리기·삭제는 dataset_write(DEVELOPER·OPERATOR·ADMIN)입니다.
데이터셋 목록
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 검색 | 이름으로 찾습니다. |
| ② | 검증 필터 | 전체 · 통과 · 일부 오류 · 실패. |
| ③ | 외부 소스 | 외부 데이터 서버(DataOps) 등록 목록을 엽니다. |
| ④ | 새 데이터셋 | 만들기 대화상자(dataset_write). |
| ⑤ | 검증 | 데이터셋 파일들의 검증 결과 배지. |
표의 모달리티 는 데이터 종류(포인트클라우드·이미지·시계열·표 형식·혼합), 소스 는 어디서 온 데이터인지 적어 둔 메모입니다. 외부 소스와 연결된 데이터셋은 소스 칸에 동기화 배지가 붙습니다.
새 데이터셋
대화상자 위의 두 카드로 방식을 고릅니다.
직접 업로드: 이름·모달리티·소스(선택)만 정해 빈 데이터셋을 만들고, 파일은 상세 화면에서 올립니다. 시계열과 표 형식은 둘 다 CSV/Parquet 이라 여기서 고른 모달리티로 종류가 갈립니다(시계열은 시간축이 있는 계측 이력, 표 형식은 대상 1건이 1행).
외부 소스에서 동기화: 등록된 외부 서버의 원격 데이터셋을 골라 만들고, 바로 첫 동기화를 시작합니다.
외부 소스 목록(외부 소스 버튼)에서는 등록된 서버와 연결된 데이터셋 수를 보고, 연결 확인·수정·삭제를 합니다. 외부 소스를 등록하고 동기화하는 절차는 연동 가이드에서 설명합니다.
데이터셋 상세: 개요
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 요약 | 이름, 검증 배지, 모달리티·파일 수·용량, 학습 가능(학습이 쓸 파일 수) 또는 학습 불가. |
| ② | 동작 | 이 데이터셋으로 학습(develop, 마법사를 이 데이터셋으로 엽니다), 편집(이름·소스·모달리티), 재검증(모든 파일을 다시 검사), 삭제. 편집·재검증·삭제는 dataset_write. |
| ③ | 탭 | 개요 · 파일. |
| ④ | 외부 소스 | 업로드로 관리하는 데이터셋이면 외부 소스 연결, 연결된 데이터셋이면 마지막 동기화와 동기화 버튼. |
| ⑤ | 파일 집계 | 전체·유효·오류·총 용량, 종류별 파일 수, 라벨 짝이 없는 이미지 수. |
| ⑥ | 매니페스트 | 소스·레코드 수·스토리지 위치 등 데이터셋 요약. |
아래로 검증 결과(스키마 적합, 레이블 일치율 등)와 학습 사용 이력(이 데이터셋을 쓴 Run·모델 버전)이 이어집니다.
데이터셋 상세: 파일
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 업로드 | 파일이나 폴더를 끌어다 놓거나 눌러서 고릅니다. 지원 형식은 모달리티에 따라 다르며, 여러 개를 한꺼번에 올리려면 ZIP 으로 묶습니다. 폴더는 ZIP 으로 묶어야 합니다. |
| ② | 필터 | 종류(이미지·어노테이션·포인트클라우드…)와 상태(유효·오류·검증 중·업로드됨). 외부 소스와 연결된 데이터셋은 출처(업로드·동기화) 필터가 더 있습니다. |
| ③ | 정렬·보기 | 최신순·오래된 순·이름순·큰 파일 순, 그리드/테이블 전환. |
| ④ | 파일 카드 | 썸네일·이름·상태·크기·종류·출처. 이미지에는 라벨 있음 / 라벨 없음(짝 어노테이션 유무)이 붙습니다. 누르면 파일 미리보기로 갑니다. |
테이블 보기에서는 파일을 여러 개 골라 선택 삭제 로 한꺼번에 지웁니다. 요약 열에 크기·라벨·매칭률 같은 파일별 요약이 나옵니다.
파일 미리보기
파일 종류마다 미리보기가 다릅니다. 위쪽의 이전·다음 화살표로 목록을 넘기고, 다운로드·삭제 를 합니다.
| 종류 | 미리보기 |
|---|---|
| 이미지 | 원본 이미지. 짝 어노테이션(LabelMe·COCO·VOC)이 있으면 박스·폴리곤·라벨을 겹쳐 그리고, 주석 숨김 으로 끕니다. |
| 포인트클라우드(PLY) | 3D 뷰어. 서버가 점 수를 줄여 만든 미리보기를 라벨 색으로 보여 줍니다. |
| 시계열 | 시간축 기준으로 숫자 컬럼(최대 6개)을 선 그래프로. |
| 표 형식 | 앞부분 행을 표로. |
| JSON 어노테이션 | 들여쓰기한 JSON(2MB 이하). |
| 그 밖·오류 파일 | "미리보기 없음" 과 검증 오류 문구. |
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 이동·동작 | 이전·다음 파일(순번/전체), 다운로드, 삭제. |
| ② | 주석 전환 | 겹쳐 그린 어노테이션을 숨기거나 다시 보입니다. 괄호 안은 도형 수. |
| ③ | 메타데이터 | 종류·크기·Content-Type·요약·SHA-256·업로드 시각, 라벨 짝 정보와 매칭 다시 계산. |
PLY 3D 뷰어:
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 3D 캔버스 | 드래그로 회전, 휠로 확대·축소, 오른쪽 버튼 드래그로 이동. 위는 라벨별 색과 점 수 범례입니다. |
| ② | 조작법 | 뷰어는 점 수를 줄인(다운샘플) 미리보기이고 라벨 색은 고정입니다. 원본은 다운로드 로 받습니다. |
시계열 CSV:
상태·배지
데이터셋 검증 배지:
| 배지 | 값 | 뜻 |
|---|---|---|
| 통과 | PASS | 모든 파일이 검증을 통과함 |
| 일부 오류 | PARTIAL | 오류 파일이 하나 이상. 마우스를 올리면 개수가 보입니다 |
| 실패 | FAIL | 외부 시스템이 매니페스트로 실패 판정을 넘겨준 경우에만 나옵니다 |
| 파일 없음 | 없음 | 아직 파일이 없음 |
파일 상태:
| 배지 | 값 | 뜻 |
|---|---|---|
| 업로드됨 | UPLOADED | 저장은 됐고 검증 대기 |
| 검증 중 | VALIDATING | 서버가 검사 중(목록이 자동으로 새로 고쳐짐) |
| 유효 | VALID | 통과. 학습과 미리보기에 쓰임 |
| 오류 | INVALID | 검증 실패. 테이블 보기에 오류 문구가 빨갛게 나옴 |
외부 동기화 상태는 대기 · 동기화 중 · 완료 · 실패 · 취소됨 입니다.