B q\@sdZddlZddlZddlZddlmZddlZddlmZee Z e dde j Z e dde j ZddZd d Zd d Zd dZddZddZdddZddZdddZdS)z} Miscellaneous utilities for `astropy.units`. None of the functions in the module are meant for use outside of the package. N)Fraction)finfog?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 2lib/python3.7/site-packages/astropy/units/utils.py_get_first_sentences  rc csddlm}g}t}xZ|D]N\}}t||js6q ||jkrBq t||jrd||j j djq | |q W|j dddxx|D]p}t |j}d}t||jrd|j d dd }d d d |jD} |||| |j|krdndfVqWdS)z Generates the ``(unit, doc, represents, aliases, prefixes)`` tuple used to format the unit summary docs in `generate_unit_summary`. )corercSs |jS)N)namelower)r r r r Dsz$_iter_unit_summary..)keyz :math:`{0}`Zlatexz, css|]}d|VqdS)z``{0}``N)format).0r r r r Lsz%_iter_unit_summary..ZYesZNoN)rrsetitems isinstanceZUnitBaser PrefixUnitaddZ _representsbasesappendsortr__doc__stripZUnitrZ to_stringjoinaliases) namespacerZunitsZ has_prefixesrvalunitdoc representsr%r r r _iter_unit_summary's(      r+cCs<t}|dx t|D]}|dj|qW|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 z< * - ``{0}`` - {1} - {2} - {3} - {4} )ioStringIOwriter+rgetvalue)r& docstring unit_summaryr r r generate_unit_summaryQs r2cCsxddlm}i}x4|D](\}}t||r|jjd}|||j<qWt}x t |D]}| dj |qXW| 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)rrzS * - Prefixes for ``{0}`` - {1} prefixes - {2} - {3} - Only ) rrrrr*rrr,r-r+r.rr/)r&rZfaux_namespaceZnmr(Z base_unitr0r1r r r generate_prefixonly_unit_summary|s   r3cCsfyt|kotkSStk r`t|jko.)dtype)ZquantityrUrrGZndarrayrHanyZ asanyarray)rRrVr )rUr quantity_asanyarrays , rX)F)N)r"Znumbersr,rZ fractionsrZnumpyrGrr<rKZepsnegr4rLr5rr+r2r3r:r?rQrTrXr r r r s$   *+'  6