σ šίΘ[c@`sΓddlmZmZmZmZddlZddlmZddl m Z ddl m Z m Z ddlmZdd lmZmZdd lmZd gZd Zd e fd„ƒYZdS(i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tdeepcopyi(t NDDataBase(t NDUncertaintytUnknownUncertaintyi(tlog(tUnittQuantity(tMetaDatauNDDatau<`dict`-like : Additional meta information about the dataset.tNDDatacB`sΏeZdZededeƒZd d d d d ed„Zd„Z d„Z e d„ƒZ e d„ƒZ e jd„ƒZ e d „ƒZe d „ƒZe d „ƒZejd „ƒZRS(uΩ A container for `numpy.ndarray`-based datasets, using the `~astropy.nddata.NDDataBase` interface. The key distinction from raw `numpy.ndarray` is the presence of additional metadata such as uncertainty, mask, unit, a coordinate system and/or a dictionary containing further meta information. This class *only* provides a container for *storing* such datasets. For further functionality take a look at the ``See also`` section. Parameters ----------- data : `numpy.ndarray`-like or `NDData`-like The dataset. uncertainty : any type, optional Uncertainty in the dataset. Should have an attribute ``uncertainty_type`` that defines what kind of uncertainty is stored, for example ``"std"`` for standard deviation or ``"var"`` for variance. A metaclass defining such an interface is `NDUncertainty` - but isn't mandatory. If the uncertainty has no such attribute the uncertainty is stored as `UnknownUncertainty`. Defaults to ``None``. mask : any type, optional Mask for the dataset. Masks should follow the ``numpy`` convention that **valid** data points are marked by ``False`` and **invalid** ones with ``True``. Defaults to ``None``. wcs : any type, optional World coordinate system (WCS) for the dataset. Default is ``None``. meta : `dict`-like object, optional Additional meta information about the dataset. If no meta is provided an empty `collections.OrderedDict` is created. Default is ``None``. unit : `~astropy.units.Unit`-like or str, optional Unit for the dataset. Strings that can be converted to a `~astropy.units.Unit` are allowed. Default is ``None``. copy : `bool`, optional Indicates whether to save the arguments as copy. ``True`` copies every attribute before saving it while ``False`` tries to save every parameter as reference. Note however that it is not always possible to save the input as reference. Default is ``False``. .. versionadded:: 1.2 Raises ------ TypeError In case ``data`` or ``meta`` don't meet the restrictions. Notes ----- Each attribute can be accessed through the homonymous instance attribute: ``data`` in a `NDData` object can be accessed through the `data` attribute:: >>> from astropy.nddata import NDData >>> nd = NDData([1,2,3]) >>> nd.data array([1, 2, 3]) Given a conflicting implicit and an explicit parameter during initialization, for example the ``data`` is a `~astropy.units.Quantity` and the unit parameter is not ``None``, then the implicit parameter is replaced (without conversion) by the explicit one and a warning is issued:: >>> import numpy as np >>> import astropy.units as u >>> q = np.array([1,2,3,4]) * u.m >>> nd2 = NDData(q, unit=u.cm) INFO: overwriting Quantity's current unit with specified unit. [astropy.nddata.nddata] >>> nd2.data # doctest: +FLOAT_CMP array([1., 2., 3., 4.]) >>> nd2.unit Unit("cm") See also -------- NDDataRef NDDataArray tdoctcopycC`sKtt|ƒjƒt|tƒr›|dk r\|jdk r\||jkr\tjdƒn|jdk rw|j}n|dk r’|jdk r’tjdƒn|jdk r½|j}n|dk rθ|j dk rθtjdƒn|j dk r|j }n|dk r.|j dk r.tjdƒn|j dk rI|j }n|dk rt|j dk rttjdƒn|j dk r|j }n|j }nžt |dƒrκt |dƒrκ|dk rΥtjdƒn |j }|j }nt|tƒr9|dk r$||jkr$tjd ƒn |j}|j}nt |d ƒ sit |d ƒ sit |d ƒ r‡tj|d tdtƒ}n|jdkr₯tdƒ‚n|dk rΐt|ƒ}n|rt|ƒ}t|ƒ}t|ƒ}t|ƒ}t|ƒ}t|ƒ}n||_||_ ||_||_ ||_||_dS(Nu6overwriting NDData's current unit with specified unit.uDoverwriting NDData's current uncertainty with specified uncertainty.u6overwriting NDData's current mask with specified mask.u4overwriting NDData's current wcs with specified wcs.u6overwriting NDData's current meta with specified meta.umaskudatau>overwriting Masked Objects's current mask with specified mask.u8overwriting Quantity's current unit with specified unit.ushapeu __getitem__u __array__tsubokRuOu&could not convert data to numpy array.(tsuperR t__init__t isinstancetNonetunitRtinfot uncertaintytmasktwcstmetatdatathasattrR tvaluetnptarraytTruetFalsetdtypet TypeErrorR Rt_datat_wcst_unit(tselfRRRRRRR((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyRusl                        cC`s t|jƒS(N(tstrR(R&((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyt__str__θscC`sD|jjd}tj|jddd|ƒ}dj||dgƒS(Nu(t separatoru, tprefixuu)(t __class__t__name__Rt array2stringRtjoin(R&R*tbody((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyt__repr__λscC`s|jS(u= `~numpy.ndarray`-like : The stored dataset. (R#(R&((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyRπscC`s|jS(uΗ any type : Mask for the dataset, if any. Masks should follow the ``numpy`` convention that valid data points are marked by ``False`` and invalid ones with ``True``. (t_mask(R&((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyRχscC`s ||_dS(N(R1(R&R((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyRscC`s|jS(uG `~astropy.units.Unit` : Unit for the dataset, if any. (R%(R&((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyRscC`s|jS(uU any type : A world coordinate system (WCS) for the dataset, if any. (R$(R&((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyR scC`s|jS(uc any type : Uncertainty in the dataset, if any. Should have an attribute ``uncertainty_type`` that defines what kind of uncertainty is stored, such as ``'std'`` for standard deviation or ``'var'`` for variance. A metaclass defining such an interface is `~astropy.nddata.NDUncertainty` but isn't mandatory. (t _uncertainty(R&((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyRs cC`s|dk r‚t|dƒs=tjdƒt|dtƒ}nt|tƒr‚|jdk rs|j |dtƒ}n||_ q‚n||_ dS(Nuuncertainty_typeu3uncertainty should have attribute uncertainty_type.R( RRRRRR RRt_parent_nddataR+t parent_nddataR2(R&R((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyRs  N(R,t __module__t__doc__R t _meta_docR RRRR(R0tpropertyRRtsetterRRR(((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyR sZ r    (t __future__RRRRtnumpyRRRt nddata_baseRt nduncertaintyRRtRtunitsR R tutils.metadataR t__all__R7R (((s4lib/python2.7/site-packages/astropy/nddata/nddata.pyts"