Skip to main content
`Ctrl`+`K`

# add_enabled_units

astropy.units.add_enabled_units(units)

  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:
    units `python:list` of python:sequence, `python:dict`, or python: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 ,
        lsec         | 2.99792e+08 m   | lightsecond                      ,
        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                             ,
      ]