[c@`s3dZddlmZmZmZmZddlZddlZddlm Z ddl Z ddl Z ddl mZddlmZdd lmZmZmZmZmZmZdd lmZdd lmZmZdd lmZdd lm Z ddl!m"Z"m#Z#ddl$m%Z%ddl&m'Z(ddl)m*Z*m+Z+m,Z,ddddgZ-dgZ.dZ/e j0e j1e j2e j3hZ4de(j5fdYZ6e6Z7de8fdYZ9de%fdYZ:de:fdYZ;ej<e#d e j=fd!YZ>d"e>fd#YZ?dS($u This module defines the `Quantity` object, which represents a number with some associated units. `Quantity` objects support operations like ordinary numbers, but will deal with unit conversions internally. i(tabsolute_importtunicode_literalstdivisiontprint_functionN(tFractioni(tsix(tzipi(tUnittdimensionless_unscaledtget_current_unit_registrytUnitBaset UnitsErrort UnitTypeError(tLatex(t NUMPY_LT_1_13t NUMPY_LT_1_14(toverride__dir__(tmatmul(t isiterabletInheritDocstrings(tParentDtypeInfo(tconfig(tconverters_and_unittcan_have_arbitrary_unitt check_outputuQuantityuSpecificTypeQuantityuQuantityInfoBaseu QuantityInfou Quantity.*u(Unit not initialised)tConfcB`s eZdZejddZRS(u/ Configuration parameters for Quantity idu&The maximum size an array Quantity can be before its LaTeX representation for IPython gets "summarized" (meaning only the first and last few elements are shown with "..." between). Setting this to a negative number means that the value will instead be whatever numpy gets from get_printoptions.(t__name__t __module__t__doc__t_configt ConfigItemtlatex_array_threshold(((s5lib/python2.7/site-packages/astropy/units/quantity.pyR.s tQuantityIteratorcB`sAeZdZdZdZdZdZdZeZRS(u Flat iterator object to iterate over Quantities A `QuantityIterator` iterator is returned by ``q.flat`` for any Quantity ``q``. It allows iterating over the array as if it were a 1-D array, either in a for-loop or by calling its `next` method. Iteration is done in C-contiguous style, with the last index varying the fastest. The iterator can also be indexed using basic slicing or advanced indexing. See Also -------- Quantity.flatten : Returns a flattened copy of an array. Notes ----- `QuantityIterator` is inspired by `~numpy.ma.core.MaskedIterator`. It is not exported by the `~astropy.units` module. Instead of instantiating a `QuantityIterator` directly, use `Quantity.flat`. cC`s%||_|jtjj|_dS(N(t _quantitytviewtnptndarraytflatt _dataiter(tselftq((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__init__Ts cC`s|S(N((R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__iter__XscC`sB|jj|}t|t|jr.|S|jj|SdS(N(R&t __getitem__t isinstancettypeR!t _new_view(R'tindxtout((s5lib/python2.7/site-packages/astropy/units/quantity.pyR+[scC`s|jj||j|scS`s|j|jS(N(R8R3(R;R9((s5lib/python2.7/site-packages/astropy/units/quantity.pyR<scS`s ||jS(N(R3(R;R9((s5lib/python2.7/site-packages/astropy/units/quantity.pyR<sN((R;((s5lib/python2.7/site-packages/astropy/units/quantity.pyt possible_string_format_functions}s (RRtattrs_from_parenttTruet_supports_indexingt staticmethodR:R=(((s5lib/python2.7/site-packages/astropy/units/quantity.pyR7rs t QuantityInfocB`s,eZdZdZdZdddZRS(u Container for meta information like name, description, format. This is required when the object is used as a mixin column within a table, but can be used as a general way to store meta information. uvalueuunitcC`s|jd}|j||S(Nuvalue(tpopt _parent_cls(R'tmapR3((s5lib/python2.7/site-packages/astropy/units/quantity.pyt_construct_from_dictsuwarnc `s|j||d }|f|jd}|jd}tjd|d|fd|jD}t|d <|j|} x-|jD]\} } t| j | | qW| S( u Return a new Quantity instance which is consistent with the input ``cols`` and has ``length`` rows. This is intended for creating an empty column object whose elements can be set in-place for table operations like join or vstack. Parameters ---------- cols : list List of input columns length : int Length of the output column object metadata_conflicts : str ('warn'|'error'|'silent') How to handle metadata conflicts name : str Output column name Returns ------- col : Quantity (or subclass) Empty instance of this class consistent with ``cols`` umetauformatu descriptionushapeudtypetshapetdtypec`s8i|].}|dkrntd||qS(uvaluei(tgetattr(t.0tkey(tcolstdata(s5lib/python2.7/site-packages/astropy/units/quantity.pys s ucopy(umetauformatu description( tmerge_cols_attributesRCR#tzerost_represent_as_dict_attrstFalseRFtitemstsetattrtinfo( R'RLtlengthtmetadata_conflictstnametattrsRGRHRER0tattrR3((RLRMs5lib/python2.7/site-packages/astropy/units/quantity.pytnew_likes   (uvalueuunitN(RRRRPRFtNoneRZ(((s5lib/python2.7/site-packages/astropy/units/quantity.pyRBs tQuantitycB`seZdZgZeZdlZdZdldle dle ddZ dZ dldZ dldZdZdZd Zdldld Zd Zd Zd ZdZeZgdZgdZdlgdZeeddZedZedZedZ edZ!edZ"e Z#e$dZ%dZ&dZ'dZ(dZ)dZ*dZ+d Z,d!Z-d"Z.d#Z/d$Z0d%Z1e2e3d&sd'Z4nd(Z5e d)Z6d*Z7e8rd+Z9n d,Z9d-Z:d.Z;d/Z<d0Z=e>j?rId1Z@nd2ZAe>j?sdeAZBnd3ZCd4ZDd5ZEd6ZFe>j?rd7ZGned8ZHd9ZId:ZJd;ZKd<ZLgd=ZMe gd>ZNd?ZOd@ZPe dAZQdBZRdCdDZSdEdFdGZTdHZUdIZVdJZWedKZXeXjYdLZXdMdNZZdldMdOZ[dPdQdldRZ\dSZ]dldldTZ^dldldUZ_dVZ`dldWZadddXdldldYZbdldldlddZZcdldldldd[Zddldldld\Zedldld]Zfddld^Zgdldle d_Zhdldle d`Zidldldle daZjdldldle dbZkdldcZldldldlddZmdldldldeZndldldfZodldldgZpdXdPdhZqdldldiZrdldle djZsdldkZtRS(mu A `~astropy.units.Quantity` represents a number with some associated unit. Parameters ---------- value : number, `~numpy.ndarray`, `Quantity` object (sequence), str The numerical value of this quantity in the units given by unit. If a `Quantity` or sequence of them (or any other valid object with a ``unit`` attribute), creates a new `Quantity` object, converting to `unit` units as needed. If a string, it is converted to a number or `Quantity`, depending on whether a unit is present. unit : `~astropy.units.UnitBase` instance, str An object that represents the unit associated with the input value. Must be an `~astropy.units.UnitBase` object or a string parseable by the :mod:`~astropy.units` package. dtype : ~numpy.dtype, optional The dtype of the resulting Numpy array or scalar that will hold the value. If not provided, it is determined from the input, except that any input that cannot represent float (integer and bool) is converted to float. copy : bool, optional If `True` (default), then the value is copied. Otherwise, a copy will only be made if ``__array__`` returns a copy, if value is a nested sequence, or if a copy is needed to satisfy an explicitly given ``dtype``. (The `False` option is intended mostly for internal use, to speed up initialization where a copy is known to have been made. Use with care.) order : {'C', 'F', 'A'}, optional Specify the order of the array. As in `~numpy.array`. This parameter is ignored if the input is a `Quantity` and ``copy=False``. subok : bool, optional If `False` (default), the returned array will be forced to be a `Quantity`. Otherwise, `Quantity` subclasses will be passed through, or a subclass appropriate for the unit will be used (such as `~astropy.units.Dex` for ``u.dex(u.AA)``). ndmin : int, optional Specifies the minimum number of dimensions that the resulting array should have. Ones will be pre-pended to the shape as needed to meet this requirement. This parameter is ignored if the input is a `Quantity` and ``copy=False``. Raises ------ TypeError If the value provided is not a Python numeric type. TypeError If the unit provided is not either a :class:`~astropy.units.Unit` object or a parseable string unit. Notes ----- Quantities can also be created by multiplying a number or array with a :class:`~astropy.units.Unit`. See http://docs.astropy.org/en/latest/units/ i'ic C`sV|dk rNt|}|rNt|d|}t||rK|}qKqNnt|tr2|dk r||jk r|j|}t}nt ||k r|ot|| r|j |}n|dkr|s|St j t j |jst j}qnt j|d|d|d|dtd|Sd} t|t jst|tjrd} tj| |} d} yt| j}Wn,tk rtdj||jnX| j| jj} | rt| } |dkr| }qqqt|rt |d krt!d |Dr|dkrU|d j}ng|D]} | j"|^q\}|} qn| dkr<t|d d} | dkr|dkr|j#}n|} q<yt| } Wn.tk r}td j|j|nX|dkr$| }q<|| k r<t}q<nt j|d|d|d|dtd|}|jj$d kr|jj$dkot|j%|j&d krdnd t'j( rtdn|dkrt j t j |j s|jj$dkr|j)t j}n|j |}|j*| || krE|S|j|SdS(Nu_quantity_classRHtcopytordertsuboktndminuk\s*[+-]?((\d+\.?\d*)|(\.\d+)|([nN][aA][nN])|([iI][nN][fF]([iI][nN][iI][tT][yY]){0,1}))([eE][+-]?\d+)?[.+-]?u=Cannot parse "{0}" as a {1}. It does not start with a number.ics`s|]}t|tVqdS(N(R,R\(RJtv((s5lib/python2.7/site-packages/astropy/units/quantity.pys WsuuniturThe unit attribute {0!r} of the input could not be parsed as an astropy Unit, raising the following exception: {1}uOSUuOu7The value must be a valid Python or Numpy numeric type.((+R[RRIt issubclassR,R\tunitttoRQR-R"R#tcan_casttfloat32RHtfloattarrayR?R$Rt string_typestretmatchtgroupt Exceptiont TypeErrorR8RtstringtendtstripRtlentalltto_valuet _default_unittkindtitemtndimtnumberstNumbertastypet _set_unit(tclsR3RcRHR]R^R_R`tqclst value_unittpatternRat unit_stringR(texc((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__new__s          "           $ %  cC`sk|jdkr@t|dd}|dk r@|j|q@ndt|ddkrg|j|_ndS(Nu_unituinfou__dict__((t_unitR[RIR|RT(R'tobjRc((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__array_finalize__s  c`s|dkr|S|d}|d|j }t|d|\}}|jdkrc||d}n|krt|||td|Dd|}nj||}t|r|krQtfd|DrQ|d|jdkrtdj |j nj d r?j }|_ qQj |_n||_|tkrtj_jjtjd d d d tqn||_|S(Niiu__call__ics`s=|]3}|r.|dddkr.tjntjVqdS(g?gN(R#tfloat16tint8(RJt converter((s5lib/python2.7/site-packages/astropy/units/quantity.pys stfunctionc3`s|]}|kVqdS(N((RJtarg(R'(s5lib/python2.7/site-packages/astropy/units/quantity.pys suvCannot apply multi-output {0} function to quantities with in-place replacement of an input by any but the last output.u C_CONTIGUOUSuignoretmessageuinvalid value encountered intcategory(R[tninRtnoutRttupleR.tanyRnR8RtflagsR]t_resultt _contiguoust _converterst_UFUNCS_FILTER_WARNINGStwarningstcatch_warningst_catch_warningst __enter__tfilterwarningstRuntimeWarningt _result_unit(R'RtcontextRtargst converterst result_unittresult((R's5lib/python2.7/site-packages/astropy/units/quantity.pyt__array_prepare__sB      (          c C`sl|dkr|j|St|dr:|j}|`nd}t|dr+|j}|`t|dr|jj|`nt|dr|j}n%t|dr|j|d <|`n|j t j }|d}|d|j }g}xUt ||D]D\} } | r1|j| | jq|jt| d| qWyt j|} Wnttfk rd}n+X|dkpt j| |jsd}n|d dkr|j|n|d|g7}||} |dkr+|jdkr| |d } n|j| |}q+n|dkrG|j t j S||krd|j||S|SdS( Nu _result_unitu _convertersu_catch_warningsu_resultu _contiguousiiuvaluei((R[R.thasattrRRRt__exit__RRR"R#R$RRtappendR3RIt result_typeRnt ValueErrorReRHRR|( R'RRRRt obj_arrayRRtinputsRRt tmp_dtypeR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__array_wrap__s\                   c O`s t|||\}}|jdd}|dk r|jdkrR|d}nt|||d|}|jdkr|fn||d{sN( RtgetR[RRRRtsuperR\t__array_ufunc__tNotImplementedt_result_as_quantity( R'RtmethodRtkwargsRRcR0t out_arraytarraysR((s5lib/python2.7/site-packages/astropy/units/quantity.pyRVs  %  $c`st|trT|dkr.dt|}ntfdt|||DS|dkr|dkrp|Sj||S|j||S(uTurn result into a quantity with the given unit. If no output is given, it will take a view of the array as a quantity, and set the unit. If output is given, those should be quantity views of the result arrays, and the function will just set the unit. Parameters ---------- result : `~numpy.ndarray` or tuple of `~numpy.ndarray` Array(s) which need to be turned into quantity. unit : `~astropy.units.Unit` or None Unit for the quantities to be returned (or `None` if the result should not be a quantity). Should be tuple if result is a tuple. out : `~astropy.units.Quantity` or None Possible output quantity. Should be `None` or a tuple if result is a tuple. Returns ------- out : `~astropy.units.Quantity` With units set. c3`s-|]#\}}}j|||VqdS(N(R(RJtresult_tunit_tout_(R'(s5lib/python2.7/site-packages/astropy/units/quantity.pys sN(N(R,RR[RrRR.R|(R'RRcR0((R's5lib/python2.7/site-packages/astropy/units/quantity.pyRs    cC`s ttfS(u Overridden by subclasses to change what kind of view is created based on the output unit of an operation. Parameters ---------- unit : UnitBase The unit for which the appropriate class should be returned Returns ------- tuple : - `Quantity` subclass - bool: True is subclasses of the given class are ok (R\R?(R'Rc((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__quantity_subclass__scC`s|dkr!|j}|j}nWt|}t|dt}t||rx|j|\}}|rx|j}qxn|dkr|jt j }nt j |dt }|j|}|j ||j||S(u Create a Quantity view of some array-like input, and set the unit By default, return a view of ``obj`` of the same class as ``self`` and with the same unit. Subclasses can override the type of class for a given unit using ``__quantity_subclass__``, and can ensure properties other than the unit are copied using ``__array_finalize__``. If the given unit defines a ``_quantity_class`` of which ``self`` is not an instance, a view using this class is taken. Parameters ---------- obj : ndarray or scalar, optional The array to create a view of. If obj is a numpy or python scalar, it will be converted to an array scalar. By default, ``self`` is converted. unit : `UnitBase`, or anything convertible to a :class:`~astropy.units.Unit`, optional The unit of the resulting object. It is used to select a subclass, and explicitly assigned to the view if given. If not given, the subclass and unit will be that of ``self``. Returns ------- view : Quantity subclass u_quantity_classR]N(R[Rct __class__RRIR\R,RR"R#R$RhRQR|R(R'RRctquantity_subclassR_R"((s5lib/python2.7/site-packages/astropy/units/quantity.pyR.s        cC`sst|tsftt|dd}t|tsftdjt|jtt|qfn||_dS(uSet the unit. This is used anywhere the unit is set or modified, i.e., in the initilizer, in ``__imul__`` and ``__itruediv__`` for in-place multiplication and division by another unit, as well as in ``__array_finalize__`` for wrapping up views. For Quantity, it just sets the unit, but subclasses can override it to check that, e.g., a unit is consistent. t parse_strictusilentu3{0} instances require {1} units, not {2} instances.N( R,R RtstrR R8R-RR(R'Rc((s5lib/python2.7/site-packages/astropy/units/quantity.pyR|s 'cC`s |jS(N(R](R'tmemo((s5lib/python2.7/site-packages/astropy/units/quantity.pyt __deepcopy__scC`s<ttt|j}|d|jf|dIn-place multiplication between `Quantity` objects and others.( R,R RRiR|RcRR\t__imul__(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyR scC`s |j|S(uT Right Multiplication between `Quantity` objects and other objects. (R(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__rmul__scC`sgt|ttjfrQy!|j|j|j|SWqQtk rMtSXnt t |j |S(u7 Division between `Quantity` objects and other objects.( R,R RRiR.R]RcR RRR\t __truediv__(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyRs ! cC`sFt|ttjfr0|j|j||Stt|j|S(u>Inplace division between `Quantity` objects and other objects.( R,R RRiR|RcRR\t __itruediv__(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyR%scC`sLt|ttjfr6|jd|j||jStt|j |S(u= Right Division between `Quantity` objects and other objects.g?( R,R RRiR.R3RcRR\t __rtruediv__(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyR.scC`s |j|S(u& Division between `Quantity` objects. (R(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__div__6scC`s |j|S(u& Division between `Quantity` objects. (R(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__idiv__:scC`s |j|S(u& Division between `Quantity` objects. (R(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__rdiv__>sudivmodcC`sH|j|}t|j|}|j|dt|j|dfS(Nii(R1tdivmodR3R.R(R'Rt other_valuet result_tuple((s5lib/python2.7/site-packages/astropy/units/quantity.pyt __divmod__DscC`sIt|tr3|j|jt||j|Stt|j|S(N( R,RR.R3RgRcRR\t__pow__(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyRKscC`sG|jt|dt}t|jt|d|}|j||S(Nuunituvalue(RcRIRRR3R.(R'RtreverseRt result_array((s5lib/python2.7/site-packages/astropy/units/quantity.pyt __matmul__TscC`sG|jt|dt}tt|d||j}|j||S(Nuunituvalue(RcRIRRR3R.(R'RRR((s5lib/python2.7/site-packages/astropy/units/quantity.pyt __rmatmul__YscC`s |jS(uPlus the quantity.(R](R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__pos__ascC`s tj|S(uPlus the quantity.(R#tpositive(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyRjscC`st|jt|jAS(N(thashR3Rc(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__hash__osc`s@jr*tdjdjjnfd}|S(Nu2'{cls}' object with a scalar value is not iterableR}c3`s&xjD]}j|Vq WdS(N(R3R.(R9(R'(s5lib/python2.7/site-packages/astropy/units/quantity.pyt quantity_iterys(RRnR8RR(R'R((R's5lib/python2.7/site-packages/astropy/units/quantity.pyR*rs   cC`sytt|j|}Wn>tk r\|jrVtdjd|jjq]nXt |t |k r|j |}n|S(Nu<'{cls}' object with a scalar value does not support indexingR}( RR\R+t IndexErrorRRnR8RRR-R.(R'RKR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyR+s   cC`sa|j r8d|jkr8|jj||t|n|jtjj||j |dS(Nuinfo( RRRTtadjust_indicesRrR"R#R$R4R1(R'tiR3((s5lib/python2.7/site-packages/astropy/units/quantity.pyR4scC`s|jt|||dS(N(R4tslice(R'RtjR3((s5lib/python2.7/site-packages/astropy/units/quantity.pyt __setslice__scC`stS(uwQuantities should always be treated as non-False; there is too much potential for ambiguity otherwise. (R?(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt __nonzero__scC`s;|jr*tdjd|jjn t|jSdS(Nu/'{cls}' object with a scalar value has no len()R}(RRnR8RRRrR3(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__len__s  cC`sAyt|jtSWn#ttfk r<tdnXdS(NuGonly dimensionless scalar quantities can be converted to Python scalars(RgRtRR Rn(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt __float__scC`sAyt|jtSWn#ttfk r<tdnXdS(NuGonly dimensionless scalar quantities can be converted to Python scalars(tintRtRR Rn(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__int__scC`sJy&|jjst|jjSWntk rEtdnXdS(NuOonly integer dimensionless scalar quantities can be converted to a Python index(Rctis_unitytAssertionErrorR3t __index__RmRn(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyR s  cC`sAyt|jtSWn#ttfk r<tdnXdS(NuGonly dimensionless scalar quantities can be converted to Python scalars(tlongRtRR Rn(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__long__scC`s>|jdkrt}nt|j}|r:d|}n|S(Nu (RcR[t_UNIT_NOT_INITIALISEDR(R'tunitstr((s5lib/python2.7/site-packages/astropy/units/quantity.pyt_unitstrs   cC`sdj|j|jS(Nu{0}{1:s}(R8R3R(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__str__scC`scd|jjd}tr dnd}tj|jtjd|d|}dj|||jS(Nu( RRRR#t array2stringR"R$R8R(R't prefixstrtseptarrstr((s5lib/python2.7/site-packages/astropy/units/quantity.pyt__repr__s  c`sCtj}dj|dfd}zi|d6}tjdkritjdtjd|ntrtj|jtj d|j j d kr|nt d tj d d }n*tj|jtj d tj d d }|jd d}Wdtj|X|jdk r-|jjdd!nt}dj||S(uV Generate a latex representation of the quantity and its unit. The behavior of this function can be altered via the `numpy.set_printoptions` function and its various keywords. The exception to this is the ``threshold`` keyword, which is controlled via the ``[units.quantity]`` configuration item ``latex_array_threshold``. This is treated separately because the numpy default of 1000 is too big for most browsers to handle. Returns ------- lstr A LaTeX string with the contents of this Quantity u.{}gu precisionc`stj|dS(Nt format_spec(R tformat_exponential_notation(R3(R(s5lib/python2.7/site-packages/astropy/units/quantity.pytfloat_formatters u float_kindit thresholdt formattertstyleuftmax_line_widthRu,~u...u\dotsNiu ${0} \; {1}$(R#tget_printoptionsR8tconfRtset_printoptionsRRR"R$RHRvtreprtinftreplaceRcR[t _repr_latex_R(R'tpopsRRt latex_valuet latex_unit((Rs5lib/python2.7/site-packages/astropy/units/quantity.pyR&s,   %cC`s[yt|j|}d}Wn tk r>|j}|}nXtdj||j|S(uF Format quantities using the new-style python formatting codes as specifiers for the number. If the format specifier correctly applies itself to the value, then it is used to format only the value. If it cannot be applied to the value, then it is applied to the whole string. usu{0}{1:s}(R8R3RR(R'RR3tfull_format_spec((s5lib/python2.7/site-packages/astropy/units/quantity.pyt __format__s     cC`s|jtd|S(u Generates a new `Quantity` with the units decomposed. Decomposed units have only irreducible units in them (see `astropy.units.UnitBase.decompose`). 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 `~astropy.units.UnitsError` if it's not possible to do so. Returns ------- newq : `~astropy.units.Quantity` A new object equal to this quantity with units decomposed. tbases(t _decomposeRQ(R'R,((s5lib/python2.7/site-packages/astropy/units/quantity.pyt decompose3scC`sr|jjd|}| rXt|drX|j|j}||j}|j||S|j|j|SdS(u Generates a new `Quantity` with the units decomposed. Decomposed units have only irreducible units in them (see `astropy.units.UnitBase.decompose`). Parameters ---------- allowscaledunits : bool If True, the resulting `Quantity` may have a scale factor associated with it. If False, any scaling in the unit will be subsumed into the value of the resulting `Quantity` 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 `~astropy.units.UnitsError` if it's not possible to do so. Returns ------- newq : `~astropy.units.Quantity` A new object equal to this quantity with units decomposed. R,uscaleN(RcR.RR3RR.R](R'tallowscaledunitsR,tnew_unitt new_value((s5lib/python2.7/site-packages/astropy/units/quantity.pyR-Is  cG`s|jtt|j|S(N(R.RR\Rw(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyRwsscC`stddS(NuIcannot make a list of Quantities. Get list of values with q.value.list()(tNotImplementedError(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyttolistvscC`s!y|j|j}Wnntk ryt|j|j}Wqtk r}t|d ryt|ry|}q|qXnX|rt|dd}|j |krt j ||j }t j |d|dt }t j t j||kt j|stdqqn|S(NuunitudtypeRHR]u>cannot convert value type to array type without precision loss(RtRcRR\R RRRIR[RHR#RhRQRst logical_ortisnanRn(R'R3tcheck_precisiont_valueRt value_dtypetself_dtype_arraytvalue_dtype_array((s5lib/python2.7/site-packages/astropy/units/quantity.pyR1zs*    cG`sVt|dkr!tdn|jtjj|d |j|dfdS(Niu'itemset must have at least one argumenti(RrRR"R#R$titemsetR1(R'R((s5lib/python2.7/site-packages/astropy/units/quantity.pyR;suCcC`stddS(NuKcannot write Quantities to string. Write array with q.value.tostring(...).(R2(R'R^((s5lib/python2.7/site-packages/astropy/units/quantity.pyttostringsuu%scC`stddS(NuFcannot write Quantities to file. Write array with q.value.tofile(...)(R2(R'tfidRR8((s5lib/python2.7/site-packages/astropy/units/quantity.pyttofilescC`stddS(Nu@cannot dump Quantities to file. Write array with q.value.dump()(R2(R'tfile((s5lib/python2.7/site-packages/astropy/units/quantity.pytdumpscC`stddS(NuCcannot dump Quantities to string. Write array with q.value.dumps()(R2(R'((s5lib/python2.7/site-packages/astropy/units/quantity.pytdumpsscC`s&|jtjj|j|dS(N(R"R#R$tfillR1(R'R3((s5lib/python2.7/site-packages/astropy/units/quantity.pyRBscC`s t|S(u(A 1-D iterator over the Quantity array. This returns a ``QuantityIterator`` instance, which behaves the same as the `~numpy.flatiter` instance returned by `~numpy.ndarray.flat`, and is similar to, but not a subclass of, Python's built-in iterator object. (R (R'((s5lib/python2.7/site-packages/astropy/units/quantity.pyR%s cC`s|j}||(dS(N(travel(R'R3ty((s5lib/python2.7/site-packages/astropy/units/quantity.pyR%s uraisecC`s,|jtjj||j||dS(N(R"R#R$tputR1(R'tindicestvaluestmode((s5lib/python2.7/site-packages/astropy/units/quantity.pyREscC`stddS(NuMcannot choose based on quantity. Choose using array with q.value.choose(...)(R2(R'tchoicesR0RH((s5lib/python2.7/site-packages/astropy/units/quantity.pytchoosesiu quicksortcC`s(|jtjjd|d|d|S(NtaxisRvR^(R"R#R$targsort(R'RKRvR^((s5lib/python2.7/site-packages/astropy/units/quantity.pyRLscO`s.tjtj||j|dt||S(NR6(R#t searchsortedRhR1RQ(R'RaRR((s5lib/python2.7/site-packages/astropy/units/quantity.pyRMscC`s|jtjj|d|S(NR0(R"R#R$targmax(R'RKR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyRNscC`s|jtjj|d|S(NR0(R"R#R$targmin(R'RKR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyROscO`s|jd|j}|jdd}|jftd|D}|dk rtd|D}t|||d||dscs`s'|]}t|tjr|VqdS(N(R,R#R$(RJR((s5lib/python2.7/site-packages/astropy/units/quantity.pys sRN(RCRcR[R3RRR(R'RRRRcR0RR((s5lib/python2.7/site-packages/astropy/units/quantity.pyt_wrap_functions cC`s.|jtj|j||j|d|S(NR0(RPR#tclipR1(R'ta_minta_maxR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyRQsicC`s"|jtj||||d|S(NR0(RPR#ttrace(R'toffsettaxis1taxis2RHR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyRTsc C`s/|jtj||d|d|d|jdS(NR0tddofRci(RPR#tvarRc(R'RKRHR0RX((s5lib/python2.7/site-packages/astropy/units/quantity.pyRYscC`s"|jtj||d|d|S(NR0RX(RPR#tstd(R'RKRHR0RX((s5lib/python2.7/site-packages/astropy/units/quantity.pyRZscC`s|jtj||d|S(NR0(RPR#tmean(R'RKRHR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyR[!scC`s|jtj|d|S(NR0(RPR#tptp(R'RKR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyR\$scC`s|jtj|d|S(NR0(RPR#tround(R'tdecimalsR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyR]'scC`s|jtj|d|d|S(NR0tkeepdims(RPR#tmax(R'RKR0R_((s5lib/python2.7/site-packages/astropy/units/quantity.pyR`*scC`s|jtj|d|d|S(NR0R_(RPR#tmin(R'RKR0R_((s5lib/python2.7/site-packages/astropy/units/quantity.pyRa-scC`s"|jtj||d|d|S(NR0R_(RPR#tsum(R'RKRHR0R_((s5lib/python2.7/site-packages/astropy/units/quantity.pyRb0scC`s@|jjstdn|jtj||d|d|S(Nu>cannot use prod on scaled or non-dimensionless Quantity arraysR0R_(RcR RRPR#tprod(R'RKRHR0R_((s5lib/python2.7/site-packages/astropy/units/quantity.pyRc4scC`s8|jt|dt}|jtj|d|d|S(NuunitR0Rc(RcRIRRPR#tdot(R'tbR0R((s5lib/python2.7/site-packages/astropy/units/quantity.pyRd;scC`s|jtj||d|S(NR0(RPR#tcumsum(R'RKRHR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyRf?scC`s:|jjstdn|jtj||d|S(NuAcannot use cumprod on scaled or non-dimensionless Quantity arraysR0(RcR RRPR#tcumprod(R'RKRHR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyRgBscC`stddS(NuOcannot evaluate truth value of quantities. Evaluate array with q.value.all(...)(R2(R'RKR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyRsJscC`stddS(NuOcannot evaluate truth value of quantities. Evaluate array with q.value.any(...)(R2(R'RKR0((s5lib/python2.7/site-packages/astropy/units/quantity.pyRNscC`s|jtj||S(N(RPR#tdiff(R'tnRK((s5lib/python2.7/site-packages/astropy/units/quantity.pyRhTscC`s|jtj||S(N(RPR#tediff1d(R'tto_endtto_begin((s5lib/python2.7/site-packages/astropy/units/quantity.pyRjWscC`s|jtj|d|d|S(NR0R_(RPR#tnansum(R'RKR0R_((s5lib/python2.7/site-packages/astropy/units/quantity.pyRmZscC`s1tj|j||j||}|j|S(uB Insert values along the given axis before the given indices and return a new `~astropy.units.Quantity` object. This is a thin wrapper around the `numpy.insert` function. Parameters ---------- obj : int, slice or sequence of ints Object that defines the index or indices before which ``values`` is inserted. values : array-like Values to insert. If the type of ``values`` is different from that of quantity, ``values`` is converted to the matching type. ``values`` should be shaped so that it can be broadcast appropriately The unit of ``values`` must be consistent with this quantity. axis : int, optional Axis along which to insert ``values``. If ``axis`` is None then the quantity array is flattened before insertion. Returns ------- out : `~astropy.units.Quantity` A copy of quantity with ``values`` inserted. Note that the insertion does not occur in-place: a new quantity array is returned. Examples -------- >>> import astropy.units as u >>> q = [1, 2] * u.m >>> q.insert(0, 50 * u.cm) >>> q = [[1, 2], [3, 4]] * u.m >>> q.insert(1, [10, 20] * u.m, axis=0) >>> q.insert(1, 10 * u.m, axis=1) (R#tinsertR3R1R.(R'RRGRKR((s5lib/python2.7/site-packages/astropy/units/quantity.pyRn^s-$N(uRRRRRRuR[Rt__array_priority__R?RQRRRRRRRR.R|RRRRBRTRRdRttpropertyR3RcRRRRRRRRRRRRRRRRRRRRR#RRRRRRRR*R+R4RtPY2RRt__bool__RRRR R RRRR&R+R.R-RwR3R1R;R<R>R@RARBR%tsetterRERJRLRMRNRORPRQRTRYRZR[R\R]R`RaRbRcRdRfRgRsRRhRjRmRn(((s5lib/python2.7/site-packages/astropy/units/quantity.pyR\s= w  b X 6 ( 9       #       "                          8  *            ,  tSpecificTypeQuantitycB`s?eZdZdZdZdZejdZdZ dZ RS(uSuperclass for Quantities of specific physical type. Subclasses of these work just like :class:`~astropy.units.Quantity`, except that they are for specific physical types (and may have methods that are only appropriate for that type). Astropy examples are :class:`~astropy.coordinates.Angle` and :class:`~astropy.coordinates.Distance` At a minimum, subclasses should set ``_equivalent_unit`` to the unit associated with the physical type. i cC`sF|j|jr"t|tfStt|j|dtfSdS(Ni(t is_equivalentt_equivalent_unitR-R?RRtRRQ(R'Rc((s5lib/python2.7/site-packages/astropy/units/quantity.pyRscC`s|dks|j|j retdjt|j|j|dkrOdn dj|ntt|j |dS(Nu/{0} instances require units equivalent to '{1}'u, but no unit was given.u, so cannot set it to '{0}'.( R[RuRvR R8R-RRRtR|(R'Rc((s5lib/python2.7/site-packages/astropy/units/quantity.pyR|sN( RRRR[RvRRuR\RoRR|(((s5lib/python2.7/site-packages/astropy/units/quantity.pyRts   (@Rt __future__RRRRRjRyt fractionsRRtnumpyR#texternRtextern.six.movesRtcoreRRR R R R t format.latexR t utils.compatRRtutils.compat.miscRtutils.compat.numpyRt utils.miscRRtutils.data_infoRtRRtquantity_helperRRRt__all__t__doctest_skip__RtarcsintarccostarccoshtarctanhRtConfigNamespaceRR!tobjectR R7RBt add_metaclassR$R\Rt(((s5lib/python2.7/site-packages/astropy/units/quantity.pytsF"    .   5?