selectStrongest

Select points with strongest metrics

Syntax

strongestPoints = selectStrongest(pointsIn,N)

[strongestPoints,indices] = selectStrongest(pointsIn,N)

Description

strongestPoints = selectStrongest(pointsIn,N) returns N number of points that have the strongest metrics.

[strongestPoints,indices] = selectStrongest(pointsIn,N) returns N number of points that have the strongest metrics.

Examples

Select Strongest KAZE Features

Create a KAZEPoints object holding 50 points.

points = KAZEPoints(ones(50,2),Metric=1:50);

Keep the two strongest features.

points = selectStrongest(points,2)   

points = 
  2×1 KAZEPoints array with properties:

       Location: [2×2 single]
         Metric: [2×1 single]
          Count: 2
          Scale: [2×1 single]
    Orientation: [2×1 single]

Input Arguments

pointsIn — Points object

M-by-2 matrix | point feature object

Points object,specified as an M-by-2 matrix of M number of [x y] coordinates, or as one of the point feature objects described in Point Feature Types. The object contains information about the feature points detected in the input image. To obtain points, use the appropriate detect function that pairs with the point feature type.

N — Number of points

integer

Number of strongest points to select, specified as an integer.

Output Arguments

strongestPoints — Points object with strongest metrics

M-by-2 matrix | points object

Points object with strongest metrics, returned as an M-by-2 matrix or a points object.

indices — Indices of selected points

N-element vector

Indices of selected points from the input, returned as an N-element vector of linear indices into pointsIn.

Version History

Introduced in R2017b

R2026a: Function returns indices of selected points

The function can return the indices of selected points from the input.