HR-eO ddlZddlZddlZddlZddlZddlZddlZddlZ ddlm Z ddl m Z ddlmZddlmZddlmZddlmZdd lmZdd lmZdd lmZmZdd lmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZU dd lmVZVdZWn #eX$rdZWYnwxYwgdZYdZZdZ[dZ\dZ]dZ^dZ_dZ`dHdZadHdZbdHdZcdHdZdGddZeGddZfGd d!ZgGd"d#ZhGd$d%ZiGd&d'ZjGd(d)ZkGd*d+ekZlGd,d-elZmGd.d/eleeZnGd0d1emeeegehZoGd2d3ekeeZpGd4d5eleeefegeheiZqGd6d7eqZrGd8d9elZsGd:d;elZtGd<d=eleheiZuGd>d?eleheiZvGd@dAekeeefeheiejZwGdBdCekeeefeiejZxGdDdEekeeefehejZyGdFdGekeeejZzdS)IN)ma) __version__)fits)HomogeneousList)AstropyDeprecationWarning) XMLWriter) converters)ucd)utilxmlutil)9E06E08E09E10E11E12E13E15E16E17E18E19E20E21E22E23E25W06W07W08W09W10W11W12W13W15W17W18W19W20W21W22W26W27W28W29W32W33W35W36W37W38W40W41W42W43W44W45W50W52W53W54vo_raise vo_reraisevo_warn warn_or_raisewarn_unknown_attrs) tablewriterTF)LinkInfoValuesFieldParamCooSysTimeSysFieldRefParamRefGroupTableResource VOTableFileElementg?ctj|f|j}tt ||}|d||d|<|S)z Masked arrays can not be resized inplace, and `np.resize` and `ma.resize` are both incompatible with structured arrays. Therefore, we do all this. dtypeN)rzerosrYminlen)maskednew_size new_arraylengths 7lib/python3.11/site-packages/astropy/io/votable/tree.py_resizerbzsM (FL999I Vh ' 'FIgvg cRdfd dfd }|r ||_|S|_S)a Creates a function useful for looking up an element by a given attribute. Parameters ---------- attr : str The attribute name unique : bool Should be `True` if the attribute is unique and therefore this should return only one value. Otherwise, returns a list of values. iterator : generator A generator that iterates over some arbitrary set of elements element_name : str The XML element name of the elements being iterated over (used for error messages only). doc : str A docstring to apply to the generated function. Returns ------- factory : function A function that looks up an element by the given attribute. Nc3Kt|D][}||ur.lookup_by_attrs/wtX..00  G&  7D$//366';;;   wd++s22   rccv|||D]}|cStd|)Nrmz2No {} with {} '{}' found before the referencing {})rjformat)rkrlrmrnrorprrs ralookup_by_attr_uniquez6_lookup_by_attr_factory..lookup_by_attr_uniquesZ%~dC???  GNNN @ G GdC     rcN__doc__)rouniquerqrpdocrvrrs` `` @ra_lookup_by_attr_factoryr|s}>*        (+%$$!$rcc&dfd }||_|S)z_ Like `_lookup_by_attr_factory`, but looks in both the "ID" and "name" attributes. Nct|D]P}||ur6||j|jfvr$td|j|jt n||j|jfvr|cSQt d|)a: Given an key *ref*, finds the first element in the iterator with the attribute ID == *ref* or name == *ref*. If *before* is provided, will stop searching at the object *before*. This is important, since "forward references" are not allowed in the VOTABLE format. rfz:No {} with ID or name '{}' found before the referencing {})rgIDnamerBrhrirjru)rkrlrmrnrprqs ralookup_by_id_or_namez;_lookup_by_id_or_name_factory..lookup_by_id_or_names/wtX..00  G&  7:w|444';;;   wz7<0001 H O Oc<     rcrwrx)rqrpr{rs`` ra_lookup_by_id_or_name_factoryrs8        4$' rcc|drdSdS)zG Get the default unit format as specified in the VOTable spec. version_1_4_or_latervounitcds)configs ra_get_default_unit_formatrs $%xurcc`|dt|}n|d}|S)z9 Get the unit format based on the configuration. unit_format)getr)rrus ra_get_unit_formatrs4zz-  ()&11 & Mrccv|6tjd|!ttt||f||dSdS)a Raises a `~astropy.io.votable.exceptions.VOTableSpecError` if *year* is not a valid astronomical year as defined by the VOTABLE standard. Parameters ---------- year : str An astronomical year string field : str The name of the field this year was found in (used for error message) config, pos : optional Information about the source of the value Nz^[JB]?[0-9]+([.][0-9]*)?$FT)rematchrEr )yearfieldrposs racheck_astroyearr s@$ BH%A4HHPc3 vs;;;u 4rccr|4t|tsttt|||dSdS)a Raises a `~astropy.io.votable.exceptions.VOTableSpecError` if *string* is not a string or Unicode string. Parameters ---------- string : str An astronomical year string attr_name : str The name of the field this year was found in (used for error message) config, pos : optional Information about the source of the value NFT) isinstancestrrEr!)string attr_namerrs ra check_stringr!s9"*VS"9"9c3 63777u 4rccL|!|tttd|||S|SNr)rEr")ridrrs ra resolve_idr8s+ zbnc3FC000 Ircc|i}|dr tj||dd|ddn#t$r}|dddkr't t |t |f||nL|ddd kr,tt |t |f||Yd}~dSYd}~dSYd}~nd}~wwxYwd S) aK Warns or raises a `~astropy.io.votable.exceptions.VOTableSpecError` if *ucd* is not a valid `unified content descriptor`_ string as defined by the VOTABLE standard. Parameters ---------- ucd : str A UCD string. config, pos : optional Information about the source of the value Nversion_1_1_or_laterversion_1_2_or_laterF)check_controlled_vocabulary has_colonverifyignore exceptionwarnT)rucd_mod parse_ucd ValueErrorrBrrrD)r rres ra check_ucdr?s2~ zz())   ,2JJ7Mu,U,U **%;UCC         zz(H--<<sCFFmVS9999Hh//699c3q66]FC888uuuuuuuuuu :9999  4s?A C<%BC77C<cdeZdZedZejdZejdZdS) _IDPropertyc|jS)zn The XML ID_ of the element. May be `None` or a string conforming to XML ID_ syntax. _IDrks rarz_IDProperty.IDfs xrccVtj|d|j|j||_dS)Nr)r check_idrhrirrkrs rarz_IDProperty.IDns(T4<;;;rccd|_dSrwrrs rarz_IDProperty.IDss rcN)__name__ __module__ __qualname__propertyrsetterdeleterrrcrarresg XYYZZrcrcdeZdZedZejdZejdZdS) _NamePropertyc|jS)z!An optional name for the element._namers rarz_NameProperty.namey zrccVtj|d|j|j||_dSNr)r check_tokenrhrirrkrs rarz_NameProperty.name~s(D&$, BBB rccd|_dSrwrrs rarz_NameProperty.name  rcN)rrrrrrrrrcrarrxsg X [[ \\rcrcdeZdZedZejdZejdZdS)_XtypePropertyc|jS)zExtended data type information._xtypers raxtypez_XtypeProperty.xtype {rcc|I|jds/tttd|jdf|j|jt |d|j|j||_dS)Nrr1.2)rhrrEr0 _element_namerirr)rkrs rarz_XtypeProperty.xtypesn  T\%5%56L%M%M  S7D$6> di    UGT\49=== rccd|_dSrwrrs rarz_XtypeProperty.xtype  rcN)rrrrrrrrrcrarrsg X \\ ]]rcrcheZdZdZedZejdZejdZdS)_UtypePropertyFc|jS)z4The usage-specific or `unique type`_ of the element._utypers rautypez_UtypeProperty.utyperrcc|jrK|I|jds/tttd|jdf|j|jt|d|j|j||_dS)Nrrr) _utype_in_v1_2rhrrEr0rrirr)rkrs rarz_UtypeProperty.utypes   !L$$%;<<" S7D$6> di    UGT\49=== rccd|_dSrwrrs rarz_UtypeProperty.utyperrcN)rrrrrrrrrrcrarrslN X \  \  ]]rcrcheZdZdZedZejdZejdZdS) _UcdPropertyFc|jS)z2The `unified content descriptor`_ for the element._ucdrs rar z_UcdProperty.ucd yrcc&||dkrd}|k|jrI|jds/t t t d|jdf|j|jt||j|j||_ dS)Nrr r) strip _ucd_in_v1_2rhrrEr0rrirr)rkr s rar z_UcdProperty.ucds ?syy{{b00C ?  )9)9:P)Q)Q D.6LI  c4< 3 3 3 rccd|_dSrwrrs rar z_UcdProperty.ucd  rcN)rrrrrr rrrrcrarrslL X Z  Z  [[rcrcdeZdZedZejdZejdZdS)_DescriptionPropertyc|jS)zn An optional string describing the element. Corresponds to the DESCRIPTION_ element.  _descriptionrs ra descriptionz _DescriptionProperty.descriptions   rcc||_dSrwr)rkrs rarz _DescriptionProperty.description'rccd|_dSrwrrs rarz _DescriptionProperty.description rcN)rrrrrrrrrcrarrsk !!X!(((!!!!!rcrc8eZdZdZdZgZdZdZdZdZ dZ dS) rUz[ A base class for all classes that represent XML elements in the VOTABLE file. rc@ttt|||dSrw)rEr#rkrqtagdatarrs ra_add_unknown_tagzElement._add_unknown_tagsc3VS11111rccNt||||dSrw)rFkeysrs ra _ignore_addzElement._ignore_adds$3 VS99999rcc|drtttd||t||||dS)Nrr)rrEr-rFrrs ra_add_definitionszElement._add_definitionssO ::, - - 5 #sB 4 4 43 VS99999rcct)a For internal use. Parse the XML content of the children of the element. Parameters ---------- iterator : xml iterable An iterator over XML elements as returned by `~astropy.utils.xml.iterparser.get_xml_iterator`. config : dict The configuration dictionary that affects how certain elements are read. Returns ------- self : `~astropy.io.votable.tree.Element` Returns self as a convenience. NotImplementedError)rkrqrs raparsez Element.parses("###rcc t)a For internal use. Output the element to XML. Parameters ---------- w : astropy.utils.xml.writer.XMLWriter object An XML writer to write to. **kwargs : dict Any configuration parameters to control the output. rrkwkwargss rato_xmlzElement.to_xmls"###rcN) rrrryr _attr_listrrrrrrrcrarUrUsu MJ222:::::: $$$, $ $ $ $ $rcrUc*eZdZdZdZdZdZdZdS) SimpleElement A base class for simple elements, such as FIELD, PARAM and INFO that don't require any special parsing or outputting machinery. c:t|dSrw)rU__init__rs rar zSimpleElement.__init__%srcctj}t|t ||Srw)ioStringIOr rrgetvaluerrkbuffs ra__repr__zSimpleElement.__repr__(sC{}}T9T??333}}$$&&&rcc|D];\}}}}|r%||jkr||||||.||jkrn<|Srw)rrrkrqrstartrrrs rarzSimpleElement.parse-sm%-   !E3c  222%%hT63GGGG***+ rcc p||j|||jdSNattrib)rnr object_attrsrrs rarzSimpleElement.to_xml6s1 $$Q^^D$/-R-R SSSSSrcN)rrrryr rrrrrcrar r s_ ''' TTTTTrcr czeZdZdZdZdZdZedZej dZej dZdS) SimpleElementWithContentr cHt|d|_dSrw)r r _contentrs rar z!SimpleElementWithContent.__init__@s!t$$$ rcc|D]D\}}}}|r%||jkr||||||.||jkr |r||_nE|Srw)rrcontentrs rarzSimpleElementWithContent.parseEs|%-   !E3c  222%%hT63GGGG***(#'DL+  rcc |||j|j|||jdSr)rnrr rrrs rarzSimpleElementWithContent.to_xmlPsE   M>>$88      rcc|jS)zThe content of the element.r rs rar"z SimpleElementWithContent.contentW }rccLt|d|j|j||_dSNr"rrhrir rkr"s rar"z SimpleElementWithContent.content\%WityAAA rccd|_dSrwr%rs rar"z SimpleElementWithContent.contenta  rcN) rrrryr rrrr"rrrrcrarr:s       X ^  ^  __rcrcTeZdZdZgdZdZ ddZedZej dZej dZed Z e j d Z e j d Z ed Z e j d Z e j dZ dZ edZdS)rHz LINK_ elements: used to reference external documents and servers through a URI. The keyword arguments correspond to setting members of the same name, documented below. )r content_role content_typetitlevaluehrefactionLINKNc  |i}||_||_t|| dp| d} | dp| d} d| vrt t t d||t|||||_| |_ | |_ ||_ ||_ ||_ ||_td| ||gddS) N content-roler/ content-typer0grefrr5)r7r/r8r0r9)rhrir r rrEr$rrr/r0r1r2r3r4rFr) rkrr1r2r3r4rrrrr/r0s rar z Link.__init__ys >F  t$$$zz.11OVZZ5O5O zz.11OVZZ5O5O V   #sB 4 4 4RVS11((      KKMM   T T T      rcc|jS)zDefines the MIME role of the referenced object. Must be one of: None, 'query', 'hints', 'doc', 'location' or 'type'  _content_rolers rar/zLink.content_roles !!rcc|dkr |jdr|dvr"tt|f|j|j||_dS)Ntypeversion_1_3_or_later)Nqueryhintsr{location)rhrDr=rir<)rkr/s rar/zLink.content_rolesP F " "4<8N+O " !L L L C,$, B B B)rccd|_dSrwr;rs rar/zLink.content_role!rcc|jS)z7Defines the MIME content type of the referenced object. _content_typers rar0zLink.content_types !!rccTtj||j|j||_dSrw)r check_mime_content_typerhrirG)rkr0s rar0zLink.content_types)' dlDINNN)rccd|_dSrwrFrs rar0zLink.content_typerDrcc|jS)zo A URI to an arbitrary protocol. The vo package only supports http and anonymous ftp. _hrefrs rar3z Link.href zrccTtj||j|j||_dSrw)r check_anyurirhrirM)rkr3s rar3z Link.hrefs&T4<;;; rccd|_dSrwrLrs rar3z Link.hrefrrcci}|jD]}t||d}||||<|jdg|jd|dS)Nlinks)rrgmeta setdefaultappendrkcolumnrTkeyvals rato_table_columnzLink.to_table_columnsq?  C$T**CS  w+++ G##D)))))rcc|di|Srr)clsds rafrom_table_columnzLink.from_table_columnssxxQxxrcNNNNNNNN)rrrryrrr rr/rrr0r3r[ classmethodr_rrcrarHrHfsJM    ' ' ' ' R""X"***"""""X"***"""X [[ \\***[rcrHceZdZdZdZgdZegdzZdZ ddZe dZ e j d Z e d Z e j d Z e d Z e j d Z e jdZ e dZej dZejdZe dZej dZejdZdZdS)rIz INFO_ elements: arbitrary key-value pairs for extensions to the standard. The keyword arguments correspond to setting members of the same name, documented below. INFO)rrr2)rrlunitr rTNc  | i} | |_| |_t|t ||| | pt j|| | |_||_||_ ||_ ||_ ||_ ||_ | |_| dr |j|_nu|j|_|t'ddg| | |t'ddg| | |t'ddg| | |t'ddg| | | t'ddg| | t'd| | | dS)Nrrcrrlrdr r)rhrirr rr fix_idrrr2rrlrdr rr _attr_list_12r _attr_list_11rFr) rkrrr2rrrlrdr rrrextras rar z Info.__init__sb >F   ))$///RVS11VW^D&RU5V5V     ::, - - C"0DOO"0DO "6G9fcBBB"6E7FC@@@"6F8VSAAA"6E7FC@@@ "6G9fcBBB65::<<=====rcc|jS)z+[*required*] The key of the key-value pair.rrs rarz Info.name#rrcc|'tttd|j|jt j|d|j|j||_dSr)rEr4rhrir rrrs rarz Info.name(sG < #sFDL$) D D DD&$, BBB rcc|jS)zw [*required*] The value of the key-value pair. (Always stored as a string or unicode string). _valuers rar2z Info.value/ {rcc|'tttd|j|jt |d|j|j||_dS)Nr2)rEr4rhrirrnrkr2s rar2z Info.value7sD = #sGT\49 E E EUGT\49=== rcc|jS)z$The content inside the INFO element.r%rs rar"z Info.content>r&rccLt|d|j|j||_dSr(r)r*s rar"z Info.contentCr+rccd|_dSrwr%rs rar"z Info.contentHr-rcc|jS)zd Refer to another INFO_ element by ID_, defined previously in the document. _refrs rarlzInfo.refL yrcc|A|jds'tttd|j|jt j|d|j|j||_dS)Nr)rlrcrrl)rhrrEr0rir rrwrkrls rarlzInfo.refTs_ ?4<#3#34J#K#K? #s$:DL$) T T TeT\49===  rccd|_dSrwrvrs rarlzInfo.refjrrcc|jS)z-A string specifying the units_ for the INFO_._unitrs rardz Info.unitnrrcc| d|_dSddlm}|jds't t t d|j|jt|j}| ||d}t||j r(t tt|f|j|jt|j}||kr| ||d}||_dS)Nrunitsr)rdrcrsilentru parse_strict)r~astropyrrhrrEr0rirUnitrUnrecognizedUnitr>rrkrdudefault_formatunit_objrus rardz Info.unitss <DJ F&&&&&&| 677 V #s$;T\49 U U U2$,??66$~H6MM h 2 3 3 F #sTGT\49 E E E!$,// ^ # #vvd6vIIH rccd|_dSrwr}rs rardz Info.unitrrcc |||j}d|vr|jd|d<||j|j|dS)Nrdrr)rrrd to_stringrnrr )rkrrrs rarz Info.to_xmls^do66 V  !Y0077F6N $$dmF CCCCCrc) NNNNNNNNNNN)rrrryrrhrgrr rrrr2r"rrlrdrrrcrarIrIsM+++M!$L$L$LLMN       .>.>.>.>`X [[ X \\ X ^  ^  __X ZZ* [[X [[. \\DDDDDrcrIceZdZdZ d dZdZedZejdZej dZed Z e jd Z ed Z e jd Z e j d Z edZ e jdZ e j dZ edZ e jdZ e j dZ edZejdZej dZedZejdZej dZedZdZdZdZdZdZdS)!rJz VALUES_ element: used within FIELD_ and PARAM_ elements to define the domain of values. The keyword arguments correspond to setting members of the same name, documented below. Nlegalc  `|i}||_| |_t|||_||_t |||| |_||_||_ ||_ d|_ d|_ d|_ d|_g|_t!d| || dS)NTVALUES)rhrirUr _votable_fieldrrnullrwr>r[max min_inclusive max_inclusive_optionsrFr) rkvotablerrrrlr>rrrextrass rar zValues.__init__s >F    RVS11   !! 8V[[]]FC@@@@@rcctj}|t||Srw)rrrrrrrs rarzValues.__repr__s?{}} IdOO$$$}}$$&&&rcc|jS)zm For integral datatypes, *null* is used to define the value used for missing values. _nullrs rarz Values.nullrNrcc||t|tr |jj||j|jd}nj#t$r[ttt||j|j|jjd|j|jd}YnwxYw|}||_ dS)Nr0) rrr converter parse_scalarrhri ExceptionrEr5r)rkrnull_vals rarz Values.nulls   4 5 5  ;0==$,    c3dlDIFFF;0==ty  H s1A A"B0/B0cd|_dSrwrrs rarz Values.nullrrcc|jS)alDefines the applicability of the domain defined by this VALUES_ element [*required*]. Must be one of the following strings: - 'legal': The domain of this column applies in general to this datatype. (default) - 'actual': The domain of this column applies only to the data enclosed in the parent table. _typers rar>z Values.type zrcc^|dvr!tt||j|j||_dS)N)ractual)rBrrhrirrkr>s rar>z Values.type1 * * * S$ di 8 8 8 rcc|jS)z Refer to another VALUES_ element by ID_, defined previously in the document, for MIN/MAX/OPTION information. rvrs rarlz Values.refrxrcctj|d|j|j| |j||}|j|_|j|_|j|_|j |_ |j |_ |j |_ |j |j dd<n@#t$r3tt t d|jf|j|jd}YnwxYw||_dS)Nrlrtr)r rrhrirget_values_by_idrr>r[rrroptionsrrjrEr;rlrw)rkrlothers rarlz Values.refseT\49=== ? 1 66s46HH "J !J  9%*%8" 9%*%8"#(= aaa     c348(.yes_nos u4rcrrlr)rrrlrFr2rrr)rr2) rrlrnrrr[rroutputrrrr)rkrrrrr2s rarz Values.to_xmls          F 8  IIhq~~dUG'D'DI E E E E Ext=R=R=R(S(STT @ @8'II"k3::48UKK"(&);"<"< 8'II"k3::48UKK"(&);"<"< $(<@@KD%IIhTI????@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @srlr[rrrrrrrr[r_rrcrarJrJs      !A!A!A!AF''' X [  [  \\  X  [[ X ZZ$ [[X  ZZ  [[##X#222###X  ZZ  [[##X#222###X'''R   @@@8%%% :::::rcrJc:eZdZdZgdZedgzZdZ d%dZedZ dZ e d Z e j d Z e d Zej d Zejd Ze dZej dZejdZe dZej dZejdZe dZej dZejdZe dZej dZejdZe dZej dZejdZe dZej dZejdZe d Zd!Zd"Zd#Zed$ZdS)&rKa FIELD_ element: describes the datatype of a particular column of data. The keyword arguments correspond to setting members of the same name, documented below. If *ID* is provided, it is used for the column name in the resulting recarray of the table. If no *ID* is provided, *name* is used instead. If neither is provided, an exception will be raised. ) rrdatatype arraysizer rdwidth precisionrrlrFIELDNc |'t|dr|}ni}||_||_t||dr |j|_n&|j |_|t|j dg|||dddkr3|dkr-|dkr'|dkr!|d krd }d }ttd ||d|_||_t!|| ||pt#j||||_||_|O|j d kr|dsn"t+t,t,|j |||j|_|j|t1t2|j ||d dddddd ddd }||di||vr-t+t6t6|||f||||}| |_||_||_||_||_ ||_!| |_"| |_#| |_$tKtL|_'|j|_(tS|j||_*||_+|,||t|j |-||dS)N_get_version_checksrrrrr cprojectionzVOX:WCS_CoordProjectiondoublechar3rPARAMr unicodeCharshortintlongfloat) r unicodeStringint16int32int64float32float64 unsignedInt unsignedShortdatatype_mapping).rrrhrir r rrgrrhrFrrDr8rrrr rfrrrEr'rrBr%updater&rlrrr rdrrrr>rrH_linksr1rJrr_setupr)rkrrrrrr rdrrrrlr>rrrrrirs rar zField.__init__s( >w 566  4466  t$$$ ::, - - O"0DOO"0DO "4#5y&#NNN JJx * *k 9 9 %%m##000H$$HI CVS ) ) )  RVS11VW^D&RU5V5V <!W,,VZZ@V5W5W,c3(:FCHHHDI 8  S$,fc : : :*!"     +=r B BCCC ' ' ' #sX/?/I$JFTW X X X'1H  "  "  %d++ Y T]D11   FC   4-uzz||VSIIIIIrcci}|D]j}d}|j}||vr|jd|dz}|dz }||v||jkr(tt|j|f|j|j||_|j||<k|D]}d}|j |j}d}n |j}d}||jkr||vr|jd|dz}|dz }||v|s3||jkr(tt |j|f|j|j||_|j||<dS) z Make sure that all names and titles in a list of fields are unique, by appending numbers if necessary. _r^r NTF )rrDr2rhrirr3 _unique_name)r]fieldsrzrinew_idnew_nameimplicits ra uniqify_nameszField.uniqify_namesmsj  & &EAXFF""IIII-QF""!!eh/ KKKEH"XF6NN * *EAz! 8 : 58##&(($zIIII5HFA&(( PEJ 6 6ej(3U]EJOOO!)E $zF8  ! * *rcc|jj|jj|j_tj||||_dSrw)rrwrlr get_converterrrkrrs rar z Field._setups5 ;  '"k.DKO#1$DDrcc|jS)aThe datatype of the column [*required*]. Valid values (as defined by the spec) are: 'boolean', 'bit', 'unsignedByte', 'short', 'int', 'long', 'char', 'unicodeChar', 'float', 'double', 'floatComplex', or 'doubleComplex' Many VOTABLE files in the wild use 'string' instead of 'char', so that is also a valid option, though 'string' will always be converted to 'char' when writing the file back out. ) _datatypers rarzField.datatypes ~rcc|H|jdr,ttt|j|j|jd}|t jvr(tt||j f|j|j||_ dS)Nrr) rhrrErrrir converter_mappingrBrrr)rkrs rarzField.datatypes|  | 677 Uc3(:DL$)TTTH :7 7 7 S8TW-t|TY G G G!rcc|jS)am Along with :attr:`width`, defines the `numerical accuracy`_ associated with the data. These values are used to limit the precision when writing floating point values back to the XML file. Otherwise, it is purely informational -- the Numpy recarray containing the data itself does not use this information.  _precisionrs rarzField.precisions rcc|6tjd|s!tt||j|j||_dS)Nz ^[FE]?[0-9]+$)rrrBrrhrir)rkrs rarzField.precisions=  2BI)N)N S)T\49 = = =#rccd|_dSrwrrs rarzField.precision rcc|jS)aq Along with :attr:`precision`, defines the `numerical accuracy`_ associated with the data. These values are used to limit the precision when writing floating point values back to the XML file. Otherwise, it is purely informational -- the Numpy recarray containing the data itself does not use this information. _widthrs rarz Field.widths {rcc|6t|}|dkr!tt||j|j||_dS)Nr)rrBrrhrir%)rkrs rarz Field.widths?  JJEzzeT\49=== rccd|_dSrwr$rs rarz Field.widthrrcc|jS)z On FIELD_ elements, ref is used only for informational purposes, for example to refer to a COOSYS_ or TIMESYS_ element. rvrs rarlz Field.refrxrccVtj|d|j|j||_dSNrlr rrhrirwrzs rarlz Field.ref(eT\49=== rccd|_dSrwrvrs rarlz Field.refrrcc|jS)z.A string specifying the units_ for the FIELD_.r}rs rardz Field.unitrrccl| d|_dSddlm}t|j}|||d}t ||jr(ttt|f|j|j t|j}||kr|||d}||_dS)Nrrrr) r~rrrrhrrrrEr>rirrs rardz Field.units <DJ F&&&&&&2$,??66$~H6MM h 2 3 3 F #sTGT\49 E E E!$,// ^ # #vvd6vIIH rccd|_dSrwr}rs rardz Field.unit rrcc|jS)z Specifies the size of the multidimensional array if this FIELD_ contains more than a single value. See `multidimensional arrays`_.  _arraysizers rarzField.arraysizes rcc|6tjd|s!tt||j|j||_dS)Nz^([0-9]+x)*[0-9]*[*]?(s\W)?$)rrrBrrhrir3)rkrs rarzField.arraysizesC   +Y* *  S)T\49 = = =#rccd|_dSrwr2rs rarzField.arraysize"r"rcc|jS)zb The type attribute on FIELD_ elements is reserved for future extensions. rrs rar>z Field.type&rNrcc||_dSrwrrs rar>z Field.type.rrccd|_dSrwrrs rar>z Field.type2rrcc|jS)zc A :class:`Values` instance (or `None`) defining the domain of the column. _valuesrs rarz Field.values6 |rccF|t|tsJ||_dSrw)rrJr;)rkrs rarz Field.values>s$~FF!;!;~~~ rccd|_dSrwr:rs rarz Field.valuesC  rcc|jS)z A list of :class:`Link` instances used to reference more details about the meaning of the FIELD_. This is purely informational and is not used by the `astropy.io.votable` package. r rs rarSz Field.linksGs {rcc"|D]%\}}}}|r|dkr8|jj|j|f||d||j||H|dkr@t d||d|}|j|||||dkr%td|||||j kr| ||||||dkr4|j "ttt|j |||pd|_ ||j krn'|j K|]}|VdSrw)r.0xs ra zField.parse..js*!S!S!''))!S!S!S!S!S!Srcr)rr rrrHrSrVrFrrrrrEr(join splitlinesr1rr )rkrqrrrrrlinks rarz Field.parseQs%-   !E3c (??(DK( t4:GKK%%h7777F]]?v3??$??DJ%%d+++JJx0000M))&}diikk63OOOOD...))(CvsKKK-'''3%c30BFCPPP'+|tD$$D...E/   '!S!ST5E5P5P5R5R!S!S!SSSDJJDJ FC    rcc |||j}d|vr|jd|d<||j|5|j|d|jd|j s|jj |fi||j D]}|j |fi| ddddS#1swxYwYdS)NrdrrrDTwrap) rrrdrrrrrnrrrrS)rkrrrrLs rarz Field.to_xmlrsBdo66 V  !Y0077F6N UU4%fU 5 5 ) )+ -)9 EEE;**,, 0" "1/////  ) ) A(((((( )  ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) )sA)CCCc~dD]}t||d}| ||j|< |js|j||jD]}|||j |j|_|j |j|_t|j tj r#|j j dkr|j j |_ dSt|j tjrd|jjd<dSt|j tjrd|jjd<dSdS)z Sets the attributes of a given `astropy.table.Column` instance to match the information in this `Field`. r rrrrNz{!r:>}r_votable_string_dtyper)rgrTrrr[rSrrdrrr FloatingPoint output_formatruCharr UnicodeChar)rkrXrYrZrLs rar[zField.to_table_column~sO C ' 'C$T**C#& C {&&(( 0 K ' ' / / /J ) )D   ( ( ( (   '!%!1F  9 )FK t~z'? @ @ F,88 N8FMMM   8 8 F8>FK 4 5 5 5  (> ? ? F8EFK 4 5 5 5 F Frcci}|jj}|r"dD]}||d}||||< |jj|jj|d<|jj|d<t j|}||||fi|}|jj|jj|_|j ||rAd|vr=|dD]4} |j t | 5|S)zc Restores a `Field` instance from a given `astropy.table.Column` instance. rQNrdrrS)rrTrrdrr table_column_to_votable_datatyperrrr_rSrVrH) r]rrXrrTrYrZresultrrLs rar_zField.from_table_columns. {  &F & &hhsD))?"%F3K ;  '#[-F6N)vrrSrrr[r_rrcrarKrKs     M"WI-MM        #jJjJjJjJX!*!*[!*FEEE   X _""_"  X $$$   X  \\ ]] X ZZ [[X [[( \\X$$$X [[ \\X ]] ^^XB ) ) )FFF8[rcrKceZdZdZejdgzZejdgzZdZ d dZe dZ e j dZ dZ d Z dS) rLz PARAM_ element: constant-valued columns in the data. :class:`Param` objects are a subclass of :class:`Field`, and have all of its methods and members. Additionally, it defines :attr:`value`. r2rNc T||_tj||f||||||| | | | ||d |dS)N) rrrrr rdrrr>rrr)rnrKr )rkrrrr2rrr rdrrrr>rrrris rar zParam.__init__si&            rcc|jS)z [*required*] The constant value of the parameter. Its type is determined by the :attr:`~Field.datatype` member. rmrs rar2z Param.valuerorcc|d}t|tr3|j||j|jd|_dS||_dS)Nrr)rrrrrhrirnrqs rar2z Param.valuesQ =E eS ! ! ...udlDINNqQDKKKDKKKrccVt||||j|_dSrw)rKr rnr2rs rar z Param._setups% T63'''[ rcc |j}|j|d|_|jd|_tj||fi|||_dS)NFr)rnrrrKr)rkrr tmp_values rarz Param.to_xmlsVK n++Iu== ; DK T1''''' rc)NNNNNNNNNNNNNN)rrrryrKrhrgrr rr2rr rrrcrarLrLs'7)3M'7)3MM       !$ $ $ $ LX \  \ !!!     rcrLcleZdZdZgdZdZ ddZedZej dZedZ e j d Z e j d Z ed Z e j d Z e j d Z edZ e j dZ e j dZ dS)rMz COOSYS_ element: defines a coordinate system. The keyword arguments correspond to setting members of the same name, documented below. )requinoxepochsystemCOOSYSNc |i}||_||_|dr2|dstttd||t |t|||||_||_ ||_ ||_ td| ||dS)Nrr?rre)rhrirrEr/r r rrrbrcrdrFr) rkrrbrcrdrrrris rar zCooSys.__init__s >F   ::, - - 5fjj "7 7  5 #sB 4 4 4t$$$RVS11   8UZZ\\63?????rcc|jS)z [*required*] The XML ID of the COOSYS_ element, used for cross-referencing. May be `None` or a string conforming to XML ID_ syntax. rrs rarz CooSys.ID6 xrcc|jdr#|!ttd|j|jt j|d|j|j||_dS)Nrrr)rhrrBrrir rrrs rarz CooSys.ID?s^ <  2 3 3 ;zb$, :::T4<;;;rcc|jS)zSpecifies the type of coordinate system. Valid choices are: 'eq_FK4', 'eq_FK5', 'ICRS', 'ecl_FK4', 'ecl_FK5', 'galactic', 'supergalactic', 'xy', 'barycentric', or 'geo_app' _systemrs rardz CooSys.systemGs |rccj|dvr'ttt||j|j||_dS)N) eq_FK4eq_FK5ICRSecl_FK4ecl_FK5galactic supergalacticxy barycentricgeo_app)rErrhrirl)rkrds rardz CooSys.systemRs;    #sFDL$) D D D rccd|_dSrwrkrs rardz CooSys.systemcr?rcc|jS)z A parameter required to fix the equatorial or ecliptic systems (as e.g. "J2000" as the default "eq_FK5" or "B1950" as the default "eq_FK4"). _equinoxrs rarbzCooSys.equinoxgrrccLt|d|j|j||_dS)Nrb)rrhrir{)rkrbs rarbzCooSys.equinoxps%DL$)DDD rccd|_dSrwrzrs rarbzCooSys.equinoxur-rcc|jS)zu Specifies the epoch of the positions. It must be a string specifying an astronomical year. _epochrs rarcz CooSys.epochyrorccLt|d|j|j||_dS)Nrc)rrhrir)rkrcs rarcz CooSys.epochs%w di@@@ rccd|_dSrwrrs rarcz CooSys.epochrrcNNNNNNN)rrrryrrr rrrrdrrbrcrrcrarMrM s655JM   @@@@>XYYX ]]  ^^X ^  ^  __X \\ ]]rcrMcleZdZdZgdZdZ ddZedZej dZedZ e j d Z e j d Z ed Z e j d Z e j d Z edZ e j dZ e j dZ dS)rNz TIMESYS_ element: defines a time system. The keyword arguments correspond to setting members of the same name, documented below. r timeorigin timescale refpositionTIMESYSNc Z|i}||_||_|ds#ttt|d||t|t |||||_||_||_ ||_ td| ||gddS)Nrversionrr) rhrirErAr r rrrrrrFr) rkrrrrrrrris rar zTimeSys.__init__s >F  ,- D #sF9$5vs C C Ct$$$RVS11$"&  JJLL   < < <      rcc|jS)z [*required*] The XML ID of the TIMESYS_ element, used for cross-referencing. Must be a string conforming to XML ID_ syntax. rrs rarz TimeSys.IDrhrcc|!ttd|j|jt j|d|j|j||_dS)Nrr)rBrrhrir rrrs rarz TimeSys.IDsE : S"dlDI 6 6 6T4<;;;rcc|jS)u Specifies the time origin of the time coordinate, given as a Julian Date for the the time scale and reference point defined. It is usually given as a floating point literal; for convenience, the magic strings "MJD-origin" (standing for 2400000.5) and "JD-origin" (standing for 0) are also allowed. The timeorigin attribute MUST be given unless the time’s representation contains a year of a calendar era, in which case it MUST NOT be present. In VOTables, these representations currently are Gregorian calendar years with xtype="timestamp", or years in the Julian or Besselian calendar when a column has yr, a, or Ba as its unit and no time origin is given.  _timeoriginrs rarzTimeSys.timeorigins $rcc|T|dkrN|dkrH t|}n7#t$r*ttt||j|jYnwxYw||_dS)Nz MJD-originz JD-origin)rrrErrhrir)rkrs rarzTimeSys.timeorigins  "l**k)) M":..  M M Mc3 DL$)LLLLL M%s 1AAcd|_dSrwrrs rarzTimeSys.timeoriginsrcc|jS)z [*required*] String specifying the time scale used. Values should be taken from the IVOA timescale vocabulary (documented at http://www.ivoa.net/rdf/timescale).  _timescalers rarzTimeSys.timescales rcc||_dSrwr)rkrs rarzTimeSys.timescales #rccd|_dSrwrrs rarzTimeSys.timescaler"rcc|jS)z [*required*] String specifying the reference position. Values should be taken from the IVOA refposition vocabulary (documented at http://www.ivoa.net/rdf/refposition).  _refpositionrs rarzTimeSys.refpositions   rcc||_dSrwr)rkrs rarzTimeSys.refpositionrrccd|_dSrwrrs rarzTimeSys.refposition rrcr)rrrryrrr rrrrrrrrrcrarNrNsBAAJM   ! ! ! ! FXYY   X & & & &   X$$$!!X!(((!!!!!rcrNceZdZdZdgZeddgzZdZdZdZ d dZ e d Z e j d Z e j d Z d ZdS)rOz_ FIELDref_ element: used inside of GROUP_ elements to refer to remote FIELD_ elements. rlr rFIELDrefTNc `|i}||_||_t|||_||_||_||_|dr|j |_ dS|j |_ |t|j dg|||t|j dg||dSdS)z *table* is the :class:`Table` object that this :class:`FieldRef` is a member of. *ref* is the ID to reference a :class:`Field` object defined elsewhere. Nrr r)rhrir r _tablerlr rrrgrrhrFr)rktablerlr rrrris rar zFieldRef.__init__s >F  t$$$  ::, - - O"0DOOO"0DO"4#5wLLL "4#5y&#NNNNN! rcc|jS)z5The ID_ of the FIELD_ that this FIELDref_ references.rvrs rarlz FieldRef.ref:rrccVtj|d|j|j||_dSr*r+rzs rarlz FieldRef.ref?r,rccd|_dSrwrvrs rarlz FieldRef.refDrrcc|jjD]+}t|tr|j|jkr|cS,td|jd|j|j tdS)zd Lookup the :class:`Field` instance that this :class:`FieldRef` references. zNo field named ''N) rriter_fields_and_paramsrrKrrlrBrhrirjrkrs raget_refzFieldRef.get_refHsz [)@@BB  E%'' EH,@,@ /DH///ty(SSSSSrcNNNNrrrryrhrgrrrr rrlrrrrrcrarOrOsGM!UG$44MMNLBFOOOO<X ZZ [[TTTTTrcrOceZdZdZdgZeddgzZdZdZdZd dZ e d Z e j d Z e j d Z d ZdS)rPa4 PARAMref_ element: used inside of GROUP_ elements to refer to remote PARAM_ elements. The keyword arguments correspond to setting members of the same name, documented below. It contains the following publicly-accessible members: *ref*: An XML ID referring to a element. rlr rPARAMrefTNc`|i}||_||_t|||_||_||_||_|dr|j |_ dS|j |_ |t|j dg|||t|j dg||dSdS)Nrr r)rhrirUr rrlr rrrgrrhrFr)rkrrlr rrrs rar zParamRef.__init__es >F    ::, - - O"0DOOO"0DO"4#5wLLL "4#5y&#NNNNN! rcc|jS)z5The ID_ of the PARAM_ that this PARAMref_ references.rvrs rarlz ParamRef.ref{rrccVtj|d|j|j||_dSr*r+rzs rarlz ParamRef.refr,rccd|_dSrwrvrs rarlz ParamRef.refrrcc|jjD]+}t|tr|j|jkr|cS,td|jd|j|j tdS)zf Lookup the :class:`Param` instance that this :class:``PARAMref`` references. zNo params named 'rN) rrrrrLrrlrBrhrirj)rkparams rarzParamRef.get_refsz [)@@BB  E%'' EH,@,@ 0TX000$, 8TTTTTrcrrrrcrarPrPSs  GM!UG$44MMNLOOOO,X ZZ [[UUUUUrcrPceZdZdZ ddZdZedZejdZej dZedZ d Z d Z d Z d Zd ZdZdZdZdS)rQaz GROUP_ element: groups FIELD_ and PARAM_ elements. This information is currently ignored by the vo package---that is the columns in the recarray are always flat---but the grouping information is stored so that it can be written out again to the XML file. The keyword arguments correspond to setting members of the same name, documented below. Nc  |i}||_| |_t|||_t |||| pt j||| |_||_ ||_ ||_ ||_ d|_ ttt t"t$f|_t)d| || dS)NGROUP)rhrirUr rrr rfrrrlr rrrrOrPrQrL_entriesrFr) rkrrrrlr rrrrris rar zGroup.__init__s >F   RVS11VW^D&RU5V5V  '8UE(JKK 7EJJLL&#>>>>>rcc2dt|jdS)Nz ... z entries ...)r\rrs rarzGroup.__repr__sES//EEEErcc|jS)zg Currently ignored, as it's not clear from the spec how this is meant to work. rvrs rarlz Group.refrxrccVtj|d|j|j||_dSr*r+rzs rarlz Group.refr,rccd|_dSrwrvrs rarlz Group.refrrcc|jS)z [read-only] A list of members of the GROUP_. This list may only contain objects of type :class:`Param`, :class:`Group`, :class:`ParamRef` and :class:`FieldRef`. )rrs raentriesz Group.entriesrrccdt|jf||d|}|j|dSNrC)rOrrrV)rkrqrrrrfieldrefs ra _add_fieldrefzGroup._add_fieldref<DKHCHH4HH H%%%%%rccdt|jf||d|}|j|dSr)rPrrrV)rkrqrrrrparamrefs ra _add_paramrefzGroup._add_paramrefrrcct|jtr|j}n |jj}t |f||d|}|j||||dSr)rrrTrrLrrVr)rkrqrrrrrrs ra _add_paramzGroup._add_paramsu dk; / / +kGGk*Gg>f#>>>> E""" Hf%%%%%rcct|jf||d|}|j||||dSr)rQrrrVrrkrqrrrrgroups ra _add_groupzGroup._add_groupsPdkB&cBBTBB E""" Hf%%%%%rcc*|j|j|j|j|jd}|D]n\}}}}|r)|||j|||||2|dkr.|jtttd|||pd|_f|dkrno|S)N)rrrrrDrDr) rrrrrrrrrEr()rkrqr tag_mappingrrrrs rarz Group.parses**__+   &.   !E3c ; T%:;;c4-'''3%c3EEE'+|tD$$G^^E$ rcc |d||gd5|j|d|jd|jD]}|j|fi| ddddS#1swxYwYdS)Nrrrrlr rrrDTrN)rrrrnrr)rkrrentrys rarz Group.to_xml s UU ANN41V1V1VWW   * *+ -)9 EEE * * Q))&)))) *  * * * * * * * * * * * * * * * * * *s=A99A=A=c#K|jD]K}t|tr|Vt|tr|Ed{VLdS)zf Recursively iterate over all :class:`Param` elements in this :class:`Group`. N)rrrLrQrrkrs rarzGroup.iter_fields_and_params sw \ : :E%'' : E5)) : 77999999999  : :rcc#K|jD]5}t|tr|V|Ed{V6dS)zk Recursively iterate over all sub-:class:`Group` instances in this :class:`Group`. N)rrrQ iter_groupsrs rarzGroup.iter_groups& sc \ / /E%'' /  ,,......... / /rcr`)rrrryr rrrlrrrrrrrrrrrrrcrarQrQsG        ????@FFFX ZZ [[X&&&&&&&&&&&& .*** : : ://///rcrQcreZdZdZ d5dZdZdZdZedZ e j dZ e j d Z ed Z e j d Z ed Z ed ZedZedZedZedZdZd6dZdZdZdZdZdZdZdZdZdZdZdZd Z d!Z!d"Z"d7d$Z#e$d%Z%d&Z&e'd'd(d)d*d+Z(e)d)d*d,Z*e'd-d#d)d*d.Z+d/Z,e'd'd(d0d1d2Z-e'd-d#d0d1d3Z.d4Z/dS)8rRa TABLE_ element: optionally contains data. It contains the following publicly-accessible and mutable attribute: *array*: A Numpy masked array of the data itself, where each row is a row of votable data, and columns are named and typed based on the elements of the table. The mask is parallel to the data array, except for variable-length fields. For those fields, the numpy array's column type is "object" (``"O"``), and another masked array is stored there. If the Table contains no data, (for example, its enclosing :class:`Resource` has :attr:`~Resource.type` == 'meta') *array* will have zero-length. The keyword arguments correspond to setting members of the same name, documented below. Nc  $| i} | |_| |_d|_t|||_t ||| | ptj|| | |_ ||_ tj |d| | ||_ ||_ ||_|$t|}|dkrt!d||_d|_d|_t)t*|_t)t.|_t)t2|_t)t6|_t)t:|_t?j g|_ tCd| "| | dS)NFrlrz'nrows' cannot be negative. tabledataTABLE)#rhri_emptyrUr rrr rfrrrrwr rrr_nrowsrrurrK_fieldsrL_paramsrQ_groupsrHr rI_infosrarrayrFr) rkrrrrlr rnrowsrrrris rar zTable.__init__G sU >F    RVS11VW^D&RU5V5V eVS111   JJEqyy !>??? ! &u-- &u-- &u-- %d++ %d++ Xb\\ 7EJJLL&#>>>>>rccDt|Srw)reprto_tablers rarzTable.__repr__v sDMMOO$$$rccDt|Srw)bytesrrs ra __bytes__zTable.__bytes__y sT]]__%%%rccDt|Srw)rrrs ra__str__z Table.__str__| s4==??###rcc|jSrwrvrs rarlz Table.ref s yrcctj|d|j|j| |j||}|j|_|j|_ |j |_ |j |_ nh#t$r3tt t d|jf|j|jd}Yn,wxYw|jdd=|j dd=|j dd=|j dd=||_dS)z Refer to another TABLE, previously defined, by the *ref* ID_ for all metadata (FIELD_, PARAM_ etc.) information. rlNrtr)r rrhrirget_table_by_idrrparamsrgroupsrrSr rjrEr;rlrw)rkrlrs rarlz Table.ref s eT\49=== ? * 55c$5GG %| $| $| #k    c3$((;T\49UUU  QQQ QQQ QQQ AAA sA22:B/.B/cd|_dSrwrvrs rarlz Table.ref rrcc|jS)aThe serialization format of the table [*required*]. Must be one of: 'tabledata' (TABLEDATA_), 'binary' (BINARY_), 'binary2' (BINARY2_) 'fits' (FITS_). Note that the 'fits' format, since it requires an external file, can not be written out. Any file read in with 'fits' format will be read out, by default, in 'tabledata' format. See :ref:`astropy:votable-serialization`. )_formatrs raruz Table.format s |rcc.|}|dkr!td|j|jt|dkr)|jdstd|j|jn#|dvrtd|d|j|j||_dS) Nrz.fits format can not be written out, only read.binary2r?z.binary2 only supported in votable 1.3 or later)rbinaryzInvalid format 'r)lowerrBrhrirr)rkrus raruz Table.format s V   @  #     Y  < 67 DLI 2 2 2 11114< K K K rcc|jS)zf [*immutable*] The number of rows in the table, as specified in the XML file. )rrs rarz Table.nrows rorcc|jS)zl A list of :class:`Field` objects describing the types of each of the data columns. )rrs rarz Table.fields r<rcc|jS)z A list of parameters (constant-valued columns) for the table. Must contain only :class:`Param` objects. rrs rarz Table.params r<rcc|jS)z A list of :class:`Group` objects describing how the columns and parameters are grouped. Currently this information is only kept around for round-tripping and informational purposes. rrs rarz Table.groups s |rcc|jS)z A list of :class:`Link` objects (pointers to other documents or servers through a URI) for the table. rArs rarSz Table.links rorcc|jS)zr A list of :class:`Info` objects for the table. Allows for post-operational diagnostics. rrs rainfosz Table.infos rorcc|jS)z Returns True if this table doesn't contain any real data because it was skipped over by the parser (through use of the ``table_number`` kwarg). )rrs rais_emptyzTable.is_empty rorcrcF|d}|j}t|dkr0tj|fd}tj|fd}n7t |g}|D]I}|j|jkr|j}n|j|jf}| ||j j fJtj|ftj |}g} |j j D]} | dddkrdpd} t| dkr| | d| fIt| d kr$| | d| | dftj|f| }tj|| |_dS) a  Create a new array to hold the data based on the current set of fields, and store them in the *array* and member variable. Any data in the existing array will be lost. *nrows*, if provided, is the number of rows to allocate. NrOrXbr rr mask)rr\nprecarrayrZrKrrrrVrrurYdescrrr) rkrrrrrrYrHr descr_maskr^new_types ra create_arrayszTable.create_arrays s =E v;;!  K444E8UHC000DD    ' ' 'E 7 7>QT))BB.!$/B b!+"456666K@@@EJ[& > >aDGsN2s=vq66Q;;%%qtX&67777VVq[[%%qtXqt&<===8UHJ777DXe$/// rccd|dkrdSttj|tzS)z Return a new (larger) size based on size, used for reallocating an array when it fills up. This is in its own function so the resizing strategy can be easily replaced. ri)rrceil RESIZE_AMOUNT)rksizes ra_resize_strategyzTable._resize_strategy, s/ 1993274-/00111rcct|jf||d|}|j||||dSr)rKrrrVr)rkrqrrrrrs ra _add_fieldzTable._add_field8 PdmDFDDtDD 5!!! Hf%%%%%rcct|jf||d|}|j||||dSrrLrrrVrrkrqrrrrrs rarzTable._add_param= rrcct|f||d|}|j||||dSrrQrrVrrs rarzTable._add_groupB Nd;6s;;d;; 5!!! Hf%%%%%rcctd||d|}|j||||dSNrCrrHrSrVrrkrqrrrrrLs ra _add_linkzTable._add_linkG L36s33d33 $ 8V$$$$$rcc|dstttd||td||d|}|j||||dS)NrrcrrrCr)rrEr.rIrrVrrkrqrrrrrs ra _add_infozTable._add_infoL syzz011 K #s$zTable.parse.. s&&&!&&&rcz*Some specified column numbers out of rangec:g|]}|Sr)index)rGrHnamess rar.zTable.parse.. s#!B!B!BQ%++a..!B!B!Brcz Columns 'z' not found in fields listzInvalid columns list TABLEDATABINARYBINARY2r?rr FITSextnumz'extnum' cannot be negative.rrcrr"rC)3rrrrlrFrrrEr(rrrrr$rr\rrrrKrr rrrangerrrasarray issubclassrYr>integeranyr character TypeError_parse_tabledatar _parse_binaryr?rrBr _parse_fitsr6r.rIrrVr)rkrqrr&r'current_table_number skip_tabler)rrrrrr colnumbersr6rr1s @rarz Table.parseS s**Y''zz.11 %zz*ABB  + * + + +q 0 + + +'L?? #tVSm+++7)#sJLLL+/<4((++DK888**6*BBB# ( V<<<&&v&&& 8eCKK0011JJ'3'' $")j))G'-,bj99 86'A+&&S"&3v;;1F*G*GS$%QRRR$ GM. == 8V!B!B!B!B'!B!B!BJJ!VVV$%T%T%T%TUUUV 6777" Vq)1! ! %sD# k))*; VSQQQ%)%:%:$j&&&& *8TYY[[&#NNN%)%7%7xVVS&&  ))%&<=T)#sF94EvsSSS%)%7%7xVVS&& *6499;;hZXXX;%((A)>)>%?%?F%zz&01O&P&P P *);;;$S"fc:::::;%)%5%5h%O%O %c3VSAAAA D&.   !E3c SF]]%-   !E3c zz"899S!#s,DfcRRR;6s;;d;; !!$''' 8V,,,, sg~~ s/M>>N'8T  !UUc < |dd}|j}|`d|D}d|D}d} t|} fdtt|D} d|D} dgt|z} g}g}|d t}|D]S\}}}}|d kr:| dd}| dd}d}|D]"\}}}}|rA|d dd k}t ||||d gK|d kr|t|kr$ttt|||| |ri |rtj | d}tj |}|d |||j\}}n#t $rH}t#|||dt|||jYd}~nud}~wwxYw |||||\}}nU#t $rH}t#|||dt|||jYd}~nd}~wwxYw|||<|||<nP#t $r!}|dkrt#|||Yd}~n*d}~wwxYwn!|d krn |||||||dz }$|t|kr&tt*|t|f|||t/||t/|t||krl| |z| kr|| } | |z| k| t|krt3|| }||| | |z<||j| | |z<| |z } g}g}I|s|dkrnU| t|z} t3|| }||| d<| dkr ||j| d<| t|z } |j:|jdkr/|j| kr$t9t:t:|j| f||| |_|S)Ninvalidrc&g|]}|jjSr)rrrGrs rar.z*Table._parse_tabledata.. s===U5?(===rcc&g|]}|jjSrrbinparserGs rar.z*Table._parse_tabledata.. CCC5eo.CCCrcrcg|]}|vSrr)rGrrCs rar.z*Table._parse_tabledata.. sGGGq1 ?GGGrcc&g|]}|jjSrrdefaultrFs rar.z*Table._parse_tabledata.. s;;;qq{*;;;rcT chunk_sizeTRencodingbase64TDascii(in row {:d}, col '{}')r r2)rrr\r7DEFAULT_CHUNK_SIZErFrrBrrS b64decodeencoderBytesIOseekreadrrCrurrrrVtuplerrbrrrEr)r)rkrqrCrrrErparsers binparsersnumrows alloc_rowscolnumbers_bits row_default mask_default array_chunk mask_chunkrPrrrrrowrow_maskrrrawdatabufr2 mask_valuers ` rar>zTable._parse_tabledata s **Y 44  J==f===CCFCCC ZZ GGGGE#f++4F4FGGG;;F;;; vF +   ZZ .@AA %-L L  !E3cd{{!!!!n'?-522)E3c1!%*d!;!;x!G*3 VS:,WWWW$;; CKK// (c&kk63 G G G.q1$=#!='-%.282B4;;wCWCW2X2X.0j.A.A(+  ).@M 1 ch@W@W,=E::/8).).).,60106030I0P0P47 4D4DfQil1212 -.-.-.-.-.-.-.-.). ).@J 04fcA.A.,=E::09).).).,60106030I0P0P47 4D4DfQil1212 -.-.-.-.-.-.-.-.)..3CF2z)G"$K!#J sk11s;/// z**%ghh ??#-EJwxx 3{### : !djAoo$*:O:O #sTZ$963 G G G  sm,AJ&?GJ& H+#>H&!J&&H++J&/IJ& J>JJ&JJ&& K0K  Kc d}|D]\}}}}|dkr|rtd|||gdd|vrNd}|dddkr1ttt|dd|||d}t j||||dd} |} n|rXtj| d} tj | } | d | j n|d s!td |j|jt$t&j|} | _| d krt-j|d | } nA| dkrt1j| d} n%td| d|j|jt$| j fd} | S)NFSTREAMr>r3actuaterRexpiresrightsr3TrRrSrUrhttpftpfileBThe vo package only supports remote data through http, ftp or filegziprbfileobjUnknown encoding type 'rcR|}t||krt|Srw)r\EOFError)r`rYr\s ra careful_readz3Table._get_binary_data_stream..careful_read s+T&\\F6{{f$$Mrc)rFrrrEr7r rPrSrXrYrrZr[r\ startswithrBrhrirurllibrequesturlopenrwGzipFilecodecs EncodedFile)rkrqrhave_local_streamrrrrr3rRbuffer string_iofdr~r\s @ra_get_binary_data_streamzTable._get_binary_data_stream\ s<!%-   !E3ch&  TTT T)),0)88J55AA) #S$((:t*D*Dfc $F|,T63???#'88J#=#=!FE+.  %fmmG&<&<==F 6**I NN1   >DD??#:;; $LI' ''--B#v%%tT2>>>BB))+B99BB=(===  +  7D      rcc |j}|||}|j}|`d|D} d} t|} | | kr%|| } t || }g} g} |dkr|t t|dzdz }ttj |t|} t|D](\}}| |r|j dks |j dkrd | |<)t| D]\}} ||\}}nF#t$rt$r/}t|||d | d d ||jd Yd}~nd}~wwxYw| ||dkr| || |p|| |<n#t$rYnnwxYwd|D}d gt|z}|D]}| |||<| |||<t#||| <t#||j| <| dz } t || }|S)Nc&g|]}|jjSrrIrGs rar.z'Table._parse_binary.. rKrcrTr rrF(in row r^, col '')r c&g|]}|jjSrrNrFs rar.z'Table._parse_binary.. s77711;&777rc)rrrr\rrbrrr bitarray_to_bool enumeraterr}rrCrrVr]r)rkmoderqrCrrrr~rr_r`rarow_data row_mask_data mask_bitsrfrJr2 value_maskrrgrhs rar?zTable._parse_binary s33HfEE   JCCFCCC ZZ 3 *$$!22:>> z22HM 199 , S#f++/Q1F-G-G H HI$("3Is6{{KK%%M !*& 1 1551(+5J&00AJ-4O4O/4M!,#,Z#8#8JJKAx ,4H\,B,B)zz#$""IwIIIIII OOE***qyy%,,Z8888+8+;+Iz a((!J"    87777CwV,H / /!!A+A. "3ZZE'N"'//EJw  qLGg3 jw'' s>5B,F7"D10F71E4%E/*F7/E44AF77 GGc |D]W\}}}}|dkrJ|rFtd|||gd|d}|dd} UnX|ds!t d|j|jttj |} | _| dkrtj |d| } nA| d krtj| d } n%t d | d |j|jttj| } | t#|j} | j|jjkr't+t,t,d |j|j| S)Nrmrnr3rRrrrvrwrryrSr{rr)rFrrrrBrhrirrrrrwrrrropenrrrYrrEr*) rkrqr6rrrrrr3rRrhdulistrs rar@zTable._parse_fits s%-   !E3ch &  TTT  >$(VWW   0 0+ -)9 EEE $ T[9 - - *--GNN2t,,,,-x$(Kdk4:#V44K#.44&q33F333344./ *T]668899??EEd|E||444 Q))&)))4: ;UU6]];;,,--a::6::::8++**1a::6::::9,,**1a::6::: ;;;;;;;;;;;;;;;,- 0#{00G"GN1//////? 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0s8DG/*AF7+ G/7F; ;G/>F; ?#G//G36G3c j|j}|j}|d5|trqds\fd|D}d|D}t |jdz }tj |j |j |j |||dni|j }| }|dz} |dz} |d z} |d z} fd t|D}tt |D]} || |j | }|j | }|D]\}}}||}||}|r t!j|r || 8 |||}nL#t$$r?}t'|d | |j|j Yd}~nd}~wwxYwt |r|| ||| || ddddS#1swxYwYdS)Nr2_debug_python_based_parsercDg|]}|jSr)rsupports_empty_values)rGrrs rar.z*Table._write_tabledata..A s6)))FKEO99&AA)))rcc&g|]}|jjSr)rrrGs rar.z*Table._write_tabledata..D sEEEU%/0EEErcr rVz z z {} z cdg|],\}}||jj|jf-Sr)rrr)rGrrrs rar.z*Table._write_tabledata..V sO !5 .==fEErcrV additional)rrr_flush_has_c_tabledata_writerrr\_tagsrGwrite_tabledatawriterrget_indentation_spacesrr7rallrrCrur)rkrrrrrindentr indent_spacestr_starttr_endtdtd_emptyrg array_rowmask_rowrrrr]rZrs ` rarzTable._write_tabledata: s  UU;  7 "7 " HHJJJ&5 "vzz:V/W/W5 "))))OU)))%FEfEEEQW)+GJJ) ! 8 8 : : (83&2"%55(:5 %.f$5$5 !U,,""CE(OOO % 3I$z#H0&0&!"!"!"!"!"!"!"!"!"" #3xx0 %biinn 5 5 5 5 %hE&MMMMo7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "7 "s=EH(; FH( G 5G H( G A H((H,/H,c *|j}|j}|dkrd}nd}||5|dd5dt|D}t j}t t|D]} |j| } |j | } |dkrEtjd | D} | tj | |D]\} } || | | | }t|tksJn;#t $r.}t#|d | d d || jd Yd}~nd}~wwxYw| ||| t)j|ddddn #1swxYwYddddS#1swxYwYdS)Nr r3r4rmrS)rRc0g|]\}}||jjfSr)r binoutput)rGrrs rar.z'Table._write_binary.. s3   7A5Q12   rcr c6g|]}tj|Sr)rrrFs rar.z'Table._write_binary.. s -L-L-LAbfQii-L-L-Lrcrr^rrrrU)rrrrrrZr7r\rrrrr bool_to_bitarrayr>rrrCrrrS b64encoderdecode)rkrrrrrtag_name fields_basicrrgr array_mask flattenedrrchunkrs rarzTable._write_binaryw s  199HH H UU8__ K Kx(33 K K  ENvEVEV    z|| U,,**C % 3I!&CJqyy$&H-L-L-L-L-L$M$M  :#>y#I#IJJJ(4** 9$-IilJqM$J$JE#';;%#7#7#7#7#7(& !.W.W.W.Wvay|.W.W.W 5))))* (99@@IIJJJ3 K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K K KsaHB7G0?2D21G02 E* <$E% G0%E* *A:G0$ H0G4 4H7G4 8HH H Fcddlm}i}dD]}t||d}||||<|rWd|jD}g}t |D]1\}} | } d}| |vr| |} |dz }| |v|| 2|}nd|jD}||j|| } t||jD]"\} } | | } | | #| S) a Convert this VO Table to an `astropy.table.Table` instance. Parameters ---------- use_names_over_ids : bool, optional When `True` use the ``name`` attributes of columns as the names of columns in the `astropy.table.Table` instance. Since names are not guaranteed to be unique, this may cause some columns to be renamed by appending numbers to the end. Otherwise (default), use the ID attributes as the column names. .. warning:: Variable-length array fields may not be restored identically when round-tripping through the `astropy.table.Table` instance. r)rR)rrrlr rrNcg|] }|j Sr)rrGs rar.z"Table.to_table.. s999EUZ999rcr r cg|] }|j Srr-rGs rar.z"Table.to_table.. s777%UX777rc)r1rT) astropy.tablerRrgrrrVrzipr[)rkuse_names_over_idsrRrTrYrZr1 unique_namesrrrrrrXs rarzTable.to_table sP& ('''''G  C$T**CS  899T[999EL$U++ . .4,.."&|||HFA,..##H---- EE774;777EdjD999udk22 * *KD%4[F  ! !& ) ) ) ) rcci}dD]#}|j|}||||<$||fi|}d|jvr|jd|_|jD]=}||}|jt ||>|j,tj tj ||_ nDtj tj |tj |j|_ |S)z` Create a `Table` instance from a given `astropy.table.Table` instance. rNrr) rTrrcolnamesrrVrKr_rrrrr8) r]rrrrYrZ new_tablecolnamerXs ra from_tablezTable.from_table s  8 " "C*..%%C!s C**6** EJ & &$)J}$=I !~ N NG7^F   # #E$;$;GV$L$L M M M M :  hrz%'8'899IOO hrz%'8'8rz%*?U?UVVVIOrcc#K|jEd{V|jEd{V|jD]}|Ed{VdS)z] Recursively iterate over all FIELD and PARAM elements in the TABLE. N)rrrrrkrs rarzTable.iter_fields_and_params s~ ;;[ 6 6E3355 5 5 5 5 5 5 5 5 6 6rcrTrzFIELD or PARAMzD Looks up a FIELD or PARAM element by the given ID. zL Looks up a FIELD or PARAM element by the given ID or name. rz| Looks up a FIELD or PARAM element by the given utype and returns an iterator emitting all matches. c#ZK|jD] }|V|Ed{V!dS)zK Recursively iterate over all GROUP elements in the TABLE. N)rrrs rarzTable.iter_groups sS[ + +EKKK((** * * * * * * * * + +rcrrzh Looks up a GROUP element by the given ID. Used by the group's "ref" attribute zs Looks up a GROUP element by the given utype and returns an iterator emitting all matches. c#$K|jEd{VdSrw)rrs ra iter_infozTable.iter_info+ s&:rc) NNNNNNNNN)rN)F)0rrrryr rrrrrlrrrurrrrrSrrr rrrrrr$rr>rr?r@rrrrrarrr|get_field_by_idrget_field_by_id_or_nameget_fields_by_utyperget_group_by_idget_groups_by_utyperrrcrarRrR1 s0      -?-?-?-?^%%%&&&$$$X ZZ8 [[X  ]](XXXXXX&0&0&0&0P 2 2 2&&& &&& &&& %%% %%%RRRhsssj===~EEEN,,,\(0(0(0T;";";"z"K"K"KH////b[2666.-    O<;  21    +++.-    O21   rcrRceZdZdZ d dZdZedZejdZedZ ed Z ed Z ed Z ed Z ed ZedZedZedZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dS)!rSz RESOURCE_ element: Groups TABLE_ and RESOURCE_ elements. The keyword arguments correspond to setting members of the same name, documented below. Nresultsc |i}||_||_t|||_t |||||_||_||_||_ d|_ tt|_ tt|_tt |_tt$|_tt(|_tt,|_tt0|_tt4|_t9d|||dS)Nr+)rhrirUr rrrrr>_extra_attributesrrrM_coordinate_systemsrN _time_systemsrQrrLrrIrrHr rR_tablesrS _resourcesrFr) rkrrrr>rrrrs rar zResource.__init__9 s >F   RVS11  !'#26#:#: ,W55&u-- &u-- %d++ %d++ &u-- )(33:v{{}}fcBBBBBrcctj}t|}||j|||j|Sr) rrrrnrrrrr)rkrrs rarzResource.__repr__\ s[{}} dOO $$Q^^D$/-R-R SSS}}$$&&&rcc|jS)aThe type of the resource [*required*]. Must be either: - 'results': This resource contains actual result values (default) - 'meta': This resource contains only datatype descriptions (FIELD_ elements), but no actual data. rrs rar>z Resource.typeb rrcc^|dvr!tt||j|j||_dS)N)rrT)rBrrhrirrs rar>z Resource.typep rrcc|jS)aJDictionary of extra attributes of the RESOURCE_ element. This is dictionary of string keys to string values containing any extra attributes of the RESOURCE_ element that are not defined in the specification. The specification explicitly allows for extra attributes here, but nowhere else. )rrs raextra_attributeszResource.extra_attributesv s %%rcc|jS)z A list of coordinate system definitions (COOSYS_ elements) for the RESOURCE_. Must contain only `CooSys` objects. rrs racoordinate_systemszResource.coordinate_systems ''rcc|jS)z A list of time system definitions (TIMESYS_ elements) for the RESOURCE_. Must contain only `TimeSys` objects. rrs ra time_systemszResource.time_systems !!rcc|jS)z A list of informational parameters (key-value pairs) for the resource. Must only contain `Info` objects. rrs rarzResource.infos rorcc|jS)z# A list of groups. rrs rarzResource.groups s |rcc|jS)z~ A list of parameters (constant-valued columns) for the resource. Must contain only `Param` objects. rrs rarzResource.params r<rcc|jS)z A list of links (pointers to other documents or servers through a URI) for the resource. Must contain only `Link` objects. rArs rarSzResource.links s {rcc|jS)z_ A list of tables in the resource. Must contain only `Table` objects. )rrs ratableszResource.tables r<rcc|jS)zq A list of nested resources inside this resource. Must contain only `Resource` objects. rrs ra resourceszResource.resources rcct|jf||d|}|j||||dSr)rRrrrVr)rkrqrrrrrs ra _add_tablezResource._add_table rrcctd||d|}|j||||dSrrIrrVrr#s rar$zResource._add_info r rcct|f||d|}|j||||dSrrrs rarzResource._add_group rrcct|jf||d|}|j||||dSrrrs rarzResource._add_param rrcctd||d|}|j||||dSrrMrrVrrkrqrrrrcoosyss ra _add_coosyszResource._add_coosys M7v377$77 &&v... Xv&&&&&rcctd||d|}|j||||dSrrNrrVrrkrqrrrrtimesyss ra _add_timesyszResource._add_timesys M9S99D99   ))) h'''''rcctd||d|}|j|||j||dSr)rSrrVrrrkrqrrrrresources ra _add_resourcezResource._add_resource sP;6s;;d;; h'''t}h77777rcctd||d|}|j||||dSrrrs rarzResource._add_link r rcc l||_|j|j|j|j|j|j|j|j|j d }|D]n\}}}}|r)| ||j |||||2|dkr.|j tttd|||pd|_ f|dkrno|`|S)N) rrcrrrerr+r5rDrDr+)rrr$rrr rrrrrrrrEr() rkrrqrrrrrrs rarzResource.parse s _N__&(*N+   &.   !E3c ; T%:;;c4 %%#/!#sJDDD#'<4   ""# M rcc ||d}||j|d|5|j|d|jd|j|j|j|j |j |j |j fD]}|D]}|j |fi| ddddS#1swxYwYdS)N)rr>rr+rrDTrN)rrrrrrnrrrrrSrrr)rkrrattrsrrns rarzResource.to_xmls7t%<== T*+++ UU:eU , , 0 0+ -)9 EEE'!      0 0  +00G"GN1//////0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0sA'B==CCc#lK|jEd{V|jD]}|Ed{VdS)zd Recursively iterates over all tables in the resource and nested resources. N)rrrrkrs rarzResource.iter_tablessd ; . .H++-- - - - - - - - - . .rcc#K|jEd{V|jD]}|Ed{V|jD]}|Ed{VdS)z Recursively iterates over all FIELD_ and PARAM_ elements in the resource, its tables and nested resources. N)rrrrrkrrs rarzResource.iter_fields_and_params#s ;[ 6 6E3355 5 5 5 5 5 5 5 5 9 9H6688 8 8 8 8 8 8 8 8 9 9rcc#lK|jEd{V|jD]}|Ed{VdS)zr Recursively iterates over all the COOSYS_ elements in the resource and nested resources. Nrr iter_coosysrs rarzResource.iter_coosys.e ******** . .H++-- - - - - - - - - . .rcc#lK|jEd{V|jD]}|Ed{VdS)zs Recursively iterates over all the TIMESYS_ elements in the resource and nested resources. Nrr iter_timesysrs rar#zResource.iter_timesys7e $$$$$$$$ / /H,,.. . . . . . . . . / /rcc#K|jEd{V|jD]}|Ed{V|jD]}|Ed{VdS)zp Recursively iterates over all the INFO_ elements in the resource and nested resources. N)rrrrrs rarzResource.iter_info@s :[ ) )E(( ( ( ( ( ( ( ( ( , ,H))++ + + + + + + + + , ,rc)NNNrNNN)!rrrryr rrr>rrrrrrrrSrrrr$rrr rrrrrrrrr#rrrcrarSrS/ si    !C!C!C!CF'''   X  [[ &&X&((X(""X"XX XXXX&&& %%% &&& &&& ''' ((( 888 %%% >000$... 9 9 9.../// , , , , ,rcrSceZdZdZdJdZdZedZejdZedZ ed Z ed Z ed Z ed Z ed ZdZdZdZdZdZdZdZdddddddddddddddddZdZ dKd Zd!Zd"Zed#d$d%d&d'Zed(dd%d&d)Zd*Zd+Zed#d$d,d-d.Z ed(dd,d-d/Z!e"d,d-d0Z#d1Z$ed#d$d2d3d4Z%d5Z&ed#d$d6d7d8Z'ed(dd6d7d9Z(d:Z)ed#d$d;dZ+ed#d$d?d@dAZ,dBZ-ed#d$dCdDdEZ.edFddCdDdGZ/dHZ0e1dLdIZ2dS)MrTa VOTABLE_ element: represents an entire file. The keyword arguments correspond to setting members of the same name, documented below. *version* is settable at construction time only, since conformance tests for building the rest of the structure depend on it. N1.4c|i}||_||_t|t |||||_d|_tt|_ tt|_ tt|_ tt|_tt |_tt$|_t)|}|dkrt+jdt.n<|dkr6||jvr-d|j}t5d|d||_dS)Nz1.0zXVOTable 1.0 support is deprecated in astropy 4.3 and will be removed in a future release', 'z 'version' should be in ('1.0', 'z').)rhrirUr rrrrrMrrNrrLrrIrrSrrQrrwarningsrr_version_namespace_maprJr_version)rkrrrrrallowed_from_maps rar zVOTableFile.__init__Ws3 >F  RVS11#26#:#: ,W55&u-- %d++ )(33&u-- g,, e   M.)     WD4O%O%O%{{4+FGG U@PUUUVV V rccjtt|}d|dS)Nz ... z tables ...)r\rr)rkn_tabless rarzVOTableFile.__repr__us4tD,,..//00>x>>>>rcc|jS)zN The version of the VOTable specification that the file uses. )r,rs rarzVOTableFile.versionys }rcct|}||jvr-d|j}td|d||_dS)Nr)z3astropy.io.votable only supports VOTable versions 'r)rr+rJrr,)rkrr-s rarzVOTableFile.versionsfg,, $5 5 5%{{4+FGG )%)))   rcc|jS)zu A list of coordinate system descriptions for the file. Must contain only `CooSys` objects. rrs rarzVOTableFile.coordinate_systemsrrcc|jS)zp A list of time system descriptions for the file. Must contain only `TimeSys` objects. rrs rarzVOTableFile.time_systemsrrcc|jS)z A list of parameters (constant-valued columns) that apply to the entire file. Must contain only `Param` objects. rrs rarzVOTableFile.paramsr<rcc|jS)z A list of informational parameters (key-value pairs) for the entire file. Must only contain `Info` objects. rrs rarzVOTableFile.infosrorcc|jS)zz A list of resources, in the order they appear in the file. Must only contain `Resource` objects. rrs rarzVOTableFile.resourcesrrcc|jS)z A list of groups, in the order they appear in the file. Only supported as a child of the VOTABLE element in VOTable 1.2 or later. rrs rarzVOTableFile.groupss |rcct|f||d|}|j||||dSr)rLrrVrrs rarzVOTableFile._add_paramrrcctd||d|}|j|||||dSr)rSrrVrrs rarzVOTableFile._add_resourcesN;6s;;d;; h'''tXv.....rcctd||d|}|j||||dSrrrs rar zVOTableFile._add_coosysr rcctd||d|}|j||||dSrr r s rarzVOTableFile._add_timesysrrcctd||d|}|j||||dSrrr#s rar$zVOTableFile._add_infor rcc|dstttd||t|f||d|}|j||||dS)Nr)rVOTABLErrC)rrEr.rQrrVrrs rarzVOTableFile._add_groups{zz011 N #s$? M M Md;6s;;d;; 5!!! Hf%%%%%rcci}tj|jddk|d<tj|jddk|d<tj|jddk|d<tj|jddk|d <|S) N1.1rrrr1.3r?r'r)r version_comparer)rkrs rarzVOTableFile._get_version_checkss)-)=dlE)R)RVW)W%&)-)=dlE)R)RVW)W%&)-)=dlE)R)RVW)W%&)-)=dlE)R)RVW)W%& rcz$http://www.ivoa.net/xml/VOTable/v1.1zxsi:noNamespaceSchemaLocation) namespace_urischema_location_attrschema_location_valuez$http://www.ivoa.net/xml/VOTable/v1.2z$http://www.ivoa.net/xml/VOTable/v1.3zxsi:schemaLocationzThttp://www.ivoa.net/xml/VOTable/v1.3 http://www.ivoa.net/xml/VOTable/VOTable-1.3.xsdzThttp://www.ivoa.net/xml/VOTable/v1.3 http://www.ivoa.net/xml/VOTable/VOTable-1.4.xsd)r@rrAr'c d|d<|D]\}}}}|r}|dkr|dkrXd|vr-ttt|j|||j|d<n|dx|d<|_|ddr=tt t |d|||dddx|_|d<|d|jvrtt|d||d|vrb|j |di}| d }|d|krtt||df||nttd ||nttd |||||j|j|j|j|j|j|j|jd } |D]e\}}}}|r)| ||j|||||2|d kr-|jtt6t6d|||pd|_ft9|js%|d rtt<t<d |||S)Nrr(xmlr>rvr xmlnsrCr)rr+rerrc DEFINITIONSrDrrDr)rEr+rr,rrr1r+rDr,rr9r:rBrrrrrr rr$rrrrrr(r\rr@) rkrqrrrrrns_info correct_nsrs rarzVOTableFile.parses*+&'%- 3 3 !E3c 3%<<I%% ,,%c3 fcJJJ,0Ly))<@OKy)DM!),2244??DDV)#sF94EvsSSS@Fy@QRSRTRT@UUDMF9,=!),D4OOO#C ):FCHHH$"&"="A"A&BSUW"X"X%,[[%A%A =J66#C*d7m)DfcRRRR555ES"fc222 d..00111_*&(N0+_   &. 0 0 !E3c 0; T%:;;c4 %%#/!#sIvsCCC#'<4 4>"" 5v.D'E 5 #sB 4 4 4 rcFc |.|dvrtdtd|j||dd}||t j||5}t|}|j}|t} n|} d} | | jdit|d d } |j |i} | d } | r| | d <| d }| d}|r|r|| |<|d| 5|j|d|jd|j|j|j|j|jg}|dr |j|d<|D]}|D]}|j|fi| dddn #1swxYwYddddS#1swxYwYdS)a Write to an XML file. Parameters ---------- fd : str or file-like Where to write the file. If a file-like object, must be writable. compressed : bool, optional When `True`, write to a gzip-compressed file. (Default: `False`) tabledata_format : str, optional Override the format of the table(s) data to write. Must be one of ``tabledata`` (text representation), ``binary`` or ``binary2``. By default, use the format that was specified in each `Table` object as it was created or read in. See :ref:`astropy:votable-serialization`. N)rrrzUnknown format type 'rr )rrr _group_number) compressedz z)http://www.w3.org/2001/XMLSchema-instance)rz xmlns:xsirCrIrDrEr>rDTrNrrr)rrrurrrr convert_to_writable_filelikerastropy_versionrlstriplocalsr+rrrrnrrrrrrr)rkrrOrr_astropy_versionrrr lib_version xml_header votable_attrrKrCrDrE element_setsrrns rarzVOTableFile.to_xmlIs6  '%%''/QQQ !B!B!B!BCCC| 0*D     d..00111  .rj I I I* 4R" AlG'- . &J GG.J%%''.:::: ; ; ;#HL155grBBG#KK88M 6(5 W%#*;;/E#F#F $+KK0G$H$H !# K(= K5J 12y,// 4 4#/IImT-=DIIII+%KJN   012&*kLO#/44K#.44&q33F333344 4 4 4 4 4 4 4 4 4 4 4 4 4 4 49* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4* 4s8:C(G6"A/G G6G" "G6%G" &G66G:=G:c#RK|jD]}|Ed{VdS)z~ Iterates over all tables in the VOTable file in a "flat" way, ignoring the nesting of resources etc. N)rrrs rarzVOTableFile.iter_tablessJ  . .H++-- - - - - - - - - . .rcc~|D]}|s|cStd)z Often, you know there is only one table in the file, and that's all you need. This method returns that first table. zNo table found in VOTABLE file.)rr IndexErrorrkrs raget_first_tablezVOTableFile.get_first_tablesN %%''  E>>##   :;;;rcrTrrzh Looks up a TABLE_ element by the given ID. Used by the table "ref" attribute. rzu Looks up a TABLE_ element by the given utype, and returns an iterator emitting all matches. ct|D]\}}||kr|cStd|dd)zB Get a table by its ordinal position in the file. zNo table at index r^z found in VOTABLE file.)rrr[)rkidxrrs raget_table_by_indexzVOTableFile.get_table_by_indexs_"$"2"2"4"455  HAuCxx LcLLLLMMMrcc#RK|jD]}|Ed{VdS)zg Recursively iterate over all FIELD_ and PARAM_ elements in the VOTABLE_ file. N)rrrs rarz"VOTableFile.iter_fields_and_paramssJ  9 9H6688 8 8 8 8 8 8 8 8 9 9rcrrzk Looks up a FIELD_ element by the given ID_. Used by the field's "ref" attribute. zt Looks up a FIELD_ element by the given utype and returns an iterator emitting all matches. zE Looks up a FIELD_ element by the given ID_ or name. c#JK|D] }|jV dS)z] Recursively iterate over all VALUES_ elements in the VOTABLE_ file. N)rrrs ra iter_valueszVOTableFile.iter_valuess> 0022  E,      rcrcrzj Looks up a VALUES_ element by the given ID. Used by the values "ref" attribute. c#lK|D]}|Ed{VdS)z\ Recursively iterate over all GROUP_ elements in the VOTABLE_ file. N)rrr\s rarzVOTableFile.iter_groupssT %%'' + +E((** * * * * * * * * + +rcrrzi Looks up a GROUP_ element by the given ID. Used by the group's "ref" attribute zt Looks up a GROUP_ element by the given utype and returns an iterator emitting all matches. c#lK|jEd{V|jD]}|Ed{VdS)z] Recursively iterate over all COOSYS_ elements in the VOTABLE_ file. Nrrs rarzVOTableFile.iter_coosys$r rcrrez+Looks up a COOSYS_ element by the given ID.c#lK|jEd{V|jD]}|Ed{VdS)z^ Recursively iterate over all TIMESYS_ elements in the VOTABLE_ file. Nr"rs rar#zVOTableFile.iter_timesys5r$rcr#rz,Looks up a TIMESYS_ element by the given ID.c#lK|jEd{V|jD]}|Ed{VdS)z[ Recursively iterate over all INFO_ elements in the VOTABLE_ file. N)rrrrs rarzVOTableFile.iter_infoFsd : , ,H))++ + + + + + + + + , ,rcrrcz(Looks up a INFO element by the given ID.rz.Returns all INFO children with the given name.cB|D] }||_ dS)zJ Set the output storage format of all tables in the file. N)rru)rkrurs raset_all_tables_formatz!VOTableFile.set_all_tables_format[s2%%'' " "E!ELL " "rcc|}t}t||}|||_|j||j||S)z Create a `VOTableFile` instance from a given `astropy.table.Table` instance. Parameters ---------- table_id : str, optional Set the given ID attribute on the returned Table instance. )rSrRrrrrVr)r]rr) votable_filerrs rarzVOTableFile.from_tablebsmsuu ::""<77  !GJw'''%%h///rc)NNNNr')FNFNrw)3rrrryr rrrrrrrrrrrrr rr$rrr+rrrr]r|rget_tables_by_utyper`rrrrrrcrrrrrget_coosys_by_idr#get_timesys_by_idrget_info_by_idget_infos_by_namerirarrrcrarTrTLs    <???X  ^  ^ ((X(""X"XXXX&&& /// ''' ((( %%% &&&D$C%K  D$C%K  D$8C   D$8C   A((T888z#( Q4Q4Q4Q4f...<<<.-    O21   NNN999.-     O21    <;  /.    +++.-    O21   .../.  9 ///0/  : ,,,-, dK)WN0/ < """[rcrT)NN){rSrrwrrurllib.requestrr*numpyrrrrrQ astropy.iorastropy.utils.collectionsrastropy.utils.exceptionsrastropy.utils.xml.writerrrr r rr r exceptionsrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGr ImportError__all__rWrrbr|rrrrrrrrrrrrrrUr rrHrIrJrKrLrMrNrOrPrQrRrSrTrrcrarzs  322222555555>>>>>>......::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::x$"$$$#$   (   BBBJ! ! ! H   0.!!!!L&         (4:!!!!!!!!(5$5$5$5$5$5$5$5$pTTTTTGTTT6)))))})))X}}}}}=+}}}@mDmDmDmDmD #[..mDmDmD`E:E:E:E:E:WkE:E:E:P ZZZZZ ZZZzN N N N N EN N N b|||||]|||~C!C!C!C!C!mC!C!C!L?T?T?T?T?T}nl?T?T?TD>U>U>U>U>U}nl>U>U>UBZ/Z/Z/Z/Z/  Z/Z/Z/z{{{{{G[-?S{{{|Z,Z,Z,Z,Z, [-9MZ,Z,Z,zhhhhh';(<hhhhhsCC#"C#