低级单位转换#

将数量从一个单位转换为另一个单位是使用 Quantity.to() 方法。本页描述了一些用于处理单位转换的低级功能,这些功能在用户代码中很少需要。

直接转换#

在这种情况下,给定源和目标单位,将返回新单位中的值。

>>> from astropy import units as u
>>> u.pc.to(u.m, 3.26)
1.0059308915661856e+17

这会将3.26秒转换为米。

允许数组作为参数。

>>> u.h.to(u.s, [1, 2, 5, 10.1])
array([  3600.,   7200.,  18000.,  36360.])

获取转换函数#

最后,可以获得可用于转换为新单位的函数。通常,当所有需要做的是乘以比例因数时,这可能看起来有点矫枉过正,但在某些情况下,单位之间的转换可能不像单个比例因数那么简单,例如,当使用自定义等效表时。

转换为不同的单位涉及到获取转换函数,然后将其应用于值或要转换的值。

>>> cms = u.cm / u.s
>>> cms_to_kmph = cms.get_converter(u.km / u.hour)
>>> cms_to_kmph(125.)
4.5
>>> cms_to_kmph([1000, 2000])
array([36., 72.])

不兼容的转换#

如果尝试转换为不兼容的单位, UnitConversionError 将导致:

>>> cms = u.cm / u.s
>>> cms.to(u.km)  
Traceback (most recent call last):
  ...
UnitConversionError: 'cm / s' (speed) and 'km' (length) are not convertible

方法检查是否可以进行特定转换。 is_equivalent() 方法:

>>> u.m.is_equivalent(u.pc)
True
>>> u.m.is_equivalent("second")
False
>>> (u.m ** 3).is_equivalent(u.l)
True