1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
Low-Level Unit Conversion
*************************
Conversion of quantities from one unit to another is handled using the
`Quantity.to() <astropy.units.quantity.Quantity.to>` method. This page
describes some low-level features for handling unit conversion that
are rarely required in user code.
Direct Conversion
=================
.. EXAMPLE START: Direct Conversions Between Units
In this case, given a source and destination unit, the values in the
new units are returned.
>>> from astropy import units as u
>>> u.pc.to(u.m, 3.26)
1.0059308915661856e+17
This converts 3.26 parsecs to meters.
Arrays are permitted as arguments.
>>> u.h.to(u.s, [1, 2, 5, 10.1])
array([ 3600., 7200., 18000., 36360.])
.. EXAMPLE END
Incompatible Conversions
========================
.. EXAMPLE START: Conversions Between Incompatible Units
If you attempt to convert to a incompatible unit, a
:class:`~astropy.units.UnitConversionError` will result:
>>> cms = u.cm / u.s
>>> cms.to(u.km) # doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
...
UnitConversionError: 'cm / s' (speed) and 'km' (length) are not convertible
You can check whether a particular conversion is possible using the
:meth:`~astropy.units.core.UnitBase.is_equivalent` method::
>>> u.m.is_equivalent(u.pc)
True
>>> u.m.is_equivalent("second")
False
>>> (u.m ** 3).is_equivalent(u.l)
True
.. EXAMPLE END
|
