# CalibrationQuality

CalibrationQuality 消息是 [动态校准](https://docs.luxonis.com/software-v3/depthai/depthai-components/host_nodes/dynamic_calibration.md)
系统的一部分。它旨在评估并报告当前立体相机校准的质量，提供有关校准性能及任何检测到的偏差的详细统计数据。

它帮助用户和自动化系统通过将当前校准指标与已知基准或先前校准状态进行比较，判断是否需要重新校准。

## 功能示例

当用户向动态校准节点发送 CalibrationQuality 命令时，会接收到校准质量消息。

 * [校准集成示例](https://github.com/luxonis/depthai-core/blob/main/examples/python/DynamicCalibration/calibration_integration.py)

## 参考

### dai::CalibrationQuality

Kind: struct

Summary of calibration quality metrics.

Returned from a calibration quality check. Describes expected accuracy improvement if a new calibration were applied.

#### dai::CalibrationQuality::Data

Kind: struct

Quality metrics describing differences between current and predicted calibration.

##### std::array< float, 3 > rotationChange

Kind: variable

##### std::vector< double > depthErrorDifference

Kind: variable

##### float sampsonErrorCurrent

Kind: variable

Sampson error of currently installed calibration.

##### float sampsonErrorNew

Kind: variable

Estimated new Sampson error if the new calibration is applied.

##### std::map< std::pair< CameraBoardSocket, CameraBoardSocket >, RotationChangePerAxis > pairwiseRotationDifference

Kind: variable

Pairwise per-axis rotation deltas keyed by camera socket pairs.

##### DEPTHAI_SERIALIZE(Data, rotationChange, sampsonErrorCurrent, sampsonErrorNew, depthErrorDifference,
pairwiseRotationDifference)

Kind: function

#### std::optional< Data > qualityData

Kind: variable

Optional quality metrics.

#### std::string info

Kind: variable

Human-readable result description.

#### CalibrationQuality()

Kind: function

#### ~CalibrationQuality()

Kind: function

#### CalibrationQuality(Data qualityData, std::string info)

Kind: function

Construct a CalibrationQuality message with data.

parameters: qualityData: Metrics describing the quality difference.; info: Informational text describing the result.

#### CalibrationQuality(std::string info)

Kind: function

Construct a CalibrationQuality message without metric data.

parameters: info: Informational text describing the result.

#### void serialize(std::vector< std::uint8_t > & metadata, DatatypeEnum & datatype)

Kind: function

#### DatatypeEnum getDatatype()

Kind: function

Get the datatype of this specific message.

return: DatatypeEnum

#### DEPTHAI_SERIALIZE(CalibrationQuality, qualityData, info)

Kind: function

### 需要帮助？

请前往 [OAKChina 官网](https://www.oakchina.cn/) 获取技术支持或解答您的任何疑问。