class kptmatch – 키포인트 매치 객체

kptmatch 객체는 두 ORB 키포인트 디스크립터를 매칭할 때 image.match_descriptor()가 반환하는 attrtuple 입니다. 이 객체는 두 디스크립터 사이에서 매칭된 키포인트의 클러스터, 즉 경계 상자, 중심점, 매칭된 키포인트의 개수, 추정된 이미지 평면 내 회전, 그리고 키포인트별 (x, y) 매치 리스트를 기술합니다.

필드는 속성 이름(match.count)이나 인덱스(match[0])로 접근할 수 있습니다. 이 객체에는 공개 생성자가 없습니다.

class image.kptmatch

이 객체를 생성하려면 image.match_descriptor()를 호출하세요.

경계 상자와 중심점

x

매칭된 키포인트의 경계 상자 좌측 상단 x 좌표이며, 단위는 픽셀입니다. 정수. 인덱스 [0].

y

매칭된 키포인트의 경계 상자 좌측 상단 y 좌표이며, 단위는 픽셀입니다. 정수. 인덱스 [1].

w

매칭된 키포인트의 경계 상자 너비이며, 단위는 픽셀입니다. 정수. 인덱스 [2].

h

매칭된 키포인트의 경계 상자 높이이며, 단위는 픽셀입니다. 정수. 인덱스 [3].

cx

매칭된 키포인트의 중심점 x 좌표입니다. 정수. 인덱스 [4].

cy

매칭된 키포인트의 중심점 y 좌표입니다. 정수. 인덱스 [5].

rect

경계 상자의 (x, y, w, h) 4-튜플입니다. Image.draw_rectangle()나 Image.crop()과 같은 그리기/자르기 메서드에 직접 전달하기에 적합합니다. 인덱스 [9].

매치 세부 정보

count

두 디스크립터 사이에서 매칭된 키포인트의 개수입니다. 이 값을 신뢰도 점수로 사용하세요. “실제” 매치의 일반적인 임계값은 키포인트 10개 이상입니다. 정수. 인덱스 [6].

theta

두 디스크립터 사이의 추정된 이미지 평면 내 회전이며, 단위는 도(degree)입니다. 정수. 인덱스 [7].

match

검색 이미지에서 매칭된 각 키포인트의 픽셀 위치를 제공하는 (x, y) 정수 튜플의 리스트입니다. len(match) == count. 인덱스 [8].