ó šßÈ[c@`sdZddlmZmZmZmZddlZddlZddlZddl m Z ddl Z ddl m Z ddlmZe eƒZedd ejƒZedd ejƒZd „Zd „Zd „Zd „Zd„Zd„Zed„Zd„Zdd„Z dS(u} Miscellaneous utilities for `astropy.units`. None of the functions in the module are meant for use outside of the package. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tFraction(tfinfoi(tsixgð?g@cC`s@tjd|ƒ}|dk r0|jdƒ}n|jddƒS(uS Get the first sentence from a string and remove any carriage returns. u .*?\S\.\siu u N(tretmatchtNonetgrouptreplace(tstx((s2lib/python2.7/site-packages/astropy/units/utils.pyt_get_first_sentences c c`sgddlm}g}tƒ}x†tj|ƒD]u\}}t||jƒsSq/n||jkrhq/nt||jƒr—|j |j j djƒq/|j |ƒq/W|j dd„ƒx¥|D]}t|jƒjƒ}d}t||jƒrdj|j jdƒdd !ƒ}nd jd „|jDƒƒ} |||| |j|krWd nd fVqÂWdS(u‘ Generates the ``(unit, doc, represents, aliases, prefixes)`` tuple used to format the unit summary docs in `generate_unit_summary`. i(tcoreitkeycS`s |jjƒS(N(tnametlower(R ((s2lib/python2.7/site-packages/astropy/units/utils.pytGsuu :math:`{0}`ulatexiÿÿÿÿu, cs`s|]}dj|ƒVqdS(u``{0}``N(tformat(t.0R ((s2lib/python2.7/site-packages/astropy/units/utils.pys OsuYesuNoN(tRtsetRt iteritemst isinstancetUnitBaseRt PrefixUnittaddt _representstbasestappendtsortRt__doc__tstriptUnitRt to_stringtjointaliases( t namespaceRtunitst has_prefixesRtvaltunittdoct representsR&((s2lib/python2.7/site-packages/astropy/units/utils.pyt_iter_unit_summary*s(  cC`sPtjƒ}|jdƒx*t|ƒD]}|jdj|Œƒq&W|jƒS(u` Generates a summary of units from a given namespace. This is used to generate the docstring for the modules that define the actual units. Parameters ---------- namespace : dict A namespace containing units. Returns ------- docstring : str A docstring containing a summary table of the units. u¢ .. list-table:: Available Units :header-rows: 1 :widths: 10 20 20 20 1 * - Unit - Description - Represents - Aliases - SI Prefixes u< * - ``{0}`` - {1} - {2} - {3} - {4} (tiotStringIOtwriteR.Rtgetvalue(R't docstringt unit_summary((s2lib/python2.7/site-packages/astropy/units/utils.pytgenerate_unit_summaryTs  cC`s¥ddlm}i}xI|jƒD];\}}t||ƒr#|jjd}|||jR?tcomplex(tscale((s2lib/python2.7/site-packages/astropy/units/utils.pytsanitize_scale°s  cC`sFt|tjtfƒre|j}|dkr?t|jƒ}qB||d@dkrBt|ƒ}qBnÝyt|ƒ}Wn2tk r©t j |ƒs£t dƒ‚qª‚nX|ddkrÉt|ƒ}ny|dddkrànbx_d D]W}|t|ƒ}|d t j ddt j krçttt|ƒƒ|ƒ}PqçqçW|S( uConvert a power to a floating point value, an integer, or a Fraction. If a fractional power can be represented exactly as a floating point number, convert it to a float, to make the math much faster; otherwise, retain it as a `fractions.Fraction` object to avoid losing precision. Conversely, if the value is indistinguishable from a rational number with a low-numbered denominator, convert to a Fraction object. Parameters ---------- p : float, int, Rational, Fraction Power to be converted iiu9Quantities and Units may only be raised to a scalar powergð?gg @i i iig@(i i ii(RtnumberstRationalRt denominatortintt numeratortfloatt ExceptionRBtisscalart ValueErrort _float_finfotepstround(tptsupport_tuplestdenomtitscaled((s2lib/python2.7/site-packages/astropy/units/utils.pytvalidate_powerÂs.    cC`s`t|tƒ}t|tƒ}|r:| r:t|ƒ}n| rV|rVt|ƒ}n||fS(u» If either input is a Fraction, convert the other to a Fraction. This ensures that any operation involving a Fraction will use rational arithmetic and preserve precision. (RR(tatbt a_is_fractiont b_is_fraction((s2lib/python2.7/site-packages/astropy/units/utils.pytresolve_fractionsøs  c`svddlm‰t|tjƒ r_tj|ƒ r_t‡fd†|Dƒƒr_ˆ|d|ƒStj|d|ƒSdS(Ni(tQuantityc3`s|]}t|ˆƒVqdS(N(R(RR (R_(s2lib/python2.7/site-packages/astropy/units/utils.pys stdtype(tquantityR_RRBtndarrayROtanyt asanyarray(RZR`((R_s2lib/python2.7/site-packages/astropy/units/utils.pytquantity_asanyarrays?(!R!t __future__RRRRRHR/Rt fractionsRtnumpyRBRtexternRRMRQtepsnegR;RRR<RR.R5R:RARGtFalseRYR^R Re(((s2lib/python2.7/site-packages/astropy/units/utils.pyts("      * + '  6