Struct AutoCalibrationConfig

Inheritance Relationships

Base Type

Struct Documentation

struct AutoCalibrationConfig : public dai::Buffer

AutoCalibrationConfig message. Carries configuration for the automatic camera calibration algorithm. Defines parameters for periodic or one-time recalibration of the camera sensors.

Public Types

enum Mode

Defines when the auto-calibration process should be triggered.

Values:

enumerator ON_START

Run calibration once upon pipeline startup.

enumerator CONTINUOUS

Periodically run calibration while the pipeline is running.

Public Functions

AutoCalibrationConfig() = default
inline AutoCalibrationConfig(Mode mode, int sleepingTime, double calibrationConfidence, double dataConfidence, unsigned int maxIter, unsigned int maxImg, int valSize, bool flash)

Full constructor for initializing auto-calibration parameters.

Parameters:

  • mode – Calibration trigger mode (ON_START or CONTINUOUS).

  • sleepingTime – Time in seconds between calibration cycles.

  • calibrationConfidence – Threshold for accepting a new calibration result.

  • dataConfidence – Threshold for the quality of input data/features.

  • maxIter – Maximum number of optimization iterations.

  • maxImg – Maximum number of images to collect for a single recalibration.

  • valSize – Number of images used to validate the calibration result.

  • flash – Whether to save the resulting calibration to non-volatile memory.

virtual ~AutoCalibrationConfig()
virtual void serialize(std::vector<std::uint8_t> &metadata, DatatypeEnum &datatype) const override
inline virtual DatatypeEnum getDatatype() const override

Get the datatype of this specific message.

Returns:

DatatypeEnum

DEPTHAI_SERIALIZE(AutoCalibrationConfig, mode, sleepingTime, calibrationConfidenceThreshold, dataConfidenceThreshold, maxIterations, maxImagesPerRecalibration, validationSetSize, flashCalibration)

Public Members

Mode mode = Mode::ON_START

Calibration trigger mode (ON_START or CONTINUOUS).

int sleepingTime = 30

Seconds to sleep between calibration cycles in CONTINUOUS mode.

double calibrationConfidenceThreshold = 0.9

Minimum confidence score (0.0 to 1.0) required to apply a new calibration.

double dataConfidenceThreshold = 0.7

Minimum quality threshold (0.0 to 1.0) for input features to be used.

unsigned int maxIterations = 5

Maximum number of optimization iterations per calibration cycle.

unsigned int maxImagesPerRecalibration = 10

Maximum number of images to collect for one recalibration event.

int validationSetSize = 5

Number of images used for validating the calibration result.

bool flashCalibration = true

If true, saves successful calibration to non-volatile memory (EEPROM); otherwise, keeps in RAM only.