NonMaxSuppression

Perform non-maximum suppression on given bounding boxes and corresponding scores.

Syntax

Definition:

HRESULT NonMaxSuppression(
    HRESULT          hrPrev,
    ITcVnContainer*  ipBoundingBoxes,
    ITcVnContainer*  ipScores,
    ITcVnContainer*& ipDestIndcies,
    float            fScoreThreshold,
    float            fOverlapThreshold,
    ITcVnContainer*  ipClassIndcies = nullptr,
    float            fEta = 1.0f,
    LONG             nTopK = 0
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

ipBoundingBoxes

ITcVnContainer*

Container of bounding boxes to apply the non maximum supresion (ContainerType_Vector_TcVnRectangle_DINT)

ipScores

ITcVnContainer*

Container of coreeponding score for each bounding box (ContainerType_Vector_REAL)

ipDestIndcies

ITcVnContainer*&

Container of the kept indcies after apply the non maximum suppression (ContainerType_Vector_DINT)

fScoreThreshold

float

A threshold [0.0 to 1.0] used to filter the bounding boxes by score

fOverlapThreshold

float

A threshold [0.0 to 1.0] that determines the minimum degree of intersection over union (IoU) required for bounding boxes to be considered overlapping

ipClassIndcies

ITcVnContainer*

nullptr

Container of corresponding set of class indcies (ContainerType_Vector_DINT)

fEta

float

1.0f

An adjustable threshold [0.0 to 1.0] used to dynamically reduce the overlap threshold during processing. Setting it to 1 maintains a constant value for the overlap threshold

nTopK

LONG

0

The maximum number of bounding boxes with the highest scores to undergo the suppression algorithm (must be >= 0). Setting it to zero applies the algorithm to all bounding boxes

 Return value

HRESULT

Required License

TC3 Vision Base

System Requirements