[c@`s dZddlmZmZmZmZddlZddlZddlZddl m Z m Z m Z ddl Z ddlZddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZmZm Z d dl!m"Z"d dlm#Z$d dl%m&Z&d dl%m'Z'm(Z(m)Z)m*Z*m+Z+ddddgZ,e"Z-dZ.dZ/deej0fdYZ1e ddddfZ2de2fdYZ3ej4e1defd YZ5d!e5fd"YZ6dS(#uR Framework and base classes for coordinate frames/"low-level" coordinate classes. i(tabsolute_importtunicode_literalstdivisiontprint_functionN(t namedtuplet OrderedDictt defaultdicti(toverride__dir__(t lazyproperty(tAstropyWarning(tsix(tzip(tunits(tOrderedDescriptorContainertShapedLikeNDArraytcheck_broadcasti(tTransformGraph(trepresentation(t Attribute(tTimeFrameAttributetQuantityFrameAttributetEarthLocationAttributetCoordinateAttributet%CartesianRepresentationFrameAttributeuBaseCoordinateFrameuframe_transform_graphu GenericFrameuRepresentationMappingcC`sj|tjkrtj|}nGt|t sBt|tj rftdj|ttjn|S(uP Return a valid representation class from ``value`` or raise exception. u_Representation is {0!r} but must be a BaseRepresentation class or one of the string aliases {1}( trtREPRESENTATION_CLASSESt isinstancettypet issubclasstBaseRepresentationt ValueErrortformattlist(tvalue((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyt _get_repr_cls4scK`st|}i|d6}x|jD]\}}|dkr\tjj|jd}nr|tjkr{tj|}nS|dk rt|t st |tj  rt dj |t tjn|||su_default_representationu_default_differentialu#_frame_specific_representation_infou_Could not find all expected BaseCoordinateFrame class attributes. Are you mis-using FrameMeta?uname( tpoptTrueR'tFalsetsuperR/t__new__t__mro__Rtreadonly_prop_factorytcopytdeepcopytlower( tmclsR,tbasestmemberst default_reprtfound_default_reprt default_difftfound_default_difft repr_infotfound_repr_infottmp_clstm((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyR7rsR      !            c`s7d|fd}||s u3non-scalar attributes with inconsistent shapes: {0}((,R3R4t_attr_names_with_defaultsR'tdefault_representationtinspecttisclassRRR(tset_representation_clsR tlenRRt TypeErrorR*R%RRRtrepresentation_component_namesR#tSphericalRepresentationt_unit_representationtget_representation_clst"get_representation_component_namesthasattrt_unit_differentialtRadialDifferentialt __class__RNtwith_differentialst_datatget_frame_attr_namestsetattrRHtappendRtvaluest_no_data_shapetpopitemR5tcache(RItargstkwargsR:RR-trepresentation_datatdifferential_datatdiffstrepresentation_clst repr_kwargstnmkwtnmreptdiff_component_namest diff_kwargsRoRYtfdefaultR!tshapestkey((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyt__init__s     (                     cC`s ttS(u Cache for this frame, a dict. It stores anything that should be computed from the coordinate data (*not* from the frame attributes). This can be used in functions to store anything that might be expensive to compute but might be re-used by some other function. E.g.:: if 'user_data' in myframe.cache: data = myframe.cache['user_data'] else: myframe.cache['user_data'] = data = expensive_func(myframe.lat) If in-place modifications are made to the frame data, the cache should be cleared:: myframe.cache.clear() (Rtdict(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRrscC`s.|jdkr'tdj|n|jS(u The coordinate data for this object. If this frame has no data, an `ValueError` will be raised. Use `has_data` to check if data is present on this frame object. u6The frame object "{0!r}" does not have associated dataN(RkR'RR(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pytdatas cC`s |jdk S(uA True if this frame has `data`, False otherwise. N(RkR'(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pythas_datascC`s|jr|jjS|jS(N(RRRXRp(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRXscC`s t|jS(N(R_R(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyt__len__scC`s|jo|jdkS(Ni(Rtsize(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyt __nonzero__scC`s|jo|jdkS(Ni(RR(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyt__bool__scC`s |jjS(N(RR(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRscC`s|jo|jjS(N(RRtisscalar(RI((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRsc`stfdjDS(Nc3`s$|]}|t|fVqdS(N(RH(R1R,(RR(s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pys s(Rtframe_attributes(RR((RRs<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRlsubasecC`sMt|ds/i|jd6|jd6|_n|dk rF|j|S|jS(u.The class used for part of this frame's data. Parameters ---------- which : ('base', 's', `None`) The class of which part to return. 'base' means the class used to represent the coordinates; 's' the first derivative to time, i.e., the class representing the proper motion and/or radial velocity. If `None`, return a dict with both. Returns ------- representation : `~astropy.coordinates.BaseRepresentation` or `~astropy.coordinates.BaseDifferential`. u_representationubaseusN(RfR[tdefault_differentialt_representationR'(RItwhich((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRds cC`s8|dkr|jd}ntd|d||_dS(uSet representation and/or differential class for this frame's data. Parameters ---------- base : str, `~astropy.coordinates.BaseRepresentation` subclass, optional The name or subclass to use to represent the coordinate data. s : `~astropy.coordinates.BaseDifferential` subclass, optional The differential subclass to use to represent any velocities, such as proper motion and radial velocity. If equal to 'base', which is the default, it will be inferred from the representation. If `None`, the representation will drop any differentials. ubaseR)tsN(R'RR.(RIR)R((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyR^s tfgettfsettdocudThe representation class used for this frame's data. This will be a subclass from `~astropy.coordinates.BaseRepresentation`. Can also be *set* using the string name of the representation. If you wish to set an explicit differential class (rather than have it be inferred), use the ``set_represenation_cls`` method. c C`si}xttjjttjjD]w}igd6gd6||>> from astropy import units as u >>> from astropy.coordinates import SkyCoord, CartesianRepresentation >>> coord = SkyCoord(0*u.deg, 0*u.deg) >>> coord.represent_as(CartesianRepresentation) # doctest: +FLOAT_CMP >>> coord.representation = CartesianRepresentation >>> coord # doctest: +FLOAT_CMP unThe argument position for `in_frame_units` in `represent_as` has changed. Use as a keyword argument if needed.ubaseR)RusuFrame data has no associated differentials (i.e. the frame has no velocity data) - represent_as() only accepts a new representation.urepresentationc3`s$|]}|t|fVqdS(N(RH(R1tcomp(R(s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pys ;suunitsR:c3`s$|]}|t|fVqdS(N(RH(R1R(tdiff(s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pys JsN(RtbooltwarningstwarnR R.RR*R'R`RNRrR%t represent_asRRt componentsR ttoRiR5RtUnitSphericalDifferentialtUnitSphericalCosLatDifferentialRRhRft_differentialstupdate(RIR)Rtin_frame_unitsR+RxR-t cache_keyt cached_reprt new_attrst datakwargsRt new_attr_unitt data_difft diffkwargs((RRs<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRsj6         #   cC`s8ddlm}|jd kr.tdnt|jdd rt|drt|drtj |j |j krt dnt j |r|}nt|dr|j}ntj|j|j}|d kr+||jkr|j|jSd}||j|j|jn|||S( u Transform this object's coordinate data to a new frame. Parameters ---------- new_frame : class or frame object or SkyCoord object The frame to transform this coordinate frame into. Returns ------- transframe A new object with the coordinate data represented in the ``newframe`` system. Raises ------ ValueError If there is no possible transformation route. i(t ConvertErroru%Cannot transform a frame with no datau differentialsuobstimeuYou cannot transform a frame that has velocities to another frame at a different obstime. If you think this should (or should not) be possible, please comment at https://github.com/astropy/astropy/issues/6280u_sky_coord_frameu Cannot transform from {0} to {1}N(terrorsRRkR'RRHRRftnptanytobstimetNotImplementedErrorR\R]t_sky_coord_frametframe_transform_grapht get_transformRiRR(RIt new_frameRttranstmsg((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyt transform_toss&     !cC`satj|r|n|j}tj|j|}|dkrY||jkrRdStSntSdS(u Determines if this coordinate frame can be transformed to another given frame. Parameters ---------- new_frame : class or frame object The proposed frame to transform into. Returns ------- transformable : bool or str `True` if this can be transformed to ``new_frame``, `False` if not, or the string 'same' if ``new_frame`` is the same system as this object but no transformation is defined. Notes ----- A return value of 'same' means the transformation will work, but it will just give back a copy of this object. The intended usage is:: if coord.is_transformable_to(some_unknown_frame): coord2 = coord.transform_to(some_unknown_frame) This will work even if ``some_unknown_frame`` turns out to be the same frame class as ``coord``. This is intended for cases where the frame is the same regardless of the frame attributes (e.g. ICRS), but be aware that it *might* also indicate that someone forgot to define the transformation between two objects of the same frame class but with different attributes. usameN(R\R]RiRRR'R5R4(RIRt new_frame_clsR((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pytis_transformable_tos! cC`s ||jkS(u Determine whether or not a frame attribute has its value because it's the default value, or because this frame was created with that value explicitly requested. Parameters ---------- attrnm : str The name of the attribute to check. Returns ------- isdefault : bool True if the attribute ``attrnm`` has its value by default, False if it was specified at creation of this frame. (RZ(RItattrnm((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pytis_frame_attr_defaultscC`s~|j|jkrXx?|jD]1}tjt||t||krtSqWtSt|tsvt dntSdS(ul Checks if this object is the same frame as the ``other`` object. To be the same frame, two objects must be the same frame class and have the same frame attributes. Note that it does *not* matter what, if any, data either object has. Parameters ---------- other : BaseCoordinateFrame the other frame to check Returns ------- isequiv : bool True if the frames are the same, False if not. Raises ------ TypeError If ``other`` isn't a `BaseCoordinateFrame` or subclass. u?Tried to do is_equivalent_frame on something that isn't a frameN( RiRlRRRHR5R4RRWR`(RItothertframe_attr_name((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pytis_equivalent_framescC`si|j}|j}|r0dj|}n|rOdj|jj||Sdj|jj|SdS(Nu ({0})u<{0} Coordinate{1}: {2}>u<{0} Frame{1}>(t_frame_attrs_reprt _data_reprRRiRN(RIt frameattrst data_repr((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyt__repr__ s   c C`s|js dS|jrt|jtjrOt|jtjrO|jj}n |j}d|jj kr|j d}|jj d}t|tj tj tj fr|j}qnd}|j||dt}t|}xJ|jjD]\}}|j||}qWn|j}t|j}|jd|jjri|t|jjdd!}n d|}d|jj kr|jd}d |dkr|t|j djd} | d jdrd d j| d jd d | d N(RRRRRbRRtUnitSphericalRepresentationRiR*RdRRRhR'RR4treprRaR#treplacet startswithRNR_tsplittjoinRetendswith( RItrep_clstdif_clstdif_dataRRtnmpreftnmreprt data_repr_spltdiffreprtfrm_nmtrep_nm((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRsJ        +"cC`s=djg|jD]#}|dtt||^qS(uT Returns a string representation of the frame's attributes, if any. u, u=(RRltstrRH(RIR((s<lib/python2.7/site-packages/astropy/coordinates/baseframe.pyRQs c `sdkrjd}n|jr0|jnd }tj|rTtdnjd|j}jd|jd}fd}|d k r||}ni|d6|d6}x|j D]} | |j krdksd kr| kr| } nt || } t | d d d krQ|| } n*dksid kr{t j | } n| || sD"     (    -P