class QMagnetometerReading#

QMagnetometerReading 表示磁力计的一次读数。 更多...

Inheritance diagram of PySide6.QtSensors.QMagnetometerReading

摘要#

属性#

  • calibrationLevel - 读数的精度

  • x - X轴上的原始磁通密度

  • y - Y轴上的原始磁通密度

  • z - Z轴上的原始磁通密度

方法#

注释

此文档可能包含从C++自动翻译到Python的代码段。我们始终欢迎对代码段的翻译做出贡献。如果您发现翻译中存在问题,您也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建一个工单来让我们知道

详细介绍#

QMagnetometerReading 单位#

磁力计返回沿3个轴的磁通密度值。数值的量级是特斯拉。轴的排列如下。

../../_images/sensors-coordinates2.jpg

磁力计可以报告原始磁场通量值或地磁场通量值。默认情况下,它返回原始磁场通量值。《returnGeoValues`属性必须设置为返回地磁场通量值。

原始值和地磁场值的最大区别在于,地磁场值会进行额外的处理以消除局部磁场干扰,从而仅表示地球磁场的效应。这个过程并不完美,每次读数的精度可能会变化。

下面的图像展示了手机受到磁场干扰时地磁场(左侧)和原始(右侧)读取值的差异。

../../_images/sensors-geo-vs-raw-magnetism.jpg

每次读数的精度以0到1之间的数字衡量。1表示设备可以支持的最高级别,0表示最差。

校准#

如果设备报告的精度较低,则可能需要校准才能提供可接受的测量结果。基本校准通常可以通过将设备旋转成数字8的形状或沿其三个轴中的每一个旋转设备来完成。有关更多信息,请参阅设备文档,了解如何校准磁场传感器。

注释

当使用`from __feature__ import true_property`时可以直接使用属性,否则可以通过访问器函数来使用。

属性calibrationLevelᅟ: float#

此属性持有读取的精度。

以0到1之间的值测量,值越高越好。

请注意,这仅在测量地磁场通量密度时才会改变。原始磁场通量读取始终具有1的值。

另请参阅

QMagnetometerReading Units Calibration

访问函数
属性xᅟ: float#

此属性持有X轴上的原始磁场通量密度。

以特斯拉为单位测量。

另请参阅

QMagnetometerReading Units

访问函数
属性yᅟ: float#

此属性持有Y轴上的原始磁场通量密度。

以特斯拉为单位测量。

另请参阅

QMagnetometerReading Units

访问函数
属性zᅟ: float#

此属性持有Z轴上的原始磁场通量密度。

以特斯拉为单位测量。

另请参阅

QMagnetometerReading Units

访问函数
__init__(parent)#
参数:

parentQObject

calibrationLevel()#
返回类型:

浮点数

另请参阅

setCalibrationLevel()

calibrationLevel 属性的获取器。

setCalibrationLevel(calibrationLevel)#
参数:

calibrationLevel – 浮点数

将读数的精度设置为 calibrationLevel

另请参阅

calibrationLevel()

setX(x)#
参数:

x – 浮点数

将 X 轴上的原始磁通密度设置为 x

另请参阅

x()

setY(y)#
参数:

y – 浮点数

将 Y 轴上的原始磁通密度设置为 y

另请参阅

y()

setZ(z)#
参数:

z – 浮点数

将 Z 轴上的原始磁通密度设置为 z

另请参阅

z()

x()#
返回类型:

浮点数

另请参阅

setX()

x 属性的获取器。

y()#
返回类型:

浮点数

另请参阅

setY()

y 属性的获取器。

z()#
返回类型:

浮点数

另请参阅

setZ()

z 属性的获取器。