CoverageData
The CoverageData message provides real-time feedback on the visual feature coverage across the stereo field of view during the Dynamic Calibration process. It quantifies how well the current scene supports calibration — i.e., whether the system has enough diverse and spatially distributed visual features to perform an accurate recalibration.It is a diagnostic data structure that helps ensure the recalibration is based on reliable input. Adequate coverage directly influences calibration accuracy and confidence.CoverageData message is received via coverageOutput when an image is loaded either manually (with LoadImage command) or during continuous calibration (after running StartCalibration command).Examples of functionality
Reference
struct
dai::CoverageData
variable
std::vector< std::vector< float > > coveragePerCellA
2D coverage matrix for input A (e.g. left image). Each cell represents how well that spatial bin is populated; range [0, 1].
variable
std::vector< std::vector< float > > coveragePerCellB
2D coverage matrix for input B (e.g. right image). Each cell represents how well that spatial bin is populated; range [0, 1].
variable
float meanCoverage
Overall quality metric summarizing 2D coverage across both inputs. Typically normalized to [0, 1].
variable
float coverageAcquired
Proportion of the desired spatial coverage achieved so far; range [0, 1].
variable
float dataAcquired
Proportion of calibration-relevant data acquired from the frame; range [0, 1].
function
CoverageData()function
~CoverageData()inline function
void serialize(std::vector< std::uint8_t > & metadata, DatatypeEnum & datatype)function
DEPTHAI_SERIALIZE(CoverageData, coveragePerCellA, coveragePerCellB, meanCoverage, dataAcquired, coverageAcquired)Need assistance?
Head over to Discussion Forum for technical support or any other questions you might have.