[c@`sdZddlmZmZmZmZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlmZddlmZmZddlmZddlmZmZmZd d d d d ddddddddddddgZdZdddZde fdYZ!ejd Z"d!Z#d"e fd#YZ$de&dd$Z'd%Z(e j)d&krddl*Z*d'Z+n d(Z+d)Z,de-d*Z.d+e j/fd,YZ0d-Z1d.d/dd0Z2d1e3fd2YZ4ej5ej6d3e fd4YZ7d5e3fd6YZ8ej9Z:ed7Z;ej5ej6d8e fd9YZ<d:e=fd;YZ>d<Z?d=Z@dS(>uo A "grab bag" of relatively small general-purpose utilities that don't have a clear module/package to live in. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tcontextmanager(t defaultdictt OrderedDicti(tsix(turllibtranget zip_longestu isiterableusilenceuformat_exceptionuNumpyRNGContextu find_api_pageuis_path_hiddenuwalk_skip_hiddenuJsonCustomEncoderuindentuInheritDocstringsuOrderedDescriptoruOrderedDescriptorContaineru set_localeuShapedLikeNDArrayucheck_broadcastuIncompatibleShapeErrorudtype_bytes_or_charscC`s+yt|tSWntk r&tSXdS(u/Returns `True` if the given object is iterable.N(titertTruet TypeErrortFalse(tobj((s1lib/python2.7/site-packages/astropy/utils/misc.pyt isiterable)s   iic`sIdjfd|jD}|ddkrE|d7}n|S(uAIndent a block of text. The indentation is applied to each line.u c3`s-|]#}|r!d|ndVqdS(u uN((t.0tl(tshifttwidth(s1lib/python2.7/site-packages/astropy/utils/misc.pys 6si(tjoint splitlines(tsRRtindented((RRs1lib/python2.7/site-packages/astropy/utils/misc.pytindent3s  t _DummyFilecB`seZdZdZRS(uA noop writeable object.cC`sdS(N((tselfR((s1lib/python2.7/site-packages/astropy/utils/misc.pytwriteAs(t__name__t __module__t__doc__R(((s1lib/python2.7/site-packages/astropy/utils/misc.pyR>scc`sEtj}tj}tt_tt_dV|t_|t_dS(u:A context manager that silences sys.stdout and sys.stderr.N(tsyststdouttstderrR(t old_stdoutt old_stderr((s1lib/python2.7/site-packages/astropy/utils/misc.pytsilenceEs     c O`stjtjddd}t|dkrJ|d\}}}}nd}}}}|jd|d|d|d |||S( u Given an exception message string, uses new-style formatting arguments ``{filename}``, ``{lineno}``, ``{func}`` and/or ``{text}`` to fill in information about the exception that occurred. For example: try: 1/0 except: raise ZeroDivisionError( format_except('A divide by zero occurred in {filename} at ' 'line {lineno} of function {func}.')) Any additional positional or keyword arguments passed to this function are also used to format the message. .. note:: This uses `sys.exc_info` to gather up the information needed to fill in the formatting arguments. Python 2.x and 3.x have slightly different behavior regarding `sys.exc_info` (the latter will not carry it outside a handled exception), so it's not wise to use this outside of an ``except`` clause - if it is, this will substitute '' for the 4 formatting arguments. itlimitiiu tfilenametlinenotfuncttext(t tracebackt extract_tbR texc_infotlentformat(tmsgtargstkwargsttbR'R(R)R*((s1lib/python2.7/site-packages/astropy/utils/misc.pytformat_exceptionRs tNumpyRNGContextcB`s)eZdZdZdZdZRS(u A context manager (for use with the ``with`` statement) that will seed the numpy random number generator (RNG) to a specific value, and then restore the RNG state back to whatever it was before. This is primarily intended for use in the astropy testing suit, but it may be useful in ensuring reproducibility of Monte Carlo simulations in a science context. Parameters ---------- seed : int The value to use to seed the numpy RNG Examples -------- A typical use case might be:: with NumpyRNGContext(): from numpy import random randarr = random.randn(100) ... run your test using `randarr` ... #Any code using numpy.random at this indent level will act just as it #would have if it had been before the with statement - e.g. whatever #the default seed is. cC`s ||_dS(N(tseed(RR6((s1lib/python2.7/site-packages/astropy/utils/misc.pyt__init__scC`s3ddlm}|j|_|j|jdS(Ni(trandom(tnumpyR8t get_statet startstateR6(RR8((s1lib/python2.7/site-packages/astropy/utils/misc.pyt __enter__scC`s$ddlm}|j|jdS(Ni(R8(R9R8t set_stateR;(Rtexc_typet exc_valueR+R8((s1lib/python2.7/site-packages/astropy/utils/misc.pyt__exit__s(RRRR7R<R@(((s1lib/python2.7/site-packages/astropy/utils/misc.pyR5us  cC`sddl}ddlm}t|tj rdt|drdt|drd|jd|j}nt j |r|j}n|dkrddl m }|jrd |j }qd }nd |kr |jd r|d }q=|jdr|}q=|d}n3|d ks"|dkr+d}ndjd|}|dkrbtjj|d}ntjj|dd|}z|j}d} g} xQtdD]C} | } |jd| d} | j|| d| !jdqW| \} }}}d|kr'tdj|dn|| d}Wd|jX||jd}d}xt|jjD]`}|j}|d}|d}|jdr|d |}n||krr||}PqrqrW|dkrtdjd|n|r|j|n|S( u Determines the URL of the API page for the specified object, and optionally open that page in a web browser. .. note:: You must be connected to the internet for this to function even if ``openinbrowser`` is `False`, unless you provide a local version of the documentation to ``version`` (e.g., ``file:///path/to/docs``). Parameters ---------- obj The object to open the docs for or its fully-qualified name (as a str). version : str The doc version - either a version number like '0.1', 'dev' for the development/latest docs, or a URL to point to a specific location that should be the *base* of the documentation. Defaults to latest if you are on aren't on a release, otherwise, the version you are on. openinbrowser : bool If `True`, the `webbrowser` package will be used to open the doc page in a new web browser window. timeout : number, optional The number of seconds to wait before timing-out the query to the astropy documentation. If not given, the default python stdlib timeout will be used. Returns ------- url : str The loaded URL Raises ------ ValueError If the documentation can't be found iN(t decompressu __module__u__name__u.i(tversionuvudevu://u index.htmliu/ulatestuhttp://devdocs.astropy.org/u"http://docs.astropy.org/en/{vers}/tversu objects.invttimeoutiis iuutf-8u3The remainder of this file is compressed using zlibukThe file downloaded from {0} does not seem to bethe usual Sphinx objects.inv format. Maybe it has changed?iu$u,Could not find the docs for the object {obj}R(t webbrowsertzlibRAt isinstanceRt string_typesthasattrRRtinspecttismoduletNonetRBtreleasetendswithR/RtrequestturlopentreadR tindextappendtdecodet ValueErrortclosetstripRtsplittopen(RRBt openinbrowserRDRERAtbaseurltuftoireadtidxt headerlinest_toldidxtiverstprojRCtcomprt compressedt decompressedtresurlRtlstnametloc((s1lib/python2.7/site-packages/astropy/utils/misc.pyt find_api_pagesn(            %         cC`s2tdtjtjD}|j|dS(ux Given an OS signal number, returns a signal name. If the signal number is unknown, returns ``'UNKNOWN'``. cs`s0|]&\}}|jdr||fVqdS(uSIGN(t startswith(Rtvtk((s1lib/python2.7/site-packages/astropy/utils/misc.pys &s uUNKNOWN(tdictRt iteritemstsignalt__dict__tget(tsignumtsignal_to_name_map((s1lib/python2.7/site-packages/astropy/utils/misc.pytsignal_number_to_names"uwin32cC`szt|tr'|jtj}ny5tjjj|}t |d@oX|dk}Wnt k rut }nX|S(u Returns True if the given filepath has the hidden attribute on MS-Windows. Based on a post here: http://stackoverflow.com/questions/284115/cross-platform-hidden-file-detection ii( RGtbytesRUR tgetfilesystemencodingtctypestwindlltkernel32tGetFileAttributesWtbooltAttributeErrorR(tfilepathtattrstresult((s1lib/python2.7/site-packages/astropy/utils/misc.pyt_has_hidden_attribute/s   cC`stS(N(R(R((s1lib/python2.7/site-packages/astropy/utils/misc.pyR>scC`s^tjjtjj|}t|tr?|jd}n|jd}|p]t|S(u Determines if a given file or directory is hidden. Parameters ---------- filepath : str The path to a file or directory Returns ------- hidden : bool Returns `True` if the file is hidden t.u.(tostpathtbasenametabspathRGRxRmR(RRjt is_dotted((s1lib/python2.7/site-packages/astropy/utils/misc.pytis_path_hiddenBs cc`sxtj|dtd|d|D]i\}}}g|D]}t|s8|^q8|(g|D]}t|s^|^q^|(|||fVq"WdS(u5 A wrapper for `os.walk` that skips hidden files and directories. This function does not have the parameter ``topdown`` from `os.walk`: the directories must always be recursed top-down when using this function. See also -------- os.walk : For a description of the parameters ttopdowntonerrort followlinksN(RtwalkR R(ttopRRtroottdirstfilestdtf((s1lib/python2.7/site-packages/astropy/utils/misc.pytwalk_skip_hiddenXs &&tJsonCustomEncodercB`seZdZdZRS(uSupport for data types that JSON default encoder does not do. This includes: * Numpy array or number * Complex number * Set * Bytes (Python 3) Examples -------- >>> import json >>> import numpy as np >>> from astropy.utils.misc import JsonCustomEncoder >>> json.dumps(np.arange(3), cls=JsonCustomEncoder) '[0, 1, 2]' cC`sddl}t||j|jfr1|jSt|t|jfrY|j|jgSt|trrt |St|t r|j St j j||S(Ni(R9RGtndarraytnumberttolisttcomplextrealtimagtsettlistRxRUtjsont JSONEncodertdefault(RRtnp((s1lib/python2.7/site-packages/astropy/utils/misc.pyRs    (RRRR(((s1lib/python2.7/site-packages/astropy/utils/misc.pyRnscC`s#djdtjd|DS(uv Remove accents from a Unicode string. This helps with matching "ångström" to "angstrom", for example. ucs`s*|] }tj|dkr|VqdS(uMnN(t unicodedatatcategory(Rtc((s1lib/python2.7/site-packages/astropy/utils/misc.pys suNFD(RRt normalize(R((s1lib/python2.7/site-packages/astropy/utils/misc.pyt strip_accentssig?c C`st|tjr!t|}n|j}i}x;|D]3}|j}|j|g||j|q:W|jdr|d |kr|d g} ntj ||d|d|} t | rt } x| D]} | j || qW| } |d k r:g} x!| D]} | j|| qW| } ntt | } t| } t | dkrw| d} ndj| d d| d} d j| Sd S( u When a string isn't found in a set of candidates, we can be nice to provide a list of alternatives in the exception. This convenience function helps to format that part of the exception. Parameters ---------- s : str candidates : sequence of str or dict of str keys n : int The maximum number of results to include. See `difflib.get_close_matches`. cutoff : float In the range [0, 1]. Possibilities that don't score at least that similar to word are ignored. See `difflib.get_close_matches`. fix : callable A callable to modify the results after matching. It should take a single string and return a sequence of strings containing the fixed matches. Returns ------- message : str Returns the string "Did you mean X, Y, or Z?", or the empty string if no alternatives were found. usitntcutoffiiu, u or uDid you mean {0}?uN(RGRt text_typeRtlowert setdefaultRTROtdifflibtget_close_matchesR.RtupdateRLtextendRtsortedRR/( Rt candidatesRRtfixts_lowertcandidates_lowert candidatetcandidate_lowertmatchestcapitalized_matchestmatchtmapped_matches((s1lib/python2.7/site-packages/astropy/utils/misc.pyt did_you_means<              tInheritDocstringscB`seZdZdZRS(u This metaclass makes methods of a class automatically have their docstrings filled in from the methods they override in the base class. If the class uses multiple inheritance, the docstring will be chosen from the first class in the bases list, in the same way as methods are normally resolved in Python. If this results in selecting the wrong docstring, the docstring will need to be explicitly included on the method. For example:: >>> from astropy.utils.misc import InheritDocstrings >>> from astropy.extern import six >>> @six.add_metaclass(InheritDocstrings) ... class A(object): ... def wiggle(self): ... "Wiggle the thingamajig" ... pass >>> class B(A): ... def wiggle(self): ... pass >>> B.wiggle.__doc__ u'Wiggle the thingamajig' c C`sd}xtj|D]\}}tj|r||r|jdkrxF|jdD]4}t||d}|dk r]|j|_Pq]q]WqqWtt |j |||dS(NcS`s>|jdr0|jdr0t|dkp=|jd S(Nu__iu_(RmROR.(tkey((s1lib/python2.7/site-packages/astropy/utils/misc.pytis_public_membersi( RRqRJt isfunctionRRLt__mro__tgetattrtsuperRR7( tclsRjtbasestdctRRtvaltbaset super_method((s1lib/python2.7/site-packages/astropy/utils/misc.pyR7s    (RRRR7(((s1lib/python2.7/site-packages/astropy/utils/misc.pyRstOrderedDescriptorcB`s8eZdZdZejZdZdZ dZ RS(u Base class for descriptors whose order in the class body should be preserved. Intended for use in concert with the `OrderedDescriptorContainer` metaclass. Subclasses of `OrderedDescriptor` must define a value for a class attribute called ``_class_attribute_``. This is the name of a class attribute on the *container* class for these descriptors, which will be set to an `~collections.OrderedDict` at class creation time. This `~collections.OrderedDict` will contain a mapping of all class attributes that were assigned instances of the `OrderedDescriptor` subclass, to the instances themselves. See the documentation for `OrderedDescriptorContainer` for a concrete example. Optionally, subclasses of `OrderedDescriptor` may define a value for a class attribute called ``_name_attribute_``. This should be the name of an attribute on instances of the subclass. When specified, during creation of a class containing these descriptors, the name attribute on each instance will be set to the name of the class attribute it was assigned to on the class. .. note:: Although this class is intended for use with *descriptors* (i.e. classes that define any of the ``__get__``, ``__set__``, or ``__delete__`` magic methods), this base class is not itself a descriptor, and technically this could be used for classes that are not descriptors too. However, use with descriptors is the original intended purpose. icO`s2tj|_tjd7_tt|jdS(Ni(Rt_nextidt_OrderedDescriptor__orderRR7(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pyR7Qs cC`sit|trat|tray|j|jkSWqetk r]tdj||qeXntSdS(u Defined for convenient sorting of `OrderedDescriptor` instances, which are defined to sort in their creation order. usCould not determine ordering for {0} and {1}; at least one of them is not calling super().__init__ in its __init__.N(RGRRRt RuntimeErrorR/tNotImplemented(Rtother((s1lib/python2.7/site-packages/astropy/utils/misc.pyt__lt__Ys N( RRRRtabctabstractpropertyt_class_attribute_RLt_name_attribute_R7R(((s1lib/python2.7/site-packages/astropy/utils/misc.pyRs   tOrderedDescriptorContainercB`seZdZdZdZRS(u& Classes should use this metaclass if they wish to use `OrderedDescriptor` attributes, which are class attributes that "remember" the order in which they were defined in the class body. Every subclass of `OrderedDescriptor` has an attribute called ``_class_attribute_``. For example, if we have .. code:: python class ExampleDecorator(OrderedDescriptor): _class_attribute_ = '_examples_' Then when a class with the `OrderedDescriptorContainer` metaclass is created, it will automatically be assigned a class attribute ``_examples_`` referencing an `~collections.OrderedDict` containing all instances of ``ExampleDecorator`` defined in the class body, mapped to by the names of the attributes they were assigned to. When subclassing a class with this metaclass, the descriptor dict (i.e. ``_examples_`` in the above example) will *not* contain descriptors inherited from the base class. That is, this only works by default with decorators explicitly defined in the class body. However, the subclass *may* define an attribute ``_inherit_decorators_`` which lists `OrderedDescriptor` classes that *should* be added from base classes. See the examples section below for an example of this. Examples -------- >>> from astropy.extern import six >>> from astropy.utils import OrderedDescriptor, OrderedDescriptorContainer >>> class TypedAttribute(OrderedDescriptor): ... """ ... Attributes that may only be assigned objects of a specific type, ... or subclasses thereof. For some reason we care about their order. ... """ ... ... _class_attribute_ = 'typed_attributes' ... _name_attribute_ = 'name' ... # A default name so that instances not attached to a class can ... # still be repr'd; useful for debugging ... name = '' ... ... def __init__(self, type): ... # Make sure not to forget to call the super __init__ ... super(TypedAttribute, self).__init__() ... self.type = type ... ... def __get__(self, obj, objtype=None): ... if obj is None: ... return self ... if self.name in obj.__dict__: ... return obj.__dict__[self.name] ... else: ... raise AttributeError(self.name) ... ... def __set__(self, obj, value): ... if not isinstance(value, self.type): ... raise ValueError('{0}.{1} must be of type {2!r}'.format( ... obj.__class__.__name__, self.name, self.type)) ... obj.__dict__[self.name] = value ... ... def __delete__(self, obj): ... if self.name in obj.__dict__: ... del obj.__dict__[self.name] ... else: ... raise AttributeError(self.name) ... ... def __repr__(self): ... if isinstance(self.type, tuple) and len(self.type) > 1: ... typestr = '({0})'.format( ... ', '.join(t.__name__ for t in self.type)) ... else: ... typestr = self.type.__name__ ... return '<{0}(name={1}, type={2})>'.format( ... self.__class__.__name__, self.name, typestr) ... Now let's create an example class that uses this ``TypedAttribute``:: >>> @six.add_metaclass(OrderedDescriptorContainer) ... class Point2D(object): ... x = TypedAttribute((float, int)) ... y = TypedAttribute((float, int)) ... ... def __init__(self, x, y): ... self.x, self.y = x, y ... >>> p1 = Point2D(1.0, 2.0) >>> p1.x 1.0 >>> p1.y 2.0 >>> p2 = Point2D('a', 'b') # doctest: +IGNORE_EXCEPTION_DETAIL Traceback (most recent call last): ... ValueError: Point2D.x must be of type (float, int>) We see that ``TypedAttribute`` works more or less as advertised, but there's nothing special about that. Let's see what `OrderedDescriptorContainer` did for us:: >>> Point2D.typed_attributes OrderedDict([('x', ), ('y', )]) If we create a subclass, it does *not* by default add inherited descriptors to ``typed_attributes``:: >>> class Point3D(Point2D): ... z = TypedAttribute((float, int)) ... >>> Point3D.typed_attributes OrderedDict([('z', )]) However, if we specify ``_inherit_descriptors_`` from ``Point2D`` then it will do so:: >>> class Point3D(Point2D): ... _inherit_descriptors_ = (TypedAttribute,) ... z = TypedAttribute((float, int)) ... >>> Point3D.typed_attributes OrderedDict([('x', ), ('y', ), ('z', )]) .. note:: Hopefully it is clear from these examples that this construction also allows a class of type `OrderedDescriptorContainer` to use multiple different `OrderedDescriptor` classes simultaneously. cC`stt}t}d}i}xD|jD]9}x|jjD]\} } | |kr_qAn|j| t| t sA|rt| | rqAn| j dk rt | | j | n| j |krxr| j jD]=} d| jkr| || j <|| j | | fPqqWqA|| j } || j | | fqAWt|dts[Pq+|j}q+WxM|jD]?\} } | jtd| D} t || j| quWtt|j|||dS(Nu_class_attribute_u_inherit_descriptors_cs`s!|]\}}||fVqdS(N((RtvalueR((s1lib/python2.7/site-packages/astropy/utils/misc.pys /s((RRRRRstitemstaddRGRRRLtsetattrt __class__RTRRt_inherit_descriptors_tsortRRRRR7(Rtcls_nameRtmemberst descriptorstseentinherit_descriptorst descr_basestmro_clsRjRt obj_cls_basetdescriptor_clst instances((s1lib/python2.7/site-packages/astropy/utils/misc.pyR7s@          ((RRRRR7(((s1lib/python2.7/site-packages/astropy/utils/misc.pyRlsc c`svt|}t^tjtj}||kr9dVn3ztjtj|dVWdtjtj|XWdQXdS(u1 Context manager to temporarily set the locale to ``name``. An example is setting locale to "C" so that the C strtod() function will use "." as the decimal point to enable consistent numerical string parsing. Note that one cannot nest multiple set_locale() context manager statements as this causes a threading lock. This code taken from https://stackoverflow.com/questions/18593661/how-do-i-strftime-a-date-object-in-a-different-locale. Parameters ========== name : str Locale name, e.g. "C" or "fr_FR". N(tstrt LOCALE_LOCKtlocalet setlocaletLC_ALL(Rjtsaved((s1lib/python2.7/site-packages/astropy/utils/misc.pyt set_locale9s   tShapedLikeNDArraycB`seZdZejdZejdZedZ edZ edZ dZ dZ dZd Zd Zd Zd Zd ZdZdZedZdZdZdZdddZRS(uMixin class to provide shape-changing methods. The class proper is assumed to have some underlying data, which are arrays or array-like structures. It must define a ``shape`` property, which gives the shape of those data, as well as an ``_apply`` method that creates a new instance in which a `~numpy.ndarray` method has been applied to those. Furthermore, for consistency with `~numpy.ndarray`, it is recommended to define a setter for the ``shape`` property, which, like the `~numpy.ndarray.shape` property allows in-place reshaping the internal data (and, unlike the ``reshape`` method raises an exception if this is not possible). This class also defines default implementations for ``ndim`` and ``size`` properties, calculating those from the ``shape``. These can be overridden by subclasses if there are faster ways to obtain those numbers. cC`sdS(u0The shape of the instance and underlying arrays.N((R((s1lib/python2.7/site-packages/astropy/utils/misc.pytshapewscO`sdS(uCreate a new instance, with ``method`` applied to underlying data. The method is any of the shape-changing methods for `~numpy.ndarray` (``reshape``, ``swapaxes``, etc.), as well as those picking particular elements (``__getitem__``, ``take``, etc.). It will be applied to the underlying arrays (e.g., ``jd1`` and ``jd2`` in `~astropy.time.Time`), with the results used to create a new instance. Parameters ---------- method : str Method to be applied to the instance's internal data arrays. args : tuple Any positional arguments for ``method``. kwargs : dict Any keyword arguments for ``method``. N((tmethodR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pyt_apply{scC`s t|jS(u?The number of dimensions of the instance and underlying arrays.(R.R(R((s1lib/python2.7/site-packages/astropy/utils/misc.pytndimscC`s(d}x|jD]}||9}qW|S(u5The size of the object, as calculated from its shape.i(R(Rtsizetsh((s1lib/python2.7/site-packages/astropy/utils/misc.pyRscC`s |jdkS(N((R(R((s1lib/python2.7/site-packages/astropy/utils/misc.pytisscalarscC`s2|jr'tdj|jjn|jdS(Nu Scalar {0!r} object has no len()i(RR R/RRR(R((s1lib/python2.7/site-packages/astropy/utils/misc.pyt__len__s  cC`s |jdkS(u>Any instance should evaluate to True, except when it is empty.i(R(R((s1lib/python2.7/site-packages/astropy/utils/misc.pyt__bool__scC`s |jdkS(u>Any instance should evaluate to True, except when it is empty.i(R(R((s1lib/python2.7/site-packages/astropy/utils/misc.pyt __nonzero__scC`sVy|jd|SWn;tk rQ|jrKtdj|jjqRnXdS(Nu __getitem__u)scalar {0!r} object is not subscriptable.(Rt IndexErrorRR R/RR(Rtitem((s1lib/python2.7/site-packages/astropy/utils/misc.pyt __getitem__s   c`s=jr'tdjjjnfd}|S(Nu$scalar {0!r} object is not iterable.c3`s*x#ttD]}|VqWdS(N(R R.(R_(R(s1lib/python2.7/site-packages/astropy/utils/misc.pyt self_iters(RR R/RR(RR((Rs1lib/python2.7/site-packages/astropy/utils/misc.pyt__iter__s   cO`s|jd||S(uReturn an instance containing copies of the internal data. Parameters are as for :meth:`~numpy.ndarray.copy`. ucopy(R(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pytcopyscO`s|jd||S(uReturns an instance containing the same data with a new shape. Parameters are as for :meth:`~numpy.ndarray.reshape`. Note that it is not always possible to change the shape of an array without copying the data (see :func:`~numpy.reshape` documentation). If you want an error to be raise if the data is copied, you should assign the new shape to the shape attribute (note: this may not be implemented for all classes using ``ShapedLikeNDArray``). ureshape(R(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pytreshapes cO`s|jd||S(uhReturn an instance with the array collapsed into one dimension. Parameters are as for :meth:`~numpy.ndarray.ravel`. Note that it is not always possible to unravel an array without copying the data. If you want an error to be raise if the data is copied, you should should assign shape ``(-1,)`` to the shape attribute. uravel(R(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pytravelscO`s|jd||S(uReturn a copy with the array collapsed into one dimension. Parameters are as for :meth:`~numpy.ndarray.flatten`. uflatten(R(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pytflattenscO`s|jd||S(uReturn an instance with the data transposed. Parameters are as for :meth:`~numpy.ndarray.transpose`. All internal data are views of the data of the original. u transpose(R(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pyt transposescC`s!|jdkr|S|jSdS(uReturn an instance with the data transposed. Parameters are as for :attr:`~numpy.ndarray.T`. All internal data are views of the data of the original. iN(RR(R((s1lib/python2.7/site-packages/astropy/utils/misc.pytTscO`s|jd||S(uReturn an instance with the given axes interchanged. Parameters are as for :meth:`~numpy.ndarray.swapaxes`: ``axis1, axis2``. All internal data are views of the data of the original. uswapaxes(R(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pytswapaxesscO`s|jd||S(uReturn an instance with the specified diagonals. Parameters are as for :meth:`~numpy.ndarray.diagonal`. All internal data are views of the data of the original. udiagonal(R(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pytdiagonalscO`s|jd||S(uReturn an instance with single-dimensional shape entries removed Parameters are as for :meth:`~numpy.ndarray.squeeze`. All internal data are views of the data of the original. usqueeze(R(RR1R2((s1lib/python2.7/site-packages/astropy/utils/misc.pytsqueezesuraisecC`s|jd|d|d|S(uReturn a new instance formed from the elements at the given indices. Parameters are as for :meth:`~numpy.ndarray.take`, except that, obviously, no output array can be given. utaketaxistmode(R(RtindicesRR((s1lib/python2.7/site-packages/astropy/utils/misc.pyttakesN(RRRRRRtabstractmethodRtpropertyRRRRRRRRRRRRRRRRRRLR (((s1lib/python2.7/site-packages/astropy/utils/misc.pyR[s*          tIncompatibleShapeErrorcB`seZdZRS(cC`s#tt|j||||dS(N(RR R7(Rtshape_at shape_a_idxtshape_bt shape_b_idx((s1lib/python2.7/site-packages/astropy/utils/misc.pyR7"s(RRR7(((s1lib/python2.7/site-packages/astropy/utils/misc.pyR !scG`s t|dkrdSt|dkr0|dSd|D}g}xtdd|D]}d}d}xst|D]e\}}|dkrqxn|dkr|}|}qx||krxt||||||qxqxW|j|qYWt|dddS(u Determines whether two or more Numpy arrays can be broadcast with each other based on their shape tuple alone. Parameters ---------- *shapes : tuple All shapes to include in the comparison. If only one shape is given it is passed through unmodified. If no shapes are given returns an empty `tuple`. Returns ------- broadcast : `tuple` If all shapes are mutually broadcastable, returns a tuple of the full broadcast shape. iics`s|]}t|VqdS(N(treversed(RR((s1lib/python2.7/site-packages/astropy/utils/misc.pys ?st fillvalueNi((R.R RLt enumerateR RTttuple(tshapestreversed_shapest full_shapetdimstmax_dimt max_dim_idxR_tdim((s1lib/python2.7/site-packages/astropy/utils/misc.pytcheck_broadcast's(    !cC`s:tjd|j}|r0t|jdnd}|S(u Parse the number out of a dtype.str value like 'sh"                      #/z     " N0R " 0