데이터셋 상태 점검
데이터셋의 품질을 평가하고 개선합니다.
소개
Dataset Health Check는 프로젝트와 연결된 데이터셋에 대한 다양한 통계를 보여줍니다. 다음 정보를 확인할 수 있습니다:
데이터셋의 이미지 수;
주석 수;
이미지 평균 크기;
이미지 비율의 중앙값;
누락된 주석 수;
null 주석 수;
데이터셋 전체의 이미지 차원;
객체 수 히스토그램, 그리고;
주석 위치의 히트맵입니다.
Dataset Health Check를 사용하면 데이터셋에 대한 다양한 인사이트를 얻을 수 있습니다. 예를 들어 null 주석이 없다면, 작업 중인 프로젝트에 따라 몇 개를 추가하는 것을 고려해 볼 수 있습니다. 누락된 주석이 있는 이미지가 있다면, 필요한 주석을 추가하기 위해 더 자세히 살펴볼 수 있습니다.
프로젝트의 Health Check를 보려면 Dataset 페이지를 열고 "Health Check" 탭을 클릭하세요:

그러면 Health Check 탭이 열립니다:

이 페이지에서 다음을 확인할 수 있습니다:
train, test, valid 데이터셋의 이미지에 있는 클래스 수에 대한 세부 내역.
데이터셋 이미지의 크기와 종횡비에 대한 개요.
주석이 가장 많이 있는 위치를 보여주는 히트맵.
데이터셋의 각 이미지에 주석이 달린 클래스 수를 보여주는 히스토그램.
웹 앱
차원 인사이트
Dimension Insights 섹션은 데이터셋의 원본 이미지 크기와 종횡비를 설명합니다.
프로젝트 버전을 생성할 때 Resize 증강을 적용하면 - 거의 모든 사용 사례에서 강력히 권장합니다 - 버전의 이미지는 크기가 조정되지만 원본 이미지는 그대로 유지됩니다.

주석 히트맵
모델을 학습할 때는 데이터셋이 모델이 배포될 환경을 대표해야 한다는 점이 중요합니다.
모델이 주석이 카메라 프레임의 어느 위치에나 나타날 수 있는 환경에 배포될 예정이라면 - 예를 들어 크기가 다른 객체가 실시간으로 움직이는 공장 라인이나, 휴대폰으로 찍은 객체 이미지처럼 - 이미지의 서로 다른 위치에 나타나는 객체를 주석 처리하는 것이 중요합니다.
이미지의 여러 부분에 있는 객체에 라벨을 지정하면, 모델이 특정 위치의 객체만 식별하도록 과적합되는 것을 방지할 수 있습니다.
Annotation Heat Map은 이미지에서 주석이 더 많거나 적은 위치를 보여줍니다. 이를 통해 데이터셋 주석이 특정 위치에 지나치게 집중된 경우를 식별할 수 있습니다.

히트맵의 영역을 드래그하면 선택한 범위의 이미지를 볼 수 있습니다:

이미지별 객체 수 히스토그램
이는 각 이미지에 주석이 달린 객체가 몇 개씩 있는지의 분포를 보여줍니다.
모델에 입력하는 이미지에 동일 객체의 여러 인스턴스가 포함될 수 있다면, 데이터셋에 서로 다른 수의 객체 인스턴스가 포함된 이미지를 넣는 것이 좋습니다. 이렇게 하면 관심 객체가 없거나 하나이거나 여러 개인 이미지에 대해서도 모델이 잘 일반화할 수 있도록 도움이 됩니다.
여기 히스토그램 예시가 있습니다:

히스토그램의 막대 중 하나를 선택하면 해당 개수의 이미지를 볼 수 있습니다:

HTTP API
API는 히트맵이나 이미지 차원 정보는 제외하고, Health Check 탭과 동일한 수치, 클래스 균형, 객체 수 히스토그램을 반환합니다. 프로젝트의 첫 번째 보고서 또는 regenerate=true와 함께 요청한 보고서는 요청 중에 계산되며, 대용량 데이터셋에서는 몇 분이 걸릴 수 있습니다. 이후 호출은 저장된 보고서를 반환하므로 최신 변경 사항보다 오래된 내용일 수 있습니다. 생성됨을 확인하고 생성됨을 전달하며 regenerate=true 현재 수치가 필요할 때 사용하세요.
Returns the Dataset Health Check report for a project: image and annotation counts, class balance overall and per split, and the object count histogram. Heatmaps and per-image data are left out. Requires project:read. Any API key can read the report of a public project.
Roboflow API key or OAuth access token.
Workspace URL slug.
Project URL slug.
Set to true to recompute the report. Otherwise you get the last computed report, and it is computed only when none exists.
Successful response.
When the report was computed, in milliseconds since the Unix epoch.
Report format version.
The request is invalid.
Authentication is missing or invalid.
The credential does not have access to this resource.
The resource does not exist or is not accessible.
The request rate is too high.
GET /{workspace}/{project}/health HTTP/1.1
Host: api.roboflow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"generated": 1793369145612,
"version": 3,
"stats": {
"images": 524,
"annotated": 524,
"unannotated": 0,
"empty": 0,
"labels": 4668,
"average": "8.9",
"singleClass": 0,
"multiClass": 0,
"numClasses": 2,
"classes": [
{
"count": 941,
"percent": "100.0",
"cls": "fair",
"description": "",
"name": "needle"
},
{
"count": 412,
"percent": "43.8",
"cls": "under",
"description": "Under Represented",
"name": "dial"
}
],
"classesBySplit": {
"train": [
{
"count": 820,
"percent": "100.0",
"cls": "fair",
"description": "",
"name": "needle"
},
{
"count": 360,
"percent": "43.9",
"cls": "under",
"description": "Under Represented",
"name": "dial"
}
],
"valid": [
{
"count": 121,
"percent": "100.0",
"cls": "fair",
"description": "",
"name": "needle"
},
{
"count": 52,
"percent": "43.0",
"cls": "under",
"description": "Under Represented",
"name": "dial"
}
],
"test": [
{
"count": 0,
"percent": "0.0",
"cls": "missing",
"description": "Missing",
"name": "needle"
},
{
"count": 0,
"percent": "0.0",
"cls": "missing",
"description": "Missing",
"name": "dial"
}
]
},
"histogram": {
"all": {
"1": 2,
"5": 229,
"10": 151
},
"needle": {
"1": 244,
"2": 188
},
"dial": {
"1": 239,
"2": 85
}
}
}
}MCP 서버
AI 에이전트를 다음에 연결하면 MCP 서버 그리고 다음 도구로 데이터셋 상태를 확인할 수 있습니다:
projects_health
프로젝트의 데이터셋 상태 점검을 가져옵니다.
마지막 업데이트
도움이 되었나요?