F_VN_NonMaxSuppressionExp

F_VN_NonMaxSuppressionExp 1:

Perform non-maximum suppression on given bounding boxes and corresponding scores. (expert function)

Syntax

Definition:

FUNCTION F_VN_NonMaxSuppressionExp : HRESULT
VAR_INPUT
    ipBoundingBoxes   : ITcVnContainer;
    ipScores          : ITcVnContainer;
    ipDestIndcies     : Reference To ITcVnContainer;
    fScoreThreshold   : REAL;
    fOverlapThreshold : REAL;
    ipClassIndcies    : ITcVnContainer;
    fEta              : REAL;
    nTopK             : DINT;
    hrPrev            : HRESULT;
END_VAR

 Inputs

Name

Type

Description

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

Reference To ITcVnContainer

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

fScoreThreshold

REAL

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

fOverlapThreshold

REAL

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

Container of corresponding set of class indcies (ContainerType_Vector_DINT)

fEta

REAL

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

DINT

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

hrPrev

HRESULT

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

 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