U e{j#@sdZddlZddlZddlmZddlZddlmZeeZ edde j Z edde j Z ddZd d Zd d Zd dZddZddZdddZddZddZdddZdS)z} Miscellaneous utilities for `astropy.units`. None of the functions in the module are meant for use outside of the package. N)Fraction)finfo?g@cCs*td|}|dk r|d}|ddS)zS Get the first sentence from a string and remove any carriage returns. z .*?\S\.\sNr  )rematchgroupreplace)sxr R/var/www/html/bwave/python/venv/lib/python3.8/site-packages/astropy/units/utils.py_get_first_sentences  rc csddlm}g}t}|D]N\}}t||js4q||jkr@qt||jrb||j j djq| |q|j ddd|D]r}t |j}d}t||jrd|j d dd d }d d d|jD} |||| |j|krdndfVqdS)z Generates the ``(unit, doc, represents, aliases, prefixes)`` tuple used to format the unit summary docs in `generate_unit_summary`. )corercSs |jSN)namelower)r r r r@z$_iter_unit_summary..)keyz:math:`latex`z, css|]}d|dVqdS)z``Nr .0r r r r Gsz%_iter_unit_summary..ZYesZNoN)rrsetitems isinstanceZUnitBaser PrefixUnitaddZ _representsbasesappendsortr__doc__stripZUnitZ to_stringjoinaliases) namespacerZunitsZ has_prefixesrvalunitdoc representsr*r r r_iter_unit_summary#s0      r0cCs<t}|dd}t|D]}||j|q|S)a` 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. z .. list-table:: Available Units :header-rows: 1 :widths: 10 20 20 20 1 * - Unit - Description - Represents - Aliases - SI Prefixes z7 * - ``{}`` - {} - {} - {} - {} )ioStringIOwriter0formatgetvalue)r+ docstringtemplate unit_summaryr r rgenerate_unit_summaryRs  r9c Cstddlm}i}|D](\}}t||r|jjd}|||j<qt}d}t |D]}| |j |qV| S)a Generates table entries for units in a namespace that are just prefixes without the base unit. Note that this is intended to be used *after* `generate_unit_summary` and therefore does not include the table header. Parameters ---------- namespace : dict A namespace containing units that are prefixes but do *not* have the base unit in their namespace. Returns ------- docstring : str A docstring containing a summary table of the units. r)r"rzO * - Prefixes for ``{}`` - {} prefixes - {} - {} - Only ) rr"r r!r/r$rr1r2r0r3r4r5) r+r"Zfaux_namespacenmr-Z base_unitr6r7r8r r r generate_prefixonly_unit_summarys     r;cCslzt|kotknWStk rft|jko>tkno`t|jdko\tknYSXdS)Nr)_JUST_BELOW_UNITY_JUST_ABOVE_UNITY TypeErrorrealimag)valuer r ris_effectively_unitys rBcCst|r dS|jtkr|St|dr,|}|jrt|jt|jkrbt|j|jdr|jSn t|j|jdrtd|jS|S|jSdS)Nrdtyperg) rB __class__floathasattritemr@absr?complex)scaler r rsanitize_scales   rKdc Cs|dks|jtkr|S|\}}||}d\}}|d}}||krt|||kr`tkrnnn t||S||||}}||}||||}}||||}}q<|S)aSFraction very close to x with denominator at most max_denominator. The fraction has to be such that fraction/x is unity to within 4 ulp. If such a fraction does not exist, returns the float number. The algorithm is that of `fractions.Fraction.limit_denominator`, but sped up by not creating a fraction to start with. r)rrr)rDintas_integer_ratior<r=r) pmax_denominatorndaZn0Zd0Zn1Zd1r r rmaybe_simple_fractions     rTcCst|dd}|dkrhz t|}Wn*tk rJt|sDtdnYnXt|}t|trb|S|j}|dkrx|j }n||d@dkrt|}|S)aConvert 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 denominatorNz9Quantities and Units may only be raised to a scalar powerrr) getattrrE Exceptionnpisscalar ValueErrorrTr!rU numerator)rOdenomr r rvalidate_powers&    r]cCsf|jtk o|jtk ot|t}|jtk o:|jtk o:t|t}|rN|sNt|}n|s^|r^t|}||fS)z If either input is a Fraction, convert the other to a Fraction (at least if it does not have a ridiculous denominator). This ensures that any operation involving a Fraction will use rational arithmetic and preserve precision. )rDrMrEr!rrT)rSbZ a_is_fractionZ b_is_fractionr r rresolve_fractionss  r_csjddlmt|tjsDt|sDtfdd|DrD||dS|tjkrTtjn|}tj ||dSdS)NrQuantityc3s|]}t|VqdSr)r!rr`r rr4sz&quantity_asanyarray..)rC) Zquantityrar!rXZndarrayrYanyZinexactZfloat64Z asanyarray)rSrCr r`rquantity_asanyarray.s   rc)rL)N)r'r1r fractionsrnumpyrXrrEZ _float_finfoZepsnegr<epsr=rr0r9r;rBrKrTr]r_rcr r r rs$   /-'  .