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 indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) | |
ipBoundingBoxes |
|
Container of bounding boxes to apply the non maximum supresion (ContainerType_Vector_TcVnRectangle_DINT) | |
ipScores |
|
Container of coreeponding score for each bounding box (ContainerType_Vector_REAL) | |
ipDestIndcies |
|
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 |
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 |
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 |