class kptmatch – Keypoint-Match-Objekt

Das kptmatch-Objekt ist ein attrtuple, das von image.match_descriptor() beim Abgleich zweier ORB-Schlüsselpunkt-Deskriptoren zurückgegeben wird. Es beschreibt das Cluster der übereinstimmenden Schlüsselpunkte zwischen den beiden Deskriptoren: dessen Begrenzungsrahmen, Schwerpunkt, die Anzahl der übereinstimmenden Schlüsselpunkte, eine geschätzte Rotation in der Bildebene und die Liste der Übereinstimmungen pro Schlüsselpunkt als (x, y).

Auf die Felder kann über den Attributnamen (match.count) oder über den Index (match[0]) zugegriffen werden. Das Objekt hat keinen öffentlichen Konstruktor.

class image.kptmatch

Bitte rufen Sie image.match_descriptor() auf, um dieses Objekt zu erstellen.

Begrenzungsrahmen und Schwerpunkt

x

x-Koordinate der oberen linken Ecke des Begrenzungsrahmens der übereinstimmenden Schlüsselpunkte, in Pixeln. Ganzzahl. Index [0].

y

y-Koordinate der oberen linken Ecke des Begrenzungsrahmens der übereinstimmenden Schlüsselpunkte, in Pixeln. Ganzzahl. Index [1].

w

Breite des Begrenzungsrahmens der übereinstimmenden Schlüsselpunkte, in Pixeln. Ganzzahl. Index [2].

h

Höhe des Begrenzungsrahmens der übereinstimmenden Schlüsselpunkte, in Pixeln. Ganzzahl. Index [3].

cx

x-Koordinate des Schwerpunkts der übereinstimmenden Schlüsselpunkte. Ganzzahl. Index [4].

cy

y-Koordinate des Schwerpunkts der übereinstimmenden Schlüsselpunkte. Ganzzahl. Index [5].

rect

4-Tupel (x, y, w, h) des Begrenzungsrahmens. Geeignet zur direkten Übergabe an Methoden zum Zeichnen/Zuschneiden wie Image.draw_rectangle() oder Image.crop(). Index [9].

Match-Details

count

Anzahl der Schlüsselpunkte, die zwischen den beiden Deskriptoren übereinstimmten. Verwenden Sie diesen Wert als Konfidenzwert – typische Schwellenwerte für eine „echte“ Übereinstimmung liegen bei 10+ Schlüsselpunkten. Ganzzahl. Index [6].

theta

Geschätzte Rotation in der Bildebene zwischen den beiden Deskriptoren, in Grad. Ganzzahl. Index [7].

match

Liste von Ganzzahl-Tupeln (x, y), die die Pixelposition jedes übereinstimmenden Schlüsselpunkts im Suchbild angeben. len(match) == count. Index [8].