add_enabled_units

astropy.units.add_enabled_units(units)[source]

Adds to the set of units enabled in the unit registry.

These units are searched when using UnitBase.find_equivalent_units, for example.

This may be used either permanently, or as a context manager using the with statement (see example below).

Parameters
unitslist of sequence, dict, or module

This is a list of things in which units may be found (sequences, dicts or modules), or units themselves. The entire set will be added to the “enabled” set for searching through by methods like UnitBase.find_equivalent_units and UnitBase.compose.

Examples

>>> from astropy import units as u
>>> from astropy.units import imperial
>>> with u.add_enabled_units(imperial):
...     u.m.find_equivalent_units()
...
  Primary name | Unit definition | Aliases
[
  AU           | 1.49598e+11 m   | au, astronomical_unit ,
  Angstrom     | 1e-10 m         | AA, angstrom          ,
  cm           | 0.01 m          | centimeter            ,
  earthRad     | 6.3781e+06 m    | R_earth, Rearth       ,
  ft           | 0.3048 m        | foot                  ,
  fur          | 201.168 m       | furlong               ,
  inch         | 0.0254 m        |                       ,
  jupiterRad   | 7.1492e+07 m    | R_jup, Rjup, R_jupiter, Rjupiter ,
  lyr          | 9.46073e+15 m   | lightyear             ,
  m            | irreducible     | meter                 ,
  mi           | 1609.34 m       | mile                  ,
  micron       | 1e-06 m         |                       ,
  mil          | 2.54e-05 m      | thou                  ,
  nmi          | 1852 m          | nauticalmile, NM      ,
  pc           | 3.08568e+16 m   | parsec                ,
  solRad       | 6.957e+08 m     | R_sun, Rsun           ,
  yd           | 0.9144 m        | yard                  ,
]