NVIDIA DriveOS Linux NSR SDK API Reference

7.0.3.0 Release
dwTemplateTrackerParameters Struct Reference

Detailed Description

Configuration parameters for a dwTemplateTrackerIA.

Definition at line 108 of file TemplateTracker.h.

Data Fields

dwTemplateTrackerAlgorithm algorithm
 Tracking Algorithm defined by dwTemplateTrackerAlgorithm. More...
 
uint32_t maxTemplateCount
 Upper bound on number of templates handled. More...
 
uint32_t maxPyramidLevel
 Max pyramid level to track. More...
 
uint32_t maxTemplateSize
 Maximum size of templates to track, if ROI > maxTemplateSize * maxTemplateSize, template tracker will clamp the center maxTemplateSize * maxTemplateSize region to do tracking. More...
 
uint32_t minTemplateSize
 Minimum size of templates to track, if ROI < minTemplateSize * minTemplateSize, template tracker will extend the contour to include minTemplateSize * minTemplateSize region to do tracking. More...
 
uint32_t imageWidth
 Width of the images that the tracker runs on. More...
 
uint32_t imageHeight
 Height of the images that the tracker runs on. More...
 
uint32_t numIterationsFine
 Iteration number to apply the KLT tracker. More...
 
uint32_t numIterationsCoarse
 for DW_TEMPLATE_TRACKER_ALGO_IA only Iteration number to apply the coarse KLT for robustness. More...
 
float32_t thresholdUpdate
 Updating threshold in [0, 1]. More...
 
float32_t thresholdKill
 Killing threshold in [0, 1]. More...
 
float32_t thresholdStop
 for DW_TEMPLATE_TRACKER_ALGO_IC only Stop threshold in [-1, 1]. More...
 
float32_t maxScaleChange
 If scalingFactor between frame N to N-1 is outside range [1/maxScaleChange, maxScaleChange] tracking will be killed. More...
 
float32_t validWidth
 Maximum valid template width, any templates with bbox.width > validWidth will be killed after tracking. More...
 
float32_t validHeight
 Maximum valid template height, any templates with bbox.height > validHeight will be killed after tracking. More...
 
dwProcessorType processorType
 Processor type which determines on which processor the algorithm should be executed on. More...
 

Field Documentation

◆ algorithm

dwTemplateTrackerAlgorithm dwTemplateTrackerParameters::algorithm

Tracking Algorithm defined by dwTemplateTrackerAlgorithm.

Definition at line 111 of file TemplateTracker.h.

◆ imageHeight

uint32_t dwTemplateTrackerParameters::imageHeight

Height of the images that the tracker runs on.

Definition at line 131 of file TemplateTracker.h.

◆ imageWidth

uint32_t dwTemplateTrackerParameters::imageWidth

Width of the images that the tracker runs on.

Definition at line 128 of file TemplateTracker.h.

◆ maxPyramidLevel

uint32_t dwTemplateTrackerParameters::maxPyramidLevel

Max pyramid level to track.

Definition at line 117 of file TemplateTracker.h.

◆ maxScaleChange

float32_t dwTemplateTrackerParameters::maxScaleChange

If scalingFactor between frame N to N-1 is outside range [1/maxScaleChange, maxScaleChange] tracking will be killed.

Definition at line 167 of file TemplateTracker.h.

◆ maxTemplateCount

uint32_t dwTemplateTrackerParameters::maxTemplateCount

Upper bound on number of templates handled.

Definition at line 114 of file TemplateTracker.h.

◆ maxTemplateSize

uint32_t dwTemplateTrackerParameters::maxTemplateSize

Maximum size of templates to track, if ROI > maxTemplateSize * maxTemplateSize, template tracker will clamp the center maxTemplateSize * maxTemplateSize region to do tracking.

Definition at line 121 of file TemplateTracker.h.

◆ minTemplateSize

uint32_t dwTemplateTrackerParameters::minTemplateSize

Minimum size of templates to track, if ROI < minTemplateSize * minTemplateSize, template tracker will extend the contour to include minTemplateSize * minTemplateSize region to do tracking.

Definition at line 125 of file TemplateTracker.h.

◆ numIterationsCoarse

uint32_t dwTemplateTrackerParameters::numIterationsCoarse

for DW_TEMPLATE_TRACKER_ALGO_IA only Iteration number to apply the coarse KLT for robustness.

Coarse tracking converges with smaller iteration number, but is not as accurate as fine tracking. If setting as 0, the algorithm will skip the coarse pass, use fine only iteration

Definition at line 141 of file TemplateTracker.h.

◆ numIterationsFine

uint32_t dwTemplateTrackerParameters::numIterationsFine

Iteration number to apply the KLT tracker.

Definition at line 134 of file TemplateTracker.h.

◆ processorType

dwProcessorType dwTemplateTrackerParameters::processorType

Processor type which determines on which processor the algorithm should be executed on.

Supported options are: DW_PROCESSOR_TYPE_GPU, DW_PROCESSOR_TYPE_PVA_0, DW_PROCESSOR_TYPE_PVA_1.

Note
DW_PROCESSOR_TYPE_GPU supports both DW_TEMPLATE_TRACKER_ALGORITHM_IA and DW_TEMPLATE_TRACKER_ALGORITHM_IC
DW_PROCESSOR_TYPE_PVA_0/1 supports only DW_TEMPLATE_TRACKER_ALGORITHM_IC

Definition at line 184 of file TemplateTracker.h.

◆ thresholdKill

float32_t dwTemplateTrackerParameters::thresholdKill

Killing threshold in [0, 1].

If ZNCC between 2 frames is less than this value, tracking will be killed. Smaller value means less possible to be killed. If thresholdKill = 0 or -1, the tracking will not be marked as failure until it's out of time or move out of boundary. If thresholdKill = 1, the tracking will always be killed.

Definition at line 155 of file TemplateTracker.h.

◆ thresholdStop

float32_t dwTemplateTrackerParameters::thresholdStop

for DW_TEMPLATE_TRACKER_ALGO_IC only Stop threshold in [-1, 1].

If ZNCC between 2 frames is larger than this value, tracking will have early stop even before it reaches the maximal number of allowed iterations. Larger value means less possible to be considered as converged track. If nccThresholdStop = 1, the tracking will always run the maximal number of allowed iterations. If nccThresholdStop = -1, the tracking will run one iteration.

Definition at line 163 of file TemplateTracker.h.

◆ thresholdUpdate

float32_t dwTemplateTrackerParameters::thresholdUpdate

Updating threshold in [0, 1].

If ZNCC between 2 frames is less than this value, tracking template will be updated. Otherwise only updates its location but keep the original size and image data unchanged. Larger value means updating the template more frequently. If thresholdUpdate = 1, template will be updated every frame If thresholdUpdate = 0, template won't be updated unless the size of stored template and new one differs too much.

Definition at line 149 of file TemplateTracker.h.

◆ validHeight

float32_t dwTemplateTrackerParameters::validHeight

Maximum valid template height, any templates with bbox.height > validHeight will be killed after tracking.

validHeight = -1.F means there's no height limitation

Definition at line 177 of file TemplateTracker.h.

◆ validWidth

float32_t dwTemplateTrackerParameters::validWidth

Maximum valid template width, any templates with bbox.width > validWidth will be killed after tracking.

validWidth = -1.F means there's no width limitation

Definition at line 172 of file TemplateTracker.h.


The documentation for this struct was generated from the following file: