참조 경로 시각화
이미지에 참조 경로를 그립니다.
이미지 위에 정적 참조 경로를 그려 예상되거나 이상적인 경로를 시각화하고, 미리 정의된 폴리라인 경로를 표시하여 실제 객체 궤적과 비교해 경로 편차 분석 및 경로 준수 모니터링에 사용할 수 있습니다.
이 블록의 작동 방식
이 블록은 이미지와 참조 경로 좌표(경로를 정의하는 점 목록)를 받아 예상 경로 또는 이상적인 궤적을 나타내는 정적 폴리라인 경로를 그립니다. 이 블록은:
입력으로 이미지와 참조 경로 좌표(점 목록: [(x1, y1), (x2, y2), (x3, y3), ...])를 받습니다
좌표 목록을 점들을 순서대로 연결하는 폴리라인 경로로 변환합니다
지정된 색상과 두께를 사용해 참조 경로를 폴리라인으로 그립니다
원본 이미지 위에 참조 경로가 오버레이된 주석 이미지를 반환합니다
이 블록은 객체가 이상적으로 이동해야 하는 위치 또는 따라야 하는 경로를 나타내는 정적이고 미리 정의된 참조 경로를 시각화합니다. 실제 추적된 객체 이동을 기반으로 동적 경로를 그리는 트레이스 시각화(Trace Visualization)와 달리, 참조 경로 시각화(Reference Path Visualization)는 일정하게 유지되는 고정 경로를 그립니다. 이 참조 경로는 비교 기준선 역할을 하며, 예상 경로를 실제 객체 궤적과 함께 시각화할 수 있게 해줍니다. 경로는 지정된 모든 점을 연결하는 연속 선으로 그려져 경로 준수, 경로 편차 분석 또는 내비게이션 워크플로를 위한 시각적 가이드를 만듭니다. 이 블록은 일반적으로 경로 편차 분석 블록과 함께 사용되어 실제 객체 궤적과 비교할 참조 경로를 시각적으로 표시합니다.
일반적인 사용 사례
경로 편차 시각화 : 예상 경로를 실제 객체 궤적과 함께 시각화하여 경로 편차 감지, 경로 준수 모니터링 또는 내비게이션 검증 워크플로에서 예상 경로와 실제 이동을 비교합니다
경로 계획 및 내비게이션 : 경로 계획, 내비게이션 시스템 또는 웨이포인트 시각화 애플리케이션에서 객체가 따라야 하는 미리 정의된 경로, 내비게이션 경로 또는 예상 이동 경로를 표시합니다
준수 및 안전 모니터링 : 차량이 지정 차선을 따라야 하거나 로봇이 예상 경로를 따라야 하는 경우 등, 안전 모니터링, 준수 워크플로 또는 경로 검증에서 예상 경로를 시각화합니다
산업 및 물류 애플리케이션 : 공정 제어 또는 품질 보증을 위해 객체가 미리 정의된 경로를 따라야 하는 컨베이어 시스템, 자동 유도 차량(AGV) 또는 제조 워크플로의 참조 경로를 표시합니다
보안 및 접근 제어 : 예상 경로에서의 이탈을 식별해야 하는 보안 모니터링, 접근 제어 또는 감시 워크플로를 위해 예상 이동 경로를 시각화합니다
교육 및 문서화 : 교육 자료, 문서 또는 데모에서 참조 경로를 표시하여 교육 또는 참조 목적의 기대 객체 동작, 경로 또는 이동 패턴을 보여줍니다
다른 블록에 연결하기
이 블록의 주석이 추가된 이미지는 다음과 연결할 수 있습니다:
경로 편차 분석 블록 편차 분석을 위해 시각화된 참조 경로와 추적된 객체 궤적을 비교합니다
기타 시각화 블록 (예: 트레이스 시각화, 바운딩 박스 시각화, 라벨 시각화) 참조 경로 시각화와 실제 객체 추적 시각화를 결합하여 포괄적인 경로 비교를 수행합니다
추적 블록 (예: Byte Tracker) 참조 경로가 실제 추적된 객체 궤적을 비교하기 위한 시각적 기준선 역할을 할 수 있습니다
데이터 저장 블록 (예: Local File Sink, CSV Formatter, Roboflow Dataset Upload) 문서화, 보고 또는 분석을 위해 참조 경로가 포함된 이미지를 저장합니다
웹훅 블록 대시보드나 모니터링 도구에서 표시하기 위해 참조 경로가 포함된 시각화 결과를 외부 시스템, API 또는 웹 애플리케이션으로 전송합니다
알림 블록 (예: Email Notification, Slack Notification) 경고나 보고서에서 시각적 증거로 참조 경로가 포함된 주석 이미지를 전송합니다
비디오 출력 블록 실시간 모니터링, 경로 시각화 또는 후처리 분석을 위해 참조 경로가 포함된 주석 동영상 스트림 또는 녹화를 생성합니다
유형 식별자
단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/reference_path_visualization@v1 워크플로우에 이 블록을 단계로 추가하려면.
속성
이름
유형
설명
참조
name
str
이 단계에 대한 고유 식별자를 입력하세요..
❌
copy_image
bool
이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요..
✅
참조 경로
List[Any]
예상되거나 이상적인 경로를 정의하는 [(x1, y1), (x2, y2), (x3, y3), ...] 형식의 참조 경로 좌표입니다. 경로는 이 점들을 순서대로 연결하는 폴리라인으로 그려져 참조 궤적을 나타내는 연속 선을 만듭니다. 일반적으로 경로 편차 분석 블록에서 연결되거나 예상 경로로 수동 정의됩니다. 유효한 경로를 형성하려면 최소 두 개의 점이 있어야 합니다..
✅
color
str
참조 경로의 색상입니다. 색상 이름(예: 'WHITE', 'GREEN', 'BLUE'), 16진수 색상 코드(예: '#5bb573', '#FFFFFF') 또는 RGB 형식(예: 'rgb(91, 181, 115)')으로 지정할 수 있습니다. 참조 경로는 지정된 두께로 이 색상으로 그려집니다..
✅
두께
정수
참조 경로 선의 두께를 픽셀 단위로 나타냅니다. 참조 경로가 얼마나 두껍게 표시될지 제어합니다. 값이 클수록 더 두껍고 눈에 잘 띄는 경로가 만들어지고, 값이 낮을수록 더 얇고 눈에 덜 띄는 경로가 만들어집니다. 0 이상이어야 합니다. 일반적인 값은 1~5픽셀 범위입니다..
✅
이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.
입력 및 출력 바인딩
사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 참조 경로 시각화 버전 v1 을 가지고 있는지.
입력 및 출력 바인딩
입력
이미지(이미지): 시각화할 이미지..copy_image(boolean): 이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요..참조 경로(list_of_values): 예상되거나 이상적인 경로를 정의하는 [(x1, y1), (x2, y2), (x3, y3), ...] 형식의 참조 경로 좌표입니다. 경로는 이 점들을 순서대로 연결하는 폴리라인으로 그려져 참조 궤적을 나타내는 연속 선을 만듭니다. 일반적으로 경로 편차 분석 블록에서 연결되거나 예상 경로로 수동 정의됩니다. 유효한 경로를 형성하려면 최소 두 개의 점이 있어야 합니다..color(string): 참조 경로의 색상입니다. 색상 이름(예: 'WHITE', 'GREEN', 'BLUE'), 16진수 색상 코드(예: '#5bb573', '#FFFFFF') 또는 RGB 형식(예: 'rgb(91, 181, 115)')으로 지정할 수 있습니다. 참조 경로는 지정된 두께로 이 색상으로 그려집니다..두께(정수): 참조 경로 선의 두께를 픽셀 단위로 나타냅니다. 참조 경로가 얼마나 두껍게 표시될지 제어합니다. 값이 클수록 더 두껍고 눈에 잘 띄는 경로가 만들어지고, 값이 낮을수록 더 얇고 눈에 덜 띄는 경로가 만들어집니다. 0 이상이어야 합니다. 일반적인 값은 1~5픽셀 범위입니다..
출력
이미지(이미지): 워크플로의 이미지입니다.
마지막 업데이트
도움이 되었나요?