PySide6.QtSensors.QMagnetometerReading¶

class QMagnetometerReading¶

QMagnetometerReading 类表示来自磁力计的一次读数。更多…

概要¶

属性¶

calibrationLevelᅟ - 读数的准确性
xᅟ - X轴上的原始磁通密度
yᅟ - Y轴上的原始磁通密度
zᅟ - Z轴上的原始磁通密度

方法¶

def __init__()
def calibrationLevel()
def setCalibrationLevel()
def setX()
def setY()
def setZ()
def x()
def y()
def z()

注意

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

详细描述¶

QMagnetometerReading 单位¶

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

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

原始值和地磁值之间的主要区别在于，对地磁值进行了额外的处理，以消除局部磁干扰，因此它们仅代表地球磁场的影响。这个过程并不完美，每次读数的准确性可能会有所变化。

下图显示了受到磁干扰的手机的地磁读数（左侧）和原始读数（右侧）之间的差异。

每次读取的准确性以0到1之间的数字来衡量。值为1表示设备支持的最高水平，而0表示最差。

校准¶

如果设备报告精度较低，那么在提供可接受的测量结果之前可能需要进行校准。基本校准通常可以通过以八字形旋转设备或沿其三个轴旋转设备来完成。有关更多信息，请查看设备文档中关于如何校准磁传感器的说明。

注意

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

property calibrationLevelᅟ: float¶

此属性保存读数的准确性。

测量值为0到1之间的值，数值越高越好。

请注意，这仅在测量地磁通量密度时发生变化。原始磁通量读数始终为1。

另请参阅

QMagnetometerReading 单位 校准

Access functions:

calibrationLevel()

property xᅟ: float¶

此属性保存X轴上的原始磁通密度。

以特斯拉为单位测量。

另请参阅

QMagnetometerReading Units

Access functions:

x()

property yᅟ: float¶

此属性保存Y轴上的原始磁通密度。

以特斯拉为单位测量。

另请参阅

QMagnetometerReading Units

Access functions:

y()

property zᅟ: float¶

此属性保存Z轴上的原始磁通密度。

以特斯拉为单位测量。

另请参阅

QMagnetometerReading 单位

Access functions:

z()

__init__(parent)¶

Parameters:: 父对象 – QObject

calibrationLevel()¶

Return type:: 浮点数

另请参阅

setCalibrationLevel()

属性 calibrationLevelᅟ 的获取器。

setCalibrationLevel(calibrationLevel)¶

Parameters:: calibrationLevel – 浮点数

将读数的准确性设置为calibrationLevel。

另请参阅

calibrationLevel()

setX(x)¶

Parameters:: x – 浮点数

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

另请参阅

x()

setY(y)¶

Parameters:: y – 浮点数

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

另请参阅

y()

setZ(z)¶

Parameters:: z – 浮点数

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

另请参阅

z()

x()¶

Return type:: 浮点数

另请参阅

setX()

属性 xᅟ 的获取器。

y()¶

Return type:: 浮点数

另请参阅

setY()

属性 yᅟ 的获取器。

z()¶

Return type:: 浮点数

另请参阅

setZ()

属性 zᅟ 的获取器。