키포인트 시각화
이미지의 탐지된 객체에 키포인트를 그립니다.
포인트 마커를 그리거나, 엣지를 연결하거나, 레이블이 있는 정점을 표시하여 객체에서 검출된 키포인트(랜드마크 포인트)를 시각화하며, 해부학적 포인트, 구조적 랜드마크 또는 객체의 주요 특징에 대한 포즈 추정 시각화를 제공합니다.
이 블록의 작동 방식
이 블록은 이미지와 키포인트 탐지 예측을 받아 세 가지 시각화 모드 중 하나를 사용해 검출된 키포인트를 시각화합니다. 이 블록은:
이미지와 키포인트 탐지 예측을 입력으로 받습니다(예측에는 키포인트 좌표, 신뢰도 점수, 클래스 이름이 포함되어야 합니다)
예측에서 키포인트 데이터(좌표, 신뢰도 값, 클래스 이름)를 추출합니다
탐지 데이터를 시각화에 적합한 KeyPoints 형식으로 변환합니다
annotator_type 설정에 따라 세 가지 시각화 모드 중 하나를 적용합니다:
엣지 모드: 지정된 엣지 쌍을 사용해 키포인트 사이에 연결선(엣지)을 그려 키포인트 간의 관계를 표시합니다(예: 포즈 추정에서의 스켈레톤 연결)
정점 모드: 연결 없이 각 키포인트 위치에 원형 마커를 그려 개별 키포인트 위치를 표시합니다
정점 레이블 모드: 각 키포인트 클래스 이름을 식별하는 텍스트 레이블이 있는 원형 마커를 그려 레이블이 표시된 키포인트 시각화를 제공합니다
선택한 매개변수에 따라 색상 스타일, 크기 조정, 선택적 텍스트 레이블을 적용합니다
선택한 모드에 따라 키포인트가 시각화된 주석 이미지가 반환됩니다
이 블록은 다양한 사용 사례에 맞춰 세 가지 시각화 스타일을 지원합니다. 엣지 모드는 관련된 키포인트를 선으로 연결하며(포즈 추정 스켈레톤이나 구조적 관계에 유용함), 정점 모드는 개별 키포인트 위치를 원형 마커로 표시하고, 정점 레이블 모드는 각 키포인트 유형을 식별하는 텍스트 레이블을 추가합니다. 이 시각화는 포즈 추정 워크플로, 해부학적 포인트 검출 또는 객체의 특정 랜드마크 포인트를 식별하고 시각화해야 하는 모든 애플리케이션에 필수적입니다.
일반적인 사용 사례
인체 포즈 추정: 해부학적 포인트를 스켈레톤 연결 또는 레이블이 있는 마커로 표시해야 하는 포즈 추정, 활동 인식 또는 동작 분석 애플리케이션을 위해 인체 키포인트(관절, 신체 부위)를 시각화합니다
동물 포즈 추정: 행동 분석, 수의학 애플리케이션 또는 야생동물 모니터링을 위해 동물 키포인트를 표시하며, 포즈 분석이나 움직임 추적을 위해 해부학적 랜드마크를 시각화해야 하는 경우에 사용합니다
구조적 랜드마크 검출: 구조 분석, 품질 관리 또는 측정 워크플로를 위해 객체, 구조물 또는 기계의 키포인트를 시각화하며, 특정 랜드마크 포인트를 식별하고 표시해야 하는 경우에 사용합니다
얼굴 랜드마크 검출: 얼굴 인식, 표정 분석 또는 얼굴 정렬 애플리케이션을 위해 얼굴 키포인트(눈꼬리, 코끝, 입꼬리 등)를 표시하며, 얼굴 특징을 시각화해야 하는 경우에 사용합니다
스포츠 및 동작 분석: 스포츠 분석, 생체역학 또는 동작 연구를 위해 키포인트를 시각화하며, 신체 위치, 관절 각도 또는 동작 패턴을 분석하고 표시해야 하는 경우에 사용합니다
품질 관리 및 검사: 제조, 품질 보증 또는 검사 워크플로를 위해 키포인트를 표시하며, 제품이나 구성 요소의 특정 지점을 식별, 측정 또는 검증해야 하는 경우에 사용합니다
다른 블록에 연결하기
이 블록의 주석이 추가된 이미지는 다음과 연결할 수 있습니다:
키포인트 탐지 모델 블록 점 마커, 엣지 또는 레이블이 있는 정점으로 시각화된 키포인트 예측을 받기 위해
기타 시각화 블록 (예: 경계 상자 시각화, 레이블 시각화, 폴리곤 시각화) 키포인트 시각화와 추가 주석을 결합하여 포괄적인 포즈 또는 구조 시각화를 구현하기 위해
데이터 저장 블록 (예: 로컬 파일 싱크, CSV 포맷터, Roboflow 데이터셋 업로드) 키포인트 시각화가 포함된 이미지를 저장하여 문서화, 보고 또는 분석에 사용하기 위해
웹훅 블록 키포인트가 포함된 시각화 결과를 외부 시스템, API 또는 웹 애플리케이션으로 보내 대시보드, 포즈 분석 도구 또는 모니터링 인터페이스에 표시하기 위해
알림 블록 (예: 이메일 알림, Slack 알림) 경고나 보고서에서 시각적 증거로 사용할 키포인트가 포함된 주석 이미지를 보내기 위해
비디오 출력 블록 라이브 포즈 추정, 동작 분석 또는 후처리 워크플로를 위해 키포인트 시각화가 포함된 비디오 스트림이나 녹화를 생성하기 위해
유형 식별자
단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/keypoint_visualization@v1 워크플로우에 이 블록을 단계로 추가하려면.
속성
이름
유형
설명
참조
name
str
이 단계에 대한 고유 식별자를 입력하세요..
❌
copy_image
bool
이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요..
✅
annotator_type
str
키포인트 시각화 모드의 유형입니다. 옵션: 'edge'(엣지 쌍을 사용해 키포인트 사이에 연결선을 그려 스켈레톤/포즈 시각화에 유용함), 'vertex'(연결 없이 키포인트 위치에 원형 마커를 그림), 'vertex_label'(각 키포인트 클래스 이름을 식별하는 텍스트 레이블이 있는 원형 마커를 그림)..
❌
color
str
키포인트 마커, 엣지 또는 레이블의 색상입니다. 색상 이름(예: 'green', 'red', 'blue'), 16진수 색상 코드(예: '#A351FB', '#FF0000') 또는 RGB 형식으로 지정할 수 있습니다. 키포인트 원(vertex/vertex_label 모드) 또는 엣지 선(edge 모드)에 사용됩니다..
✅
text_color
str
키포인트에 표시되는 텍스트 레이블의 색상입니다(vertex_label 모드만 해당). 색상 이름(예: 'black', 'white'), 16진수 색상 코드 또는 RGB 형식으로 지정할 수 있습니다. annotator_type이 'vertex_label'일 때만 적용됩니다..
✅
text_scale
float
키포인트 레이블 텍스트 크기의 배율입니다(vertex_label 모드만 해당). 키포인트에 표시되는 텍스트 레이블의 크기를 제어합니다. 1.0보다 큰 값은 텍스트를 더 크게 만들고, 1.0보다 작은 값은 더 작게 만듭니다. annotator_type이 'vertex_label'일 때만 적용됩니다. 일반적인 값 범위는 0.3~1.0입니다..
✅
text_thickness
정수
키포인트 레이블 텍스트 문자의 두께를 픽셀 단위로 설정합니다(vertex_label 모드만 해당). 텍스트 레이블이 얼마나 굵게 보일지 제어합니다. 값이 클수록 더 두껍고 굵은 텍스트가 됩니다. annotator_type이 'vertex_label'일 때만 적용됩니다. 일반적인 값 범위는 1~3입니다..
✅
text_padding
정수
키포인트 레이블 텍스트 주변의 패딩을 픽셀 단위로 설정합니다(vertex_label 모드만 해당). 텍스트 레이블과 배경 테두리 사이의 간격을 제어합니다. 값이 클수록 텍스트 주변 공간이 더 넓어집니다. annotator_type이 'vertex_label'일 때만 적용됩니다. 일반적인 값 범위는 5~20픽셀입니다..
✅
두께
정수
키포인트를 연결하는 엣지 선의 두께를 픽셀 단위로 설정합니다(edge 모드만 해당). 키포인트 사이의 연결선이 얼마나 두껍게 보일지 제어합니다. 값이 클수록 더 두껍고 눈에 잘 띄는 엣지가 됩니다. annotator_type이 'edge'일 때만 적용됩니다. 일반적인 값 범위는 1~5픽셀입니다..
✅
반경
정수
원형 키포인트 마커의 반지름을 픽셀 단위로 설정합니다(vertex 및 vertex_label 모드만 해당). 키포인트 위치에 그려지는 원형 마커의 크기를 제어합니다. 값이 클수록 더 크고 눈에 잘 띄는 마커가 됩니다. annotator_type이 'vertex' 또는 'vertex_label'일 때만 적용됩니다. 일반적인 값 범위는 5~20픽셀입니다..
✅
edges
List[Any]
키포인트 간의 엣지 연결(edge 모드만 해당). 선으로 연결할 키포인트를 정의하는 키포인트 인덱스 쌍 목록(예: [(0, 1), (1, 2), ...])입니다. 포즈 추정의 경우 일반적으로 스켈레톤 연결(예: 관절 연결)을 나타냅니다. annotator_type이 'edge'일 때만 적용됩니다. 엣지 시각화에 필요합니다..
✅
이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.
입력 및 출력 바인딩
사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 키포인트 시각화 버전 v1 을 가지고 있는지.
입력 및 출력 바인딩
입력
이미지(이미지): 시각화할 이미지..copy_image(boolean): 이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요..예측(keypoint_detection_prediction): 키포인트 좌표, 신뢰도 점수, 클래스 이름을 포함하는 키포인트 탐지 예측값입니다. 예측에는 keypoints_xy(키포인트 좌표), keypoints_confidence(신뢰도 값), keypoints_class_name(키포인트 클래스/유형 이름)이 포함되어야 합니다. 키포인트 탐지 모델 블록의 출력이 필요합니다..color(string키포인트 마커, 엣지 또는 레이블의 색상입니다. 색상 이름(예: 'green', 'red', 'blue'), 16진수 색상 코드(예: '#A351FB', '#FF0000') 또는 RGB 형식으로 지정할 수 있습니다. 키포인트 원(vertex/vertex_label 모드) 또는 엣지 선(edge 모드)에 사용됩니다..text_color(string키포인트에 표시되는 텍스트 레이블의 색상입니다(vertex_label 모드만 해당). 색상 이름(예: 'black', 'white'), 16진수 색상 코드 또는 RGB 형식으로 지정할 수 있습니다. annotator_type이 'vertex_label'일 때만 적용됩니다..text_scale(float키포인트 레이블 텍스트 크기의 배율입니다(vertex_label 모드만 해당). 키포인트에 표시되는 텍스트 레이블의 크기를 제어합니다. 1.0보다 큰 값은 텍스트를 더 크게 만들고, 1.0보다 작은 값은 더 작게 만듭니다. annotator_type이 'vertex_label'일 때만 적용됩니다. 일반적인 값 범위는 0.3~1.0입니다..text_thickness(정수키포인트 레이블 텍스트 문자의 두께를 픽셀 단위로 설정합니다(vertex_label 모드만 해당). 텍스트 레이블이 얼마나 굵게 보일지 제어합니다. 값이 클수록 더 두껍고 굵은 텍스트가 됩니다. annotator_type이 'vertex_label'일 때만 적용됩니다. 일반적인 값 범위는 1~3입니다..text_padding(정수키포인트 레이블 텍스트 주변의 패딩을 픽셀 단위로 설정합니다(vertex_label 모드만 해당). 텍스트 레이블과 배경 테두리 사이의 간격을 제어합니다. 값이 클수록 텍스트 주변 공간이 더 넓어집니다. annotator_type이 'vertex_label'일 때만 적용됩니다. 일반적인 값 범위는 5~20픽셀입니다..두께(정수키포인트를 연결하는 엣지 선의 두께를 픽셀 단위로 설정합니다(edge 모드만 해당). 키포인트 사이의 연결선이 얼마나 두껍게 보일지 제어합니다. 값이 클수록 더 두껍고 눈에 잘 띄는 엣지가 됩니다. annotator_type이 'edge'일 때만 적용됩니다. 일반적인 값 범위는 1~5픽셀입니다..반경(정수원형 키포인트 마커의 반지름을 픽셀 단위로 설정합니다(vertex 및 vertex_label 모드만 해당). 키포인트 위치에 그려지는 원형 마커의 크기를 제어합니다. 값이 클수록 더 크고 눈에 잘 띄는 마커가 됩니다. annotator_type이 'vertex' 또는 'vertex_label'일 때만 적용됩니다. 일반적인 값 범위는 5~20픽셀입니다..edges(list_of_values키포인트 간의 엣지 연결(edge 모드만 해당). 선으로 연결할 키포인트를 정의하는 키포인트 인덱스 쌍 목록(예: [(0, 1), (1, 2), ...])입니다. 포즈 추정의 경우 일반적으로 스켈레톤 연결(예: 관절 연결)을 나타냅니다. annotator_type이 'edge'일 때만 적용됩니다. 엣지 시각화에 필요합니다..
출력
이미지(이미지): 워크플로의 이미지입니다.
마지막 업데이트
도움이 되었나요?