콘텐츠로 바로 가기
STAGING SERVER
DEVELOPMENT SERVER

Object Detection vTool#

Object Detection vTool은 사용자가 선택한 모델을 기반으로 이미지 내의 객체를 감지하고 분류합니다.

Object Detection vTool은 Image 입력 핀을 통해 수신된 이미지의 물체를 분류할 수 있습니다. 이 도구는 InferenceImage, BBoxes_px, Classes 및 Scores 출력 핀을 통해 결과를 출력합니다. 감지된 각 물체 주위에는 바운딩 박스가 그려집니다.

탐지 전에 ‘ ROI Creator vTool ’를 사용하여 관심 영역(ROI)을 지정하면, ‘ Object Detection ’ vTool은 Roi 입력 핀을 통해 ROI 데이터를 수신합니다. 이 경우, 탐지는 관심 영역에서만 수행됩니다. 부수적인 효과로, 이로 인해 처리 속도가 빨라집니다.

Object Detection vTool 라이선스를 구매하려면 Basler 웹사이트를 방문하십시오.

Object Detection vTool

작동 방식#

이미지 속의 사람이나 장면 속의 다른 요소와 같은 특정 물체를 탐지하고 식별하고자 한다고 가정해 봅시다.

다음은 스키 장비를 착용한 여섯 명의 어린이가 등장하는 입력 이미지입니다:

스키를 탄 여섯 명의 아이들이 등장하는 입력 이미지

vTool은 사람과 스키 장비 등 다양한 물체를 감지하도록 훈련된 모델을 불러와 구성합니다.

Object Detection 용 번들 선택됨

다음으로, 감지하고 세분화할 클래스를 선택할 수 있습니다. 일부 모델은 사용 사례에 정확히 맞춰져 있을 수 있습니다. 이 경우 원하는 모든 클래스가 이미 선택되어 있습니다.

클래스 선택 대화상자

vTool을 구성한 후, 추론 프로세스를 시작하는 레시피를 실행합니다. vTool은 모델을 활용하여 이미지를 분석하고, 이미지에 포함된 물체를 식별 및 위치 파악합니다. 분석이 완료되면 분할 결과가 반환됩니다. 이 결과에는 이미지에서 감지된 각 개별 물체 인스턴스에 대한 바운딩 박스, 클래스 레이블 및 신뢰도 점수가 포함됩니다.

핀 데이터 뷰의 결과 이미지입니다:

Object Detection 결과가 강조 표시된

‘person’이라고 표시된 보라색 바운딩 박스 안에 6명의 사람이 탐지되었습니다. 마찬가지로, ‘skis’라고 표시된 바운딩 박스 안에는 5개의 스키가 탐지되었습니다.

상세 출력

  • Bounding Box: 바운딩 박스는 감지된 객체 주변에 그려진 직사각형입니다. 각 바운딩 박스에 대해 중심 픽셀, 너비, 높이 및 회전이 출력됩니다.
  • 클래스: 사람, 스키
    클래스 라벨을 보면, 모델이 바운딩 박스 내의 물체를 사람이나 스키로 식별했음을 알 수 있습니다.
  • 점수: 점수 값(예: 0.890817)은 모델이 탐지 결과에 대해 얼마나 확신하고 있는지를 나타내며, 이는 89.08%에 해당합니다. 1.0에 가까울수록 점수가 높을수록 확신 수준이 더 높음을 의미합니다.

vTool 구성#

Object Detection vTool을 구성하려면:

Object Detection vTool 설정

  1. vTool 설정 영역의 ‘레시피 관리 ’ 창에서 ‘설정 열기’를 클릭하거나 vTool을 두 번 클릭합니다.
    그러면 Object Detection 대화 상자가 열립니다.
  2. 다음 파라미터 블록에서 서버 선택 영역에서 연결할 서버를 선택합니다.
    연결하려면 서버가 실행 중이어야 합니다.
    • 옵션 1: Triton Inference Server의 IP 주소와 포트를 수동으로 입력합니다.
    • 옵션 2: 드롭다운 목록에서 서버의 IP 주소 / 호스트 이름과 포트를 선택합니다.
  3. Connect를 클릭하여 연결을 설정합니다.
    그러면 vTool이 사용 가능한 모델을 로드합니다.
  4. 다음 파라미터 블록에서 모델 선택 영역의 드롭다운 목록에서 원하는 모델이 포함된 번들을 선택합니다.
    번들을 선택하면 드롭다운 목록 아래에 번들 세부 정보가 채워지므로 올바른 번들을 선택했는지 확인할 수 있습니다.
    모델 선택 영역
  5. 원하는 번들이 목록에 없으면 다음을 클릭하세요. 새 모델 배포 드롭다운 목록에서
    이렇게 하면 다음이 열립니다. pylon AI Agent 더 많은 모델을 배포할 수 있습니다.
    새 모델 배포
    새 모델을 배포한 후 다음을 클릭해야 합니다. 새로 고침 버튼을 클릭합니다.
  6. Detection Settings 영역에서 Select Classes를 클릭하여 분류할 클래스를 선택합니다.
    사용 가능한 클래스가 포함된 대화상자가 열립니다. 기본적으로 모든 클래스가 선택되어 있습니다. 원하는 만큼 클래스를 선택할 수 있습니다.

    정보

    이 영역에서 사용할 수 있는 매개변수는 선택한 모델에 따라 다릅니다. 일부 매개변수(예: IOU 임계값)는 특정 모델을 선택한 후에만 사용할 수 있습니다. 기본값은 모델에서 제공됩니다.

  7. 검출 설정에서 다른 옵션을 지정합니다.

    1. Number of objects: 검출할 최대 객체 수를 지정하거나 Unlimited를 선택할 수 있습니다.
      이 제한은 각 클래스에 개별적으로 적용됩니다. 여기에 지정된 것보다 이미지에 더 많은 객체가 있는 경우 점수가 가장 높은 일치 항목이 검출됩니다.
    2. Maximum/Minimum height: 높이별로 바운딩 박스를 필터링하려는 경우 적절한 값을 지정합니다. 바운딩 박스의 높이는 객체의 높이에 해당하므로 이를 통해 원하는 크기의 객체만 검출할 수 있습니다.
    3. Maximum/Minimum width: 너비별로 바운딩 박스를 필터링하려는 경우 적절한 값을 지정합니다. 바운딩 박스의 높이는 객체의 너비에 해당하므로 이를 통해 원하는 크기의 객체만 검출할 수 있습니다.
    4. Confidence threshold: Confidence는 이미지의 객체가 선택한 클래스를 얼마나 잘 나타내는지 나타내는 신경망의 계수입니다. 값이 높을수록 신뢰도가 높고 오탐(false positive)이 줄어듭니다.
    5. 가장자리: 감지된 객체 주위의 바운딩 박스를 지정된 픽셀 수만큼 각 가장자리를 이동시켜 확장할 수 있습니다. 이렇게 하면 객체가 박스 내에 완전히 포함되도록 할 수 있습니다.
    6. IOU 임계값: 일부 바운딩 박스가 겹칠 수 있습니다. 이 매개변수를 통해 바운딩 박스를 병합할지 여부를 제어할 수 있습니다. 값이 낮을수록 허용 오차가 줄어들며, 대부분의 바운딩 박스가 병합됩니다.
  8. OK를 클릭합니다.

핀 데이터 뷰에서 물체 감지 결과를 확인할 수 있습니다. 여기에서 표시할 출력을 선택할 수 있습니다.

Inputs#

Image#

Camera vTool 또는 이미지를 출력하는 vTool(예: Image Format Converter vTool)로부터 직접 이미지를 수신합니다.

  • Data type: Image
  • 이미지 포맷: 8비트 ~ 16비트 컬러 이미지

Roi#

ROI Creator vTool 또는 직사각형을 출력하는 기타 vTool에서 관심 영역을 허용합니다. 여러 직사각형이 입력되는 경우 첫 번째 직사각형이 단일 관심 영역으로 사용됩니다.

  • 데이터 유형: RectangleF, RectangleF Array

Outputs#

Starter vTools에서 vTool을 사용하려면 출력 핀의 데이터 형식을 다중 값 데이터에서 단일 값 데이터로 전환할 수 있습니다. 이렇게 하려면 Features - All 창의 Data Type Selector 매개변수를 사용합니다.

InferenceImage#

결과를 시각화하기 위해 모든 입력 이미지에 대해 검출된 객체 주변에 바운딩 박스가 그려진 이미지를 반환합니다.

  • Data type: Image

BBoxes_px#

검출된 모든 객체에 대한 바운딩 박스를 반환합니다. 각 바운딩 박스는 중심 픽셀의 좌표, 너비 및 높이(x_center, y_center, width, height)로 정의됩니다. 바운딩 박스 출력은 다른 vTool의 Roi 입력 핀에 대한 입력으로 사용할 수 있습니다.

  • Data type: RectangleF Array

Classes#

검출된 객체의 클래스 레이블을 반환합니다.

  • 데이터 유형: String Array

점수#

감지된 각 객체에 대한 신뢰도 점수를 반환합니다.

  • 데이터 유형: Float Array

Payload#

평가를 위한 Inference Server의 성능과 관련된 추가 정보를 반환합니다. 이 출력 핀은 Debug Settings 매개변수 그룹의 Features - All 창에서 활성화한 경우에만 사용할 수 있습니다.

  • 데이터 형식: String

일반적인 선행 vTool#

일반적인 후행 vTool#