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

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.59 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision