[c@`smdZddlmZmZmZmZddlmZddlm Z ddl Z ddl Z ddl Z ddl Z ddlZddlmZmZddlmZdd lmZmZd d lmZmZmZmZd d lmZej r ddl!Z!nd ddddddddddddddddddgZ"d Z#d!Z$d"e%fd#YZ&d$e%fd%YZ'e&gZ(d&Z)d'Z*d(Z+d)Z,d*Z-d+e.fd,YZ/d-e/e0fd.YZ1d/e/e0fd0YZ2d1e/e3fd2YZ4d3efd4YZ5ej6ed5e%fd6YZ7d7e7fd8YZ8d9Z9d:e8fd;YZ:d<e:fd=YZ;d>efd?YZ<ej6e<d@e8fdAYZ=dBe=fdCYZ>dDe7fdEYZ?dFgdGgdHfdIgdJgdKfdLgdMgdNfdOgdPgdQfdRgdSgdTfdUgdVgdWfdXgdYgdZfd[gd\gd]fd^gd_gd`fdagdbdcgddfdegdfgdgfdhgdigdjfdkgdlgdmfdngdogdpfdqgdrgdsfdtgdugdvfdwgdxgdyfdzgd{gd|fd}gd~gdfdgdgdfgZ@dgdgddfdgdgddfdgdgddfdgdgddfdgdgddfdgdgddfgZAgeBeCdZDeBeBeBeCgeBdZEdZFe?d ggdeCZGeGZHe1ejI_1dS(u" Core units classes and functions i(tabsolute_importtdivisiontprint_functiontunicode_literalsi(tsix(tzipN(t lazypropertyt deprecated(tAstropyWarning(t isiterabletInheritDocstringsi(tis_effectively_unitytsanitize_scaletvalidate_powertresolve_fractions(tformatu UnitsErroru UnitsWarninguUnitConversionErroru UnitTypeErroruUnitBaseu NamedUnituIrreducibleUnituUnitu CompositeUnitu PrefixUnituUnrecognizedUnitudef_unituget_current_unit_registryuset_enabled_unitsuadd_enabled_unitsuset_enabled_equivalenciesuadd_enabled_equivalenciesudimensionless_unscaleduonecC`st|ts|g}nt}x|D]}t|trP|j|q+t|trn|j}n<tj|rt |j}nt |r+|}nq+x-|D]%}t|tr|j|qqWq+W|S(u Given a list of sequences, modules or dictionaries of units, or single units, return a flat set of all the units found. ( t isinstancetlisttsettUnitBasetaddtdicttvaluestinspecttismoduletvarsR (titemstresulttitemtunitstunit((s1lib/python2.7/site-packages/astropy/units/core.pyt_flatten_units_collection(s"      cC`sP|dkrgSg}x3t|D]%\}}t|dkr]|\}}d}}nit|dkr|\}}}|}n?t|dkr|\}}}}ntdj|||t|ko|dks|t|kotj|otj|s/tdj||n|j||||fq#W|S(u Normalizes equivalencies, ensuring each is a 4-tuple of the form:: (from_unit, to_unit, forward_func, backward_func) Parameters ---------- equivalencies : list of equivalency pairs Raises ------ ValueError if an equivalency cannot be interpreted icS`s|S(N((tx((s1lib/python2.7/site-packages/astropy/units/core.pyt[siiu$Invalid equivalence entry {0}: {1!r}N( tNonet enumeratetlent ValueErrorRtUnitRtcallabletappend(t equivalenciest normalizedtitequivtfunitttunittatb((s1lib/python2.7/site-packages/astropy/units/core.pyt_normalize_equivalenciesEs,   t _UnitRegistrycB`seZdZggdZdZdZedZedZedZ dZ dZ d Z ed Z d Zd ZRS( u2 Manages a registry of the enabled units. cC`st|try|jj|_|jj|_|jj|_|jj|_dtj|j D|_ n.|j |j |j ||j |dS(NcS`s%i|]\}}|j|qS((tcopy(t.0tktv((s1lib/python2.7/site-packages/astropy/units/core.pys s (RR2t_equivalenciesR3t _all_unitst _registryt_non_prefix_unitsRt iteritemst_by_physical_typet _reset_unitst_reset_equivalenciestadd_enabled_unitstadd_enabled_equivalencies(tselftinitR)((s1lib/python2.7/site-packages/astropy/units/core.pyt__init__ts   cC`s.t|_t|_i|_i|_dS(N(RR8R:R9R<(RA((s1lib/python2.7/site-packages/astropy/units/core.pyR=s   cC`st|_dS(N(RR7(RA((s1lib/python2.7/site-packages/astropy/units/core.pyR>scC`s|jS(N(R9(RA((s1lib/python2.7/site-packages/astropy/units/core.pytregistryscC`s|jS(N(R8(RA((s1lib/python2.7/site-packages/astropy/units/core.pyt all_unitsscC`s|jS(N(R:(RA((s1lib/python2.7/site-packages/astropy/units/core.pytnon_prefix_unitsscC`s|j|j|S(u? Sets the units enabled in the unit registry. These units are searched when using `UnitBase.find_equivalent_units`, for example. Parameters ---------- units : list of sequences, dicts, or modules containing units, or units This is a list of things in which units may be found (sequences, dicts or modules), or units themselves. The entire set will be "enabled" for searching through by methods like `UnitBase.find_equivalent_units` and `UnitBase.compose`. (R=R?(RAR((s1lib/python2.7/site-packages/astropy/units/core.pytset_enabled_unitss cC`st|}x|D]}xK|jD]@}||jkr#||j|kr#tdj|q#q#Wx|jD]}||j|R@(RAR)((s1lib/python2.7/site-packages/astropy/units/core.pytset_enabled_equivalenciess cC`s%t|}|jt|O_dS(u Adds to the set of equivalencies enabled in the unit registry. These equivalencies are used if no explicit equivalencies are given, both in unit conversion and in finding equivalent units. This is meant in particular for allowing angles to be dimensionless. Use with care. Parameters ---------- equivalencies : list of equivalent pairs E.g., as returned by `~astropy.units.equivalencies.dimensionless_angles`. N(R1R7R(RAR)((s1lib/python2.7/site-packages/astropy/units/core.pyR@s (t__name__t __module__t__doc__RCR=R>tpropertyRDRERFRGR?ROR)RPR@(((s1lib/python2.7/site-packages/astropy/units/core.pyR2os    &  t _UnitContextcB`s)eZggdZdZdZRS(cC`s tjtd|d|dS(NRBR)(t_unit_registriesR(R2(RARBR)((s1lib/python2.7/site-packages/astropy/units/core.pyRCscC`sdS(N((RA((s1lib/python2.7/site-packages/astropy/units/core.pyt __enter__scC`stjdS(N(RVtpop(RAttypetvaluettb((s1lib/python2.7/site-packages/astropy/units/core.pyt__exit__s(RQRRRCRWR\(((s1lib/python2.7/site-packages/astropy/units/core.pyRUs cC`stdS(Ni(RV(((s1lib/python2.7/site-packages/astropy/units/core.pytget_current_unit_registryscC`s)tdtj}tj||S(uh Sets the 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 : list of sequences, dicts, or modules containing units, or units This is a list of things in which units may be found (sequences, dicts or modules), or units themselves. The entire set will be "enabled" for searching through by methods like `UnitBase.find_equivalent_units` and `UnitBase.compose`. Examples -------- >>> from astropy import units as u >>> with u.set_enabled_units([u.pc]): ... u.m.find_equivalent_units() ... Primary name | Unit definition | Aliases [ pc | 3.08568e+16 m | parsec , ] >>> 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 , jupiterRad | 7.1492e+07 m | R_jup, Rjup, R_jupiter, Rjupiter , lyr | 9.46073e+15 m | lightyear , m | irreducible | meter , micron | 1e-06 m | , pc | 3.08568e+16 m | parsec , solRad | 6.957e+08 m | R_sun, Rsun , ] R)(RUR]R)RG(Rtcontext((s1lib/python2.7/site-packages/astropy/units/core.pyRG"s-cC`s#tt}tj||S(u 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 : list of sequences, dicts, or modules containing units, or units 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 , ] (RUR]R?(RR^((s1lib/python2.7/site-packages/astropy/units/core.pyR?Vs1cC`s#tt}tj||S(uE Sets the equivalencies enabled in the unit registry. These equivalencies are used if no explicit equivalencies are given, both in unit conversion and in finding equivalent units. This is meant in particular for allowing angles to be dimensionless. Use with care. Parameters ---------- equivalencies : list of equivalent pairs E.g., as returned by `~astropy.units.equivalencies.dimensionless_angles`. Examples -------- Exponentiation normally requires dimensionless quantities. To avoid problems with complex phases:: >>> from astropy import units as u >>> with u.set_enabled_equivalencies(u.dimensionless_angles()): ... phase = 0.5 * u.cycle ... np.exp(1j*phase) # doctest: +SKIP (RUR]RP(R)R^((s1lib/python2.7/site-packages/astropy/units/core.pyRPscC`s#tt}tj||S(u/ Adds to the equivalencies enabled in the unit registry. These equivalencies are used if no explicit equivalencies are given, both in unit conversion and in finding equivalent units. This is meant in particular for allowing angles to be dimensionless. Since no equivalencies are enabled by default, generally it is recommended to use `set_enabled_equivalencies`. Parameters ---------- equivalencies : list of equivalent pairs E.g., as returned by `~astropy.units.equivalencies.dimensionless_angles`. (RUR]R@(R)R^((s1lib/python2.7/site-packages/astropy/units/core.pyR@st UnitsErrorcB`seZdZRS(u6 The base class for unit-specific exceptions. (RQRRRS(((s1lib/python2.7/site-packages/astropy/units/core.pyR_stUnitScaleErrorcB`seZdZRS(ug Used to catch the errors involving scaled units, which are not recognized by FITS format. (RQRRRS(((s1lib/python2.7/site-packages/astropy/units/core.pyR`stUnitConversionErrorcB`seZdZRS(u} Used specifically for errors related to converting between units or interpreting units in terms of other units. (RQRRRS(((s1lib/python2.7/site-packages/astropy/units/core.pyRast UnitTypeErrorcB`seZdZRS(u Used specifically for errors in setting to units not allowed by a class. E.g., would be raised if the unit of an `~astropy.coordinates.Angle` instances were set to a non-angular unit. (RQRRRS(((s1lib/python2.7/site-packages/astropy/units/core.pyRbst UnitsWarningcB`seZdZRS(u4 The base class for unit-specific warnings. (RQRRRS(((s1lib/python2.7/site-packages/astropy/units/core.pyRcsRcB`sseZdZdZdZdZdZejr?eZ ndZ ejsZe Z ndZ dZ e dZe d Ze d Ze d Ze d Ze d ZejdZdZedZdZdZdZeZeZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(gdZ)gdZ*d Z+gd!Z,d"Z-d#gd$Z.d#gd%Z/e0d&Z1ggd'd(d4d)Z3gd4d'e4d*Z5d+Z6e7d,Z8e7d-Z9e d.Z:gd/Z;d0e<fd1YZ=gd4e4d2Z>d3Z?RS(5u Abstract base class for units. Most of the arithmetic operations on units are defined in this base class. Should not be instantiated by users directly. icC`s|S(N((RAtmemo((s1lib/python2.7/site-packages/astropy/units/core.pyt __deepcopy__scC`stjj|S(u Generate latex representation of unit name. This is used by the IPython notebook to print a unit with a nice layout. Returns ------- Latex string (t unit_formattLatext to_string(RA((s1lib/python2.7/site-packages/astropy/units/core.pyt _repr_latex_s cC`stjj|jdS(u%Return string representation for unituunicode_escape(RftGenericRhtencode(RA((s1lib/python2.7/site-packages/astropy/units/core.pyt __bytes__ scC`stjj|S(u%Return string representation for unit(RfRjRh(RA((s1lib/python2.7/site-packages/astropy/units/core.pyt __unicode__scC`s:tjj|}tjr-|jd}ndj|S(Nuunicode_escapeu Unit("{0}")(RfRjRhRtPY2RkR(RAtstring((s1lib/python2.7/site-packages/astropy/units/core.pyt__repr__s cC`sG|j}tg|jD]}|j^q|j}t|}|S(u Returns an identifier that uniquely identifies the physical type of this unit. It is comprised of the bases and powers of this unit, without the scale. Since it is hashable, it is useful as a dictionary key. (t decomposeRtbasestnametpowersttuple(RARR tr((s1lib/python2.7/site-packages/astropy/units/core.pyRJs + cC`stddS(uE Returns all of the names associated with this unit. uDCan not get names from unnamed units. Perhaps you meant to_string()?N(tAttributeError(RA((s1lib/python2.7/site-packages/astropy/units/core.pytnames-scC`stddS(uO Returns the canonical (short) name associated with this unit. uDCan not get names from unnamed units. Perhaps you meant to_string()?N(Rw(RA((s1lib/python2.7/site-packages/astropy/units/core.pyRs6scC`stddS(u? Returns the alias (long) names for this unit. uFCan not get aliases from unnamed units. Perhaps you meant to_string()?N(Rw(RA((s1lib/python2.7/site-packages/astropy/units/core.pytaliases?scC`sdS(u/ Return the scale of the unit. g?((RA((s1lib/python2.7/site-packages/astropy/units/core.pytscaleHscC`s|gS(u/ Return the bases of the unit. ((RA((s1lib/python2.7/site-packages/astropy/units/core.pyRrOscC`sdgS(u0 Return the powers of the unit. i((RA((s1lib/python2.7/site-packages/astropy/units/core.pyRtVscC`stj|}|j|S(u Output the unit in the given format as a string. Parameters ---------- format : `astropy.units.format.Base` instance or str The name of a format or a formatter object. If not provided, defaults to the generic format. (Rft get_formatRh(RARtf((s1lib/python2.7/site-packages/astropy/units/core.pyRh]s cC`s?y|jd|SWn$tk r:ttj||SXdS(u&Try to format units using a formatter.RN(RhR%RRt text_type(RAt format_spec((s1lib/python2.7/site-packages/astropy/units/core.pyt __format__ks cC`s/t|}|dk r+|tj7}n|S(u< Normalizes equivalencies, ensuring each is a 4-tuple of the form:: (from_unit, to_unit, forward_func, backward_func) Parameters ---------- equivalencies : list of equivalency pairs, or `None` Returns ------- A normalized list, including possible global defaults set by, e.g., `set_enabled_equivalencies`, except when `equivalencies`=`None`, in which case the returned list is always empty. Raises ------ ValueError if an equivalency cannot be interpreted N(R1R"R]R)(R)R*((s1lib/python2.7/site-packages/astropy/units/core.pyR1rs  cC`std|g|gS(Ni(t CompositeUnit(RAtp((s1lib/python2.7/site-packages/astropy/units/core.pyt__pow__scC`st|ttjfr't|}nt|trh|jrF|Std||gddgdtSy%ddl m }|d||SWnt k rt SXdS(Niit _error_check(tQuantity( RtbytesRR}R&Rtis_unityRtFalsetquantityRt TypeErrortNotImplemented(RAtmR((s1lib/python2.7/site-packages/astropy/units/core.pyt__div__s " cC`st|ttjfr&t||SyNddlm}t|drb||}||}|S|||dSWntk rt SXdS(Ni(Ruuniti( RRRR}R&RRthasattrRR(RARRR((s1lib/python2.7/site-packages/astropy/units/core.pyt__rdiv__s   cC`st|ttjfr't|}nt|trx|jrF|S|jrV|Std||gddgdtSy%ddl m }|d||SWnt k rt SXdS(NiR(R( RRRR}R&RRRRRRRR(RARR((s1lib/python2.7/site-packages/astropy/units/core.pyt__mul__s  " cC`st|ttjfr&t||SyJddlm}t|drb||}||9}|S|||SWntk rt SXdS(Ni(Ruunit( RRRR}R&RRRRR(RARRR((s1lib/python2.7/site-packages/astropy/units/core.pyt__rmul__s   cC`s%tt|j|jtdfS(Nu1(RMtstrRzRs(RA((s1lib/python2.7/site-packages/astropy/units/core.pyt__hash__scC`s||krtSyt|dd}Wntttfk rCtSXt|tsWtSyt|j |SWntk rt SXdS(Nt parse_strictusilent( tTrueR&R%R_RRRRR t_toR(RAtother((s1lib/python2.7/site-packages/astropy/units/core.pyt__eq__s  cC`s ||k S(N((RAR((s1lib/python2.7/site-packages/astropy/units/core.pyt__ne__scC`s+|jt|}|dkp*t|S(Ng?(RR&R (RARRz((s1lib/python2.7/site-packages/astropy/units/core.pyt__le__scC`s+|jt|}|dkp*t|S(Ng?(RR&R (RARRz((s1lib/python2.7/site-packages/astropy/units/core.pyt__ge__scC`s ||k S(N((RAR((s1lib/python2.7/site-packages/astropy/units/core.pyt__lt__scC`s ||k S(N((RAR((s1lib/python2.7/site-packages/astropy/units/core.pyt__gt__scC`s|dS(Ng((RA((s1lib/python2.7/site-packages/astropy/units/core.pyt__neg__sc`s]jt|tr;tfd|DSt|dd}j|S(u Returns `True` if this unit is equivalent to ``other``. Parameters ---------- other : unit object or string or tuple The unit to convert to. If a tuple of units is specified, this method returns true if the unit matches any of those in the tuple. equivalencies : list of equivalence pairs, optional A list of equivalence pairs to try if the units are not directly convertible. See :ref:`unit_equivalencies`. This list is in addition to possible global defaults set by, e.g., `set_enabled_equivalencies`. Use `None` to turn off all equivalencies. Returns ------- bool c3`s$|]}j|dVqdS(R)N(t is_equivalent(R4tu(R)RA(s1lib/python2.7/site-packages/astropy/units/core.pys sRusilent(R1RRutanyR&t_is_equivalent(RARR)((R)RAs1lib/python2.7/site-packages/astropy/units/core.pyRs  cC`st|trtS|j|jkr/tSt|r|j}|j}x|D]\}}}}|dkry||j|gtSWqtk rqXqZ|j |r|j |s|j |rZ|j |rZtSqZWntS(uReturns `True` if this unit is equivalent to `other`. See `is_equivalent`, except that a proper Unit object should be given (i.e., no string) and that the equivalency list should be normalized using `_normalize_equivalencies`. N( RtUnrecognizedUnitRRJRR$RqR"t ExceptionR(RARR)RR/R0tforwardtbackward((s1lib/python2.7/site-packages/astropy/units/core.pyR%s&       cC`sKd}x|D]\}}}}|dkr~y9|j|jj|g} || j|dSWq tk rzq Xqy2|j|} |j|} || || SWntk rnXy2|j|} |j|} || || SWqtk r qXqWd} | |} | |}tdj| |dS(ud Internal function (used from `_get_converter`) to apply equivalence pairs. c`sfd}|S(Nc`st|S(N(t_condition_arg(R6(tfunctscale1tscale2(s1lib/python2.7/site-packages/astropy/units/core.pytconvertJs((RRRR((RRRs1lib/python2.7/site-packages/astropy/units/core.pytmake_converterIsg?cS`sL|jd}|j}|dkr9dj||}ndj|}|S(Nuunscaleduunknownu '{0}' ({1})u'{0}'(Rht physical_typeR(Rtunit_strR((s1lib/python2.7/site-packages/astropy/units/core.pyt get_err_strds  u{0} and {1} are not convertibleN(R"RqRzR_RRaR(RARRR)RR-R.R/R0tratio_in_funitRRRRt other_str((s1lib/python2.7/site-packages/astropy/units/core.pyt_apply_equivalenciesDs6        c`st|}yj|Wntk r2nXfdSy j|jSWntk r}t|drx]|jD]O\}}||kryfdSWqtk rqXqqWn|nXdS(Nc`st|S(N(R(tval(Rz(s1lib/python2.7/site-packages/astropy/units/core.pyR!~su equivalenciesc`sjd|S(NR)(t_get_converter(R6(R0R)RAR.(s1lib/python2.7/site-packages/astropy/units/core.pyR!s (R&RR_RR1RR)R(RARR)texcR-R/((R0R)RzRAR.s1lib/python2.7/site-packages/astropy/units/core.pyRus$     cC`s||krdSt|tr|j}|j}|j|jkrtdt|j|jDr|j|jSntdj ||dS(u Returns the scale to the specified unit. See `to`, except that a Unit object should be given (i.e., no string), and that all defaults are used, i.e., no equivalencies and value=1. g?cs`s!|]\}}||kVqdS(N((R4t self_baset other_base((s1lib/python2.7/site-packages/astropy/units/core.pys su*'{0!r}' is not a scaled version of '{1!r}'N( RRRqRttallRRrRzRaR(RARtself_decomposedtother_decomposed((s1lib/python2.7/site-packages/astropy/units/core.pyRs    g?cC`s|j|d||S(u Return the converted values in the specified unit. Parameters ---------- other : unit object or string The unit to convert to. value : scalar int or float, or sequence convertible to array, optional Value(s) in the current unit to be converted to the specified unit. If not provided, defaults to 1.0 equivalencies : list of equivalence pairs, optional A list of equivalence pairs to try if the units are not directly convertible. See :ref:`unit_equivalencies`. This list is in addition to possible global defaults set by, e.g., `set_enabled_equivalencies`. Use `None` to turn off all equivalencies. Returns ------- values : scalar or array Converted value(s). Input value sequences are returned as numpy arrays. Raises ------ UnitsError If units are inconsistent R)(R(RARRZR)((s1lib/python2.7/site-packages/astropy/units/core.pyttoscC`s|j|d|d|S(uI Alias for `to` for backward compatibility with pynbody. RZR)(R(RARRZR)((s1lib/python2.7/site-packages/astropy/units/core.pytin_unitsscC`s tdS(uE Return a unit object composed of only irreducible units. Parameters ---------- bases : sequence of UnitBase, optional The bases to decompose into. When not provided, decomposes down to any irreducible units. When provided, the decomposed result will only contain the given units. This will raises a `UnitsError` if it's not possible to do so. Returns ------- unit : CompositeUnit object New object containing only irreducible unit objects. N(tNotImplementedError(RARr((s1lib/python2.7/site-packages/astropy/units/core.pyRqsiic `sfd}|j}t|}|j|} | dk r^t| trZ| n| S||kr~|g||<|gS|g} x|D]\} } } }| dk rM|j| r| jj|j}| jt | d|| jqu|j| ru| jj|j}| jt |d|| jquq|j| r| jt |jqqWg}t |j dkrt |gt g}nt t g}xD]} | j}x| D]}t |j dkrLxMt |j |jD]3\}}|j|r| |} ||}PqqWn||j}|| }t |j }||r|dkr||j|q|j||| fqWqWx?|D]7}t |r|dj|d}|||<|SqW|jdtjdg}x|D]\}}} y2|jd|dd|d |dd |}Wntk rg}nXx-|D]%}|jt |j || fqWq'Wt |r_|jdtjd|dd}t }xM|D]E\}}} ||krPq|| }||r|j|qqWt |r_|||<|Sn||std j|}|||<|n|g||<|gS( Nc`s(x!|jD]}|kr tSq WtS(N(RrRR(Rtbase(t namespace(s1lib/python2.7/site-packages/astropy/units/core.pytis_final_results g?iitkeyR)Rt max_depthtdepthtcached_resultsu5Cannot represent unit {0} in terms of the given units(RqRMRNR"RRRRzR(R&R$RrRRRtRtuniontsorttoperatort itemgettert_composeR_R( RAR)RRRRRRRtcachedRR-R.R/R0Rztpartial_resultst final_resultsttunit_decomposedRRtpowertcomposedtfactoredt len_basest final_resulttresultst composed_listt subcomposedt min_lengtht subresultsR((Rs1lib/python2.7/site-packages/astropy/units/core.pyRs        *-   "            !            c `s6|jdfdfd}|j|d kr||jd}t|dkrtj}qnlt|trt |t j |}n?t j |r|t j t|}n|t|}d}||jdd|d|d dd iS( ug Return the simplest possible composite unit(s) that represent the given unit. Since there may be multiple equally simple compositions of the unit, a list of units is always returned. Parameters ---------- equivalencies : list of equivalence pairs, optional A list of equivalence pairs to also list. See :ref:`unit_equivalencies`. This list is in addition to possible global defaults set by, e.g., `set_enabled_equivalencies`. Use `None` to turn off all equivalencies. units : set of units to compose to, optional If not provided, any known units may be used to compose into. Otherwise, ``units`` is a dict, module or sequence containing the units to compose into. max_depth : int, optional The maximum recursion depth to use when composing into composite units. include_prefix_units : bool, optional When `True`, include prefixed units in the result. Default is `False`. Returns ------- units : list of `CompositeUnit` A list of candidate compositions. These will all be equally simple, but it may not be possible to automatically determine which of the candidates are better. cS`sjt|jdkr.t|jdkr.tSx5|jD]*}x!|jD]}||krHtSqHWq8WtS(Ni(R$RrRR(R/R0tabtbb((s1lib/python2.7/site-packages/astropy/units/core.pythas_bases_in_commons*  c`s||rtSxD]\}}}}|dk r|j|rc|j|rtSq|j|r|j|rtSqq|j|rt|rtSqqWtS(N(RR"RRqtdimensionless_unscaledR(RRR-R.R/R0(R)R(s1lib/python2.7/site-packages/astropy/units/core.pythas_bases_in_common_with_equivs   c`sht}xX|D]P}t|trs;t|t r|jr|j|qqW|S(N(RRRRIRqR(Rtfiltered_namespaceR.(t decomposedRtinclude_prefix_units(s1lib/python2.7/site-packages/astropy/units/core.pyt filter_unitss  R)icS`st|sgSt|}|jdd|jdd|jdd|jdd|d}|g}x@|dD]4}t|t|kr|j|n|}qW|S(NRcS`stj|jS(N(tnptabsRz(R ((s1lib/python2.7/site-packages/astropy/units/core.pyR!scS`stjtj|jS(N(RtsumRRt(R ((s1lib/python2.7/site-packages/astropy/units/core.pyR!scS`stj|jdkS(Ng(RRRt(R ((s1lib/python2.7/site-packages/astropy/units/core.pyR!scS`st|j S(N(R Rz(R ((s1lib/python2.7/site-packages/astropy/units/core.pyR!sii(R$RRRR((Rt last_resulttfilteredR((s1lib/python2.7/site-packages/astropy/units/core.pyt sort_resultss     RRRRN(R1RqR"t"_get_units_with_same_physical_typeR$R]RFRRRRt itervaluesRRRRR(RAR)RRRRR((RR)RRRs1lib/python2.7/site-packages/astropy/units/core.pytcomposeks&&        c`s^t|jfd}|jd}|jd|}t|d|dt}|S(u Converts this unit into ones belonging to the given system. Since more than one result may be possible, a list is always returned. Parameters ---------- system : module The module that defines the unit system. Commonly used ones include `astropy.units.si` and `astropy.units.cgs`. To use your own module it must contain unit objects and a sequence member named ``bases`` containing the base units of the system. Returns ------- units : list of `CompositeUnit` The list is ranked so that units containing only the base units of that system will appear first. c`sj|j}t|dkr"tjSd}x'|D]}|kr/|d7}q/q/W|tt|SdS(Nii(RrR$Rtinftfloat(Rt compose_basesRR(Rr(s1lib/python2.7/site-packages/astropy/units/core.pytscores   RrRRtreverse(RRrRqRtsortedR(RAtsystemRR R((Rrs1lib/python2.7/site-packages/astropy/units/core.pyt to_systems cC`s!ddlm}|j|dS(uL Returns a copy of the current `Unit` instance in SI units. i(tsii(tRR(RAR((s1lib/python2.7/site-packages/astropy/units/core.pyRscC`s!ddlm}|j|dS(uO Returns a copy of the current `Unit` instance with CGS units. i(tcgsi(RRR(RAR((s1lib/python2.7/site-packages/astropy/units/core.pyRscC`sddlm}|j|S(u Return the physical type on the unit. Examples -------- >>> from astropy import units as u >>> print(u.m.physical_type) length i(tphysical(RRtget_physical_type(RAR((s1lib/python2.7/site-packages/astropy/units/core.pyR%s cC`st}t|j|}x|D]\}}}}|dk r|j|rw||krw|j|j|n|j|r||kr|j|j|qq%|j|r%|jtq%q%W|S(u Return a list of registered units with the same physical type as this unit. This function is used by Quantity to add its built-in conversions to equivalent units. This is a private method, since end users should be encouraged to use the more powerful `compose` and `find_equivalent_units` methods (which use this under the hood). Parameters ---------- equivalencies : list of equivalence pairs, optional A list of equivalence pairs to also pull options from. See :ref:`unit_equivalencies`. It must already be normalized using `_normalize_equivalencies`. N( R]RROR"RtupdateRRR(RAR)t unit_registryRR-R.R/R0((s1lib/python2.7/site-packages/astropy/units/core.pyR4s  tEquivalentUnitsListcB`seZdZdZRS(ub A class to handle pretty-printing the result of `find_equivalent_units`. c C`sqt|dkrdSg}x]|D]U}|jj}||jkrSd}n|j|j|dj|jfq#W|j|jdddddg}xH|D]@}x7t |D])\}}t ||t|||s(RRR(RAR)RRR((s1lib/python2.7/site-packages/astropy/units/core.pytfind_equivalent_unitsvs   cC`stS(uK Returns `True` if the unit is unscaled and dimensionless. (R(RA((s1lib/python2.7/site-packages/astropy/units/core.pyRsN(@RQRRRSt__array_priority__ReRiRlRRnt__str__RmRpRJRTRxRsRyRzRrRtRfRjRhRt staticmethodR1RRRt __truediv__t __rtruediv__RRRRRRRRRRRRRRRRRRRqR"RRRRRRRRRRRRR(((s1lib/python2.7/site-packages/astropy/units/core.pyRsr                              1  !!  z  { -  "  #t NamedUnitcB`seZdZd d d dZdZdZedZedZ edZ edZ edZ d d Z RS( uh The base class of units that have a name. Parameters ---------- st : str, list of str, 2-tuple The name of the unit. If a list of strings, the first element is the canonical (short) name, and the rest of the elements are aliases. If a tuple of lists, the first element is a list of short names, and the second element is a list of long names; all but the first short name are considered "aliases". Each name *should* be a valid Python identifier to make it easy to access, but this is not required. namespace : dict, optional When provided, inject the unit, and all of its aliases, in the given namespace dictionary. If a unit by the same name is already in the namespace, a ValueError is raised. doc : str, optional A docstring describing the unit. format : dict, optional A mapping to format-specific representations of this unit. For example, for the ``Ohm`` unit, it might be nice to have it displayed as ``\Omega`` by the ``latex`` formatter. In that case, `format` argument should be set to:: {'latex': r'\Omega'} Raises ------ ValueError If any of the given unit names are already in the registry. ValueError If any of the given unit names are not valid Python tokens. cC`stj|t|ttjfrI|g|_|g|_g|_nt|t rt |dksyt dn|dg|dD]}||dkr|^q|_t |jst dn|d|_|d|_nHt |dkrt dn||_|dg|_|d|_|dkrKi}n||_ |dkro|j}ntj|}tj|}||_|j|dS(Niu"st must be string, list or 2-tupleiiumust provide at least one nameu$st list must have at least one entry(RRCRRRR}RHt _short_namest _long_namesRuR$R%R"t_formatt _generate_docttextwraptdedenttfillRSt_inject(RARLtdocRRtn((s1lib/python2.7/site-packages/astropy/units/core.pyRCs8    8        cC`s;|j}t|jdkr/dj|d S|dSdS(u Generate a docstring for the unit if the user didn't supply one. This is only used from the constructor and may be overridden in subclasses. iu {1} ({0})iiN(RxR$R(RARx((s1lib/python2.7/site-packages/astropy/units/core.pyR s cC`s|jj||jS(u} Get a name for this unit that is specific to a particular format. Uses the dictionary passed into the `format` kwarg in the constructor. Parameters ---------- format : str The name of the format Returns ------- name : str The name of the unit for the given format. (R RNRs(RAR((s1lib/python2.7/site-packages/astropy/units/core.pytget_format_namescC`s|jS(uE Returns all of the names associated with this unit. (RH(RA((s1lib/python2.7/site-packages/astropy/units/core.pyRxscC`s |jdS(uO Returns the canonical (short) name associated with this unit. i(RH(RA((s1lib/python2.7/site-packages/astropy/units/core.pyRsscC`s |jdS(u? Returns the alias (long) names for this unit. i(RH(RA((s1lib/python2.7/site-packages/astropy/units/core.pyRyscC`s|jS(uK Returns all of the short names associated with this unit. (R(RA((s1lib/python2.7/site-packages/astropy/units/core.pyt short_names$scC`s|jS(uJ Returns all of the long names associated with this unit. (R (RA((s1lib/python2.7/site-packages/astropy/units/core.pyt long_names+scC`s|dkrdSxL|jD]A}||kr|||krtdj|||qqWx|jD]}|||R?R6R7RRR;RR R ( RARqRrRARzR0Rtb_subtp_subR/R ((RrR@s1lib/python2.7/site-packages/astropy/units/core.pyR9s( " '"2 &cC`st|j|j|jS(u< For compatibility with python copy module. (RR5R6R7(RA((s1lib/python2.7/site-packages/astropy/units/core.pyt__copy__<scC`st|dkr(|jdk r(|jSx_|jD]2}t|t s`t|r2||kr2Pq2q2Wt|dkr||_n|St|j|j|jdt d|}t|dkr||_n|S(NiRqR;( R$R8R"RrRRRRzRtR(RARrRR ((s1lib/python2.7/site-packages/astropy/units/core.pyRqBs!   cC`s.|j}t|jdko-|jdkS(Nig?(RqR$RrRz(RAR((s1lib/python2.7/site-packages/astropy/units/core.pyRUs (RQRRRSRRRRCRpRRTRzRrRtR9RERqR(((s1lib/python2.7/site-packages/astropy/units/core.pyRs 6 uYuyottagyCxDuZuzettagPKDuEuexagNgmCuPupetag4&k CuTuteragmBuGugigageAuMumegag.Aukukilog@@uhuhectogY@udaudekaudecag$@ududecig?ucucentig{Gz?umumilligMbP?uuumicrogư>ununanog& .>upupicog-q=ufufemtogV瞯s"     "      *   4 7 $   2E\y : F !