Match

R2026b

Shape matching result

Since R2026b

Description

A Match object contains the result of a shape matching operation. The object stores the position, rotation, scale, and similarity score of each detected instance of a shape model in a search image. To visualize the shape model matches, use the showmatches function.

Creation

Create a Match object by using the matchshape object function of the shapemodel object, which detects instances of a shape model in a search image and returns a Match object for each detected instance.

Properties

Score — Match score

scalar in the range [0, 1]

Match score that indicates how well the detected instance matches the shape model, returned as a scalar in the range [0, 1]. Higher values indicate a better match.

ClassName — Class label of matching shape model

string scalar

Class label of the shape model that produced the match, returned as a string scalar.

ModelIndex — Model index

positive integer

Index of the shape model that produced the match, returned as a positive integer.

ModelOriginTransformation — Geometric transformation of coordinate system

simtform2d object

Geometric transformation that maps points from the shape model coordinate system into the search image coordinate system, returned as a simtform2d object.

RotatedBoundingBox — Rotated bounding box of shape model instance

numeric vector

Rotated bounding box that encloses the detected shape model instance, returned as a five‑element numeric vector of the form [xc yc width height theta].

(xc, yc) is the center of the bounding box in image coordinates. width and height are the box size, and theta is the rotation angle.

Version History

Introduced in R2026b