[c@`sddlmZmZmZmZddlmZddlmZm Z ddl m Z m Z m Z ddlZddlZddlmZmZddlZdd lmZddlZdd lmZdd lmZdd lmZdd lmZm Z ddl!m"Z"m#Z#ddl$m%Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,m-Z-m.Z.m/Z/ddlm0Z0ddl1m2Z2ddl3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9ddl:m;Z;ddl<m=Z=m>Z>ddl?m@Z@ddl mAZAmBZBmCZCddlmDZDddddgZEdeFfd YZGd!ZHd"ZId#efd$YZJd%eKfd&YZLd'eLfd(YZMd)ejNfd*YZOdS(+i(tabsolute_importtdivisiontprint_functiontunicode_literalsi(tsix(tziptrangei(t TableIndicestTableLoct TableILocN(t OrderedDicttMapping(tdeepcopy(tma(tlog(tregistry(tQuantityt QuantityInfo(t isiterabletShapedLikeNDArray(t broadcast_to(t color_print(tMetaData(tBaseColumnInfot MixinInfotParentDtypeInfotDataInfo(tgroups(tTableFormatter(t BaseColumntColumnt MaskedColumnt _auto_namest FalseArraytcol_copy(tRow(tfix_column_nametrecarray_fromrecords(t TableInfo(tIndext_IndexModeContextt get_index(tconfu Table.readu Table.writeu#Table.convert_bytestring_to_unicodeu#Table.convert_unicode_to_bytestringtTableReplaceWarningcB`seZdZRS(u  Warning class for cases when a table column is replaced via the Table.__setitem__ syntax e.g. t['a'] = val. This does not inherit from AstropyWarning because we want to use stacklevel=3 to show the user where the issue occurred in their code. (t__name__t __module__t__doc__(((s2lib/python2.7/site-packages/astropy/table/table.pyR+*scC`sY|jjdkrdn |jj}t|dr@|jdnd}|jj||fS(uArray-interface compliant full description of a column. This returns a 3-tuple (name, type, shape) that can always be used in a structured array dtype definition. uOushapeiN((tinfotdtypetNonethasattrtshapetname(tcolt col_dtypet col_shape((s2lib/python2.7/site-packages/astropy/table/table.pytdescr5s$"cC`st|dot|j|S(Nuinfo(R2t isinstanceR/(tobjtcls((s2lib/python2.7/site-packages/astropy/table/table.pythas_info_class@st TableColumnscB`sbeZdZidZdZdZdZdZdZdZ dZ d Z RS( uBOrderedDict subclass for a set of columns. This class enhances item access to provide convenient access to columns by name or index, including slice access. It also handles renaming of columns. The initialization argument ``cols`` can be a list of ``Column`` objects or any structure that is valid for initializing a Python dict. This includes a dict, list of (key, val) tuples or [key, val] lists, etc. Parameters ---------- cols : dict, list, tuple; optional Column objects as data structure that can init dict (see above) cC`st|ttfrmg}xF|D]>}t|trS|j|jj|fq"|j|q"W|}ntt |j |dS(N( R9tlistttupleR<RtappendR/R4tsuperR=t__init__(tselftcolstnewcolsR5((s2lib/python2.7/site-packages/astropy/table/table.pyRBUs  cC`st|tjr"tj||St|ttjfrH|j|St|tj r|j dkr|j j dkr|j|j St|tr|jg|D]}||^qSt|tr|jgt||D]}||^qStdj|jjdS(u?Get items from a TableColumns object. :: tc = TableColumns(cols=[Column(name='a'), Column(name='b'), Column(name='c')]) tc['a'] # Column('a') tc[1] # Column('b') tc['a', 'b'] # tc[1:3] # uiu(Illegal key or index value for {} objectN((R9Rt string_typesR t __getitem__tinttnptintegertvaluestndarrayR3R0tkindtitemR?t __class__tsliceR>t IndexErrortformatR,(RCRNtx((s2lib/python2.7/site-packages/astropy/table/table.pyRGbs 3$. cC`sA||kr$tdj|ntt|j||dS(NuACannot replace column '{0}'. Use Table.replace_column() instead.(t ValueErrorRRRAR=t __setitem__(RCRNtvalue((s2lib/python2.7/site-packages/astropy/table/table.pyRUzs  cC`s8dtj|D}djdj||jjS(Ncs`s|]}dj|VqdS(u'{0}'N(RR(t.0RS((s2lib/python2.7/site-packages/astropy/table/table.pys su<{1} names=({0})>u,(RtiterkeysRRtjoinROR,(RCtnames((s2lib/python2.7/site-packages/astropy/table/table.pyt__repr__scC`s||krdS||kr4tdj|ni||6}g|D]}|j||^qH}ttj|}|j|jtt||dS(NuColumn {0} already exists( tKeyErrorRRtgetR>Rt itervaluestcleartupdateR(RCR4tnew_nametmappert new_namesRD((s2lib/python2.7/site-packages/astropy/table/table.pyt_rename_columns   % cC`sttj|S(N(R>R tkeys(RC((s2lib/python2.7/site-packages/astropy/table/table.pyRescC`sttj|S(N(R>R RK(RC((s2lib/python2.7/site-packages/astropy/table/table.pyRKscC`s2g|jD]}t||r |^q }|S(u{ Return a list of columns which are instances of the specified classes. Parameters ---------- cls : class or tuple of classes Column class (including mixin) or tuple of Column classes. Returns ------- col_list : list of Columns List of Column objects which are instances of given classes. (RKR9(RCR;R5RD((s2lib/python2.7/site-packages/astropy/table/table.pyR9s.cC`s2g|jD]}t||s |^q }|S(u Return a list of columns which are not instances of the specified classes. Parameters ---------- cls : class or tuple of classes Column class (including mixin) or tuple of Column classes. Returns ------- col_list : list of Columns List of Column objects which are not instances of given classes. (RKR9(RCR;R5RD((s2lib/python2.7/site-packages/astropy/table/table.pytnot_isinstances.( R,R-R.RBRGRUR[RdReRKR9Rf(((s2lib/python2.7/site-packages/astropy/table/table.pyR=Ds       tTablec B`seZdZeZeZeZeZeZe Z e dZ d_d_d_d_d_e d_e dZdZdZedZejdZedZd_dZed Zed Zed Zd_e d Zd ZdZd_dZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&e'dZ(dZ)e d_d_d_e d_d_dZ*dZ+dZ,dZ-e.j/se-Z0nd Z1e.j/re1Z0ned!Z2d"Z3d_d_e d_e d_d#Z4d$Z5d_d_d%d&d'd(Z6d)e d*ie d+6d_d,d_d'd-Z7d_d_e d_e e d_d_d_d. Z8d_d_e d_e d/Z9d0Z:d1Z;d2Z<d3Z=ed4Z>e>jd5Z>d6Z?ed7Z@ed8ZAed9ZBd:ZCd;ZDd<ZEd_d_e d=ZFd_d_e e d>ZGd?ZHd@ZIdAZJdBZKdCZLdDZMdEZNe dFZOe dGZPdHZQdIZRd_d_dJZSd_d_dKZTdLZUd_d_dMZVd_dNZWdOZXeYdPZZdQZ[e dRZ\d_dSZ]dTZ^dUZ_dVZ`dWZadXZbdYZcdZZded[Zed\Zfd]ZgeYd^ZheiZjRS(`u=A class to represent tables of heterogeneous data. `Table` provides a class for heterogeneous tabular data, making use of a `numpy` structured array internally to store the data values. A key enhancement provided by the `Table` class is the ability to easily modify the structure of the table by adding or removing columns, or adding new rows of data. In addition table and column metadata are fully supported. `Table` differs from `~astropy.nddata.NDData` by the assumption that the input data consists of columns of homogeneous data, where each column has a unique identifier and may contain additional metadata such as the data unit, format, and description. Parameters ---------- data : numpy ndarray, dict, list, Table, or table-like object, optional Data to initialize table. masked : bool, optional Specify whether the table is masked. names : list, optional Specify column names. dtype : list, optional Specify column data types. meta : dict, optional Metadata associated with the table. copy : bool, optional Copy the input data. If the input is a Table the ``meta`` is always copied regardless of the ``copy`` parameter. Default is True. rows : numpy ndarray, list of lists, optional Row-oriented data for table instead of ``data`` argument. copy_indices : bool, optional Copy any indices in the input data. Default is True. **kwargs : dict, optional Additional keyword args when converting table-like object. c C`s't|jdkrd Sd tjdk}d|f}g}|jj}x|D]w}t|}|jjj}| r||krt j|dj d} |d| |df}n|j |qTW|j rt jnt j} | t|d|} x|D]}|| |jjuu<(tlentcolumnsR1tsyst byteorderRKR8R/R0RIt newbyteorderR@tmaskedR temptyR4( RCtkeep_byteordert sys_byteordert native_orderR0RDR5t col_descrRktnew_dtt empty_inittdata((s2lib/python2.7/site-packages/astropy/table/table.pytas_arrays$    c K`s|j||j|_||_|j|_t|_||_d|_ | rq|dk rqt dnt } |dk r|dk rt dnt d|Drt} |}qt||jr|}qt|} g| jjD]} | | ^q}nd} t|drF|j|j|| }t }n.| rttdjt| jdnt|tjr|jd kr|jj rd}nt||jr|j|j|jd!}nt|ttfr<|j }|r-| st d|Dr-t!|d}q+t!|}nt|tjr|jjr|j"}t!|jj}|jj} q+|j"}|jdkrt d n1t!|jdkr|tj#ddf}n|jd}n?t|t$r|j%}t|} t!| }n t|t&rg|j'}t!|j(}|j(} |jo^|j|_n|dkr|dkr|dkrdSy9tj|}|j}g|D]} || ^q}Wqt)k rt d qXn|j }t!|}gg|}nt d jt*||dkrM| pGdg|}n|dkridg|}ng|D]} t+| ^qp}|j,|||||||||t*|j-t.k rtd ndS(Nu$Cannot specify dtype when copy=Falseu+Cannot supply both `data` and `rows` valuescs`s|]}t|tVqdS(N(R9tdict(RWtrow((s2lib/python2.7/site-packages/astropy/table/table.pys 2su__astropy_table__u/__init__() got unexpected keyword argument {!r}iics`s|]}t|tVqdS(N(R9Rw(RWRx((s2lib/python2.7/site-packages/astropy/table/table.pys Vsu(Can not initialize a Table with a scalaru<dtype was specified but could not be parsed for column namesu'Data type {0} not allowed to init Tableu1masked property has not been set to True or False(i((/t _set_maskedR=RitmetaRt formattertTruet _copy_indicest _init_indicesR1t primary_keyRTtFalsetallR9R#R%R0RZR2t__astropy_table__ROt TypeErrorRRR>ReRIRLR3t_tablet_indexR?t_init_from_listRht_init_from_ndarraytnewaxisR t_init_from_dictRgt_init_from_tabletcolnamest ExceptionttypeR$t_check_names_dtypeRmtbool(RCRuRmRZR0Rztcopytrowst copy_indicestkwargstis_list_of_dicttrec_dataR4t default_namest init_functn_cols((s2lib/python2.7/site-packages/astropy/table/table.pyRBs          &     "           !      cC`s,td|jjD}||jfS(Ncs`s<|]2\}}|t|tr'|n t|fVqdS(N(R9RR"(RWtkeyR5((s2lib/python2.7/site-packages/astropy/table/table.pys s(R RititemsRz(RCRi((s2lib/python2.7/site-packages/astropy/table/table.pyt __getstate__s cC`s#|\}}|j|d|dS(NRz(RB(RCtstateRiRz((s2lib/python2.7/site-packages/astropy/table/table.pyt __setstate__s cC`sY|jrOtg|jjD]}|j^qd|jdt}t|_nd}|S(NRZR( RmRgRiRKtmaskRRR|t_setitem_inplaceR1(RCR5t mask_table((s2lib/python2.7/site-packages/astropy/table/table.pyRs  ( cC`s||j(dS(N(R(RCtval((s2lib/python2.7/site-packages/astropy/table/table.pyRscC`s |jjS(uThis is needed so that comparison of a masked Table and a MaskedArray works. The requirement comes from numpy.ma.core so don't remove this property.(RvR(RC((s2lib/python2.7/site-packages/astropy/table/table.pyt_maskscC`s\|jr:gtj|jD]}|j|^q}n|}|j|dt|jS(uReturn a copy of self, with masked values filled. If input ``fill_value`` supplied then that value is used for all masked entries in the table. Otherwise the individual ``fill_value`` defined for each table column is used. Parameters ---------- fill_value : str If supplied, this ``fill_value`` is used for all masked entries in the entire table. Returns ------- filled_table : Table New table with masked values filled Rz(RmRR^RitfilledROR Rz(RCt fill_valueR5Ru((s2lib/python2.7/site-packages/astropy/table/table.pyRs 1cC`s|g}xi|jjD]X}xO|jjD]A}tg|D]}||k^q9dkr)|j|q)q)WqWt|S(uk Return the indices associated with columns of the table as a TableIndices object. i(RiRKR/tindicestsumR@R(RCtlsttcolumntindexRS((s2lib/python2.7/site-packages/astropy/table/table.pyRs +cC`s t|S(u Return a TableLoc object that can be used for retrieving rows by index in a given data range. Note that both loc and iloc work only with single-column indices. (R(RC((s2lib/python2.7/site-packages/astropy/table/table.pytlocscC`s t|S(u Return a TableILoc object that can be used for retrieving indexed rows in the order they appear in the index. (R (RC((s2lib/python2.7/site-packages/astropy/table/table.pytilocscC`st|tjr|f}n|jt|j}xJ|D]B}t|jdts>t dj |jj t |q>q>Wt |d|d|}|js||_nx!|D]}|jjj|qWdS(uR Insert a new index among one or more columns. If there are no indices, make this index the primary table index. Parameters ---------- colnames : str or list List of column names (or a single column name) to index engine : type or None Indexing engine class to use, from among SortedArray, BST, FastBST, and FastRBT. If the supplied argument is None (by default), use SortedArray. unique : bool Whether the values of the index must be unique. Default is False. u_supports_indexingu5Cannot create an index on column "{0}", of type "{1}"tenginetuniqueN(R9RRFRiR?RKtgetattrR/RRTRRR4RR'RRR@(RCRRRRiR5R((s2lib/python2.7/site-packages/astropy/table/table.pyt add_indexs   "   cC`sw|j|}xc|jD]X}y|j|jjWntk rGqXx$|jD]}|jjj|qRWqWdS(u Remove all indices involving the given column. If the primary index is removed, the new primary index will be the most recently added remaining index. Parameters ---------- colname : str Name of column N(RiRt col_positionR/R4RTtremove(RCtcolnameR5Rtc((s2lib/python2.7/site-packages/astropy/table/table.pytremove_indicess  cC`s t||S(u' Return a context manager for an indexing mode. Parameters ---------- mode : str Either 'freeze', 'copy_on_getitem', or 'discard_on_copy'. In 'discard_on_copy' mode, indices are not copied whenever columns or tables are copied. In 'freeze' mode, indices are not modified whenever columns are modified; at the exit of the context, indices refresh themselves based on column values. This mode is intended for scenarios in which one intends to make many additions or modifications in an indexed column. In 'copy_on_getitem' mode, indices are copied when taking column slices as well as table slices, so col[i0:i1] will preserve indices. (R((RCtmode((s2lib/python2.7/site-packages/astropy/table/table.pyt index_mode2scC`s;|dk rtdn|jr1|jjS|jS(uSupport converting Table to np.array via np.array(table). Coercion to a different dtype via np.array(table, dtype) is not supported and will raise a ValueError. u Datatype coercion is not allowedN(R1RTRmRvRu(RCR0((s2lib/python2.7/site-packages/astropy/table/table.pyt __array__Gs  cC`sxJ|df|dffD]0\}}t|stdj|qqWt||ksqt||krtdj|ndS(ucMake sure that names and dtype are both iterable and have the same length as data. udtypeunamesu{0} must be a list or Noneu:Arguments "names" and "dtype" must match number of columnsN(RRTRRRh(RCRZR0Rtinp_listtinp_str((s2lib/python2.7/site-packages/astropy/table/table.pyRZs% $cC`s{|jdkrEtd|Dr5|jtqw|jtn2|jswtd|Drw|jtqwndS(Ncs`s'|]}t|ttjfVqdS(N(R9RR t MaskedArray(RWR5((s2lib/python2.7/site-packages/astropy/table/table.pys iscs`s9|]/}t|ttjfrtj|jVqdS(N(R9RR RRItanyR(RWR5((s2lib/python2.7/site-packages/astropy/table/table.pys ns(RmR1RRyR|R(RCRD((s2lib/python2.7/site-packages/astropy/table/table.pyt_set_masked_from_colsgs c C`st}x|D]}|j|qWi}xz|D]r} g|| ~s( tsetR`t enumerateR@R\RTRRRtsortedR( RCRuRZR0RRtnames_from_dataRxRDR4ti((s2lib/python2.7/site-packages/astropy/table/table.pyt_init_from_list_of_dictsqs     $c C`s|r9td|Dr9|j|||||dS|j|g}t|}xt||||D]m\}} } }t|tjrt|j dkr|j | r|j t }nt|t tfr |jd| p|jjp| d|d|d|d|j}n|j |rn|rMt|d|j}n| pb|jjpb| |j_n`t|tjst|r|jd| p| d|d|d|d|j}n td |j|qnW|j|dS( uInitialize table from a list of columns. A column can be a Column object, np.ndarray, mixin, or any other iterable object. cs`s|]}t|tVqdS(N(R9Rw(RWRx((s2lib/python2.7/site-packages/astropy/table/table.pys sNiR4RuR0RRuBElements in list initialization must be either Column or list-like(RRRR RR9RIRLRhR0t_add_as_mixin_columntviewt NdarrayMixinRRt ColumnClassR/R4R~R"RRTR@t_init_from_cols( RCRuRZR0RRRDt def_namesR5R4tdef_name((s2lib/python2.7/site-packages/astropy/table/table.pyRs0  ('! !! cC`s|jjpt|}|jjdk }gt|D]\}} | pP||^q7}|r|g|D]?} || ^qfn,gt|D]}|dd|f^q} |j| |r|j| ||||ngt|| D]%\} } | | j| j df^q}|j |j } |j } x>|D]6} |j d| d| | | | <|| | j_q=W| |_dS(u1Initialize table from an ndarray structured arrayNiR4Ru(R0RZR R1RRRRRR3RtravelR=RR/t parent_tableRi(RCRuRZR0RRt data_nameststructRR4RDR5tnewdataRi((s2lib/python2.7/site-packages/astropy/table/table.pyRs/#/ ;   cC`sO|stdng|D]}||^q}|j|||||dS(u-Initialize table from a dictionary of columnsu,Cannot use copy=False with a dict data inputN(RTR(RCRuRZR0RRR4t data_list((s2lib/python2.7/site-packages/astropy/table/table.pyRscC`sj|}|jj|jjt|j|j|_t|jj}|j|||||dS(u/Initialize table from an existing Table object N( RzR_R`R RR>RiRKR(RCRuRZR0RRttableRD((s2lib/python2.7/site-packages/astropy/table/table.pyRs   cC`s7|j|jk r3t|tr3|j|}n|S(u Make sure that all Column objects have correct class for this type of Table. For a base Table this most commonly means setting to MaskedColumn if the table is masked. Table subclasses like QTable override this method. (RORR9R(RCR5((s2lib/python2.7/site-packages/astropy/table/table.pyt_convert_col_for_tables!c C`std|D}t|dkr@tdj|n|j|g|D]}|j|^qT}|j||i}x|jD]u}xlt|j j pgD]R\}}t d|j D}||kr|||j j |siu%Inconsistent data column lengths: {0}cs`s|]}|jjVqdS(N(R/R4(RWtind_col((s2lib/python2.7/site-packages/astropy/table/table.pys sN( RRhRTRRRRt_make_table_from_colstitercolsRR/RR?Ri( RCRDtlengthsR5REt index_dictRRRZ((s2lib/python2.7/site-packages/astropy/table/table.pyRs  "% cC`s|jd|j}|jj|jjt|j|j|_|jj}g}xm|D]e}|j |j _ ||}|j j r|j j ||t |}n|j|t|j _ qcW|j|||S(u3Create a new table as a referenced slice from self.Rm(RORmRzR_R`R RRiRKR}R/Rt slice_indicesRhR@R|R(RCtslice_RRDRER5tnewcol((s2lib/python2.7/site-packages/astropy/table/table.pyt_new_from_slices     ! cC`std|D}d|kr1tdnt|t|krXtdn|jd|D}xH|D]@}||j_|jrxt |d rxt |j |_ qxqxW||_ dS(u[ Make ``table`` in-place so that it represents the given list of ``cols``. cs`s|]}|jjVqdS(N(R/R4(RWR5((s2lib/python2.7/site-packages/astropy/table/table.pys su Cannot have None for column nameuDuplicate column namescs`s!|]}|jj|fVqdS(N(R/R4(RWR5((s2lib/python2.7/site-packages/astropy/table/table.pys %sumaskN(RR1RRhRTR=R/RRmR2R!R3RRi(RRDRRiR5((s2lib/python2.7/site-packages/astropy/table/table.pyRs   cc`s!x|jD]}||Vq WdS(u Iterate over the columns of this table. Examples -------- To iterate over the columns of a table:: >>> t = Table([[1], [2]]) >>> for col in t.itercols(): ... print(col) col0 ---- 1 col1 ---- 2 Using ``itercols()`` is similar to ``for col in t.columns.values()`` but is syntactically preferred. N(Ri(RCR((s2lib/python2.7/site-packages/astropy/table/table.pyR.sc C`sB|dkrS|jjg}|jr4|jdn|jdjt|nddj|d}|rddlm } | |}n|dkrdjd t |}n|j j |d |d |d |d t ddd|d|d|\} } |dj| } tjr>t| tjr>| jd} n| S(Nu masked=Trueu length={0}u i(t xml_escapeu table{id}tidttableidthtmlt max_widtht show_namet show_unitt show_dtypet max_linest tableclassu uutf-8(R1ROR,RmR@RRRhRYtutils.xml.writerRRR{t_pformat_tableR|RtPY2R9t text_typetencode( RCRt descr_valsRRRRRR8Rt data_linestoutstout((s2lib/python2.7/site-packages/astropy/table/table.pyt _base_repr_Gs&    cC`s|jdtdddtjS(NRRiR(RR|R*tdefault_notebook_table_class(RC((s2lib/python2.7/site-packages/astropy/table/table.pyt _repr_html_dscC`s|jdtddS(NRR(RRR1(RC((s2lib/python2.7/site-packages/astropy/table/table.pyR[hscC`sdj|jS(Nu (RYtpformat(RC((s2lib/python2.7/site-packages/astropy/table/table.pyt __unicode__kscC`stj|jdS(Nuutf-8(RRR(RC((s2lib/python2.7/site-packages/astropy/table/table.pyt __bytes__pscC`std|jjDS(ur True if table has any mixin columns (defined as columns that are not Column subclasses). cs`s|]}t|tVqdS(N(R<R(RWR5((s2lib/python2.7/site-packages/astropy/table/table.pys {s(RRiRK(RC((s2lib/python2.7/site-packages/astropy/table/table.pythas_mixin_columnsuscC`s0t|trtSt|to/t|t S(ug Determine if ``col`` should be added to the table directly as a mixin column. (R9RRR<RR(RCR5((s2lib/python2.7/site-packages/astropy/table/table.pyR}sc C`s|jj|||d|d|d|d|\}}|dr_|jdjt|n|d} x@t|D]2\} } | | krt| dqvt| qvWd S( uPrint a formatted string representation of the table. If no value of ``max_lines`` is supplied then the height of the screen terminal is used to set ``max_lines``. If the terminal height cannot be determined then the default is taken from the configuration item ``astropy.conf.max_lines``. If a negative value of ``max_lines`` is supplied then there is no line limit applied. The same applies for max_width except the configuration item is ``astropy.conf.max_width``. Parameters ---------- max_lines : int Maximum number of lines in table output. max_width : int or `None` Maximum character width of output. show_name : bool Include a header row for column names. Default is True. show_unit : bool Include a header row for unit. Default is to show a row for units only if one or more columns has a defined value for the unit. show_dtype : bool Include a header row for column dtypes. Default is True. align : str or list or tuple or `None` Left/right alignment of columns. Default is right (None) for all columns. Other allowed values are '>', '<', '^', and '0=' for right, left, centered, and 0-padded, respectively. A list of strings can be provided for alignment of tables with multiple columns. RRRtalignu show_lengthuLength = {0} rowsun_headeruredN(R{RR@RRRhRRtprint( RCRRRRRRtlinesRtn_headerRtline((s2lib/python2.7/site-packages/astropy/table/table.pytpprints(    cC`sa||jkrY|jd|dtjt|}|j|g|jjdtS|SdS(NR4RuR(RiRRItarangeRhRORKR(RCtindex_row_nametidx_col((s2lib/python2.7/site-packages/astropy/table/table.pyt_make_index_row_display_tables 'i2uastropy-defaultuidxc C`s:ddlm}ddlm}|dkrVdjt|tjj dd}n|d|}|r}|j |} n|} |dkrt j }n| j d td d d |d d dtd|} | jj} gt| D]$\} } | jjdkr| ^q}| |j|d|d|7} || S(u Render the table in HTML and show it in the IPython notebook. Parameters ---------- tableid : str or `None` An html ID tag for the table. Default is ``table{id}-XXX``, where id is the unique integer id of the table object, id(self), and XXX is a random number to avoid conflicts when printing the same table multiple times. table_class : str or `None` A string with a list of HTML classes used to style the table. The special default string ('astropy-default') means that the string will be retrieved from the configuration item ``astropy.table.default_notebook_table_class``. Note that these table classes may make use of bootstrap, as this is loaded with the notebook. See `this page `_ for the list of classes. css : string A valid CSS string declaring the formatting for the table. Defaults to ``astropy.table.jsviewer.DEFAULT_CSS_NB``. display_length : int, optional Number or rows to show. Defaults to 50. show_row_index : str or False If this does not evaluate to False, a column with the given name will be added to the version of the table that gets displayed. This new column shows the index of the row in the table itself, even when the displayed table is re-sorted by another column. Note that if a column with this name already exists, this option will be ignored. Defaults to "idx". Notes ----- Currently, unlike `show_in_browser` (with ``jsviewer=True``), this method needs to access online javascript code repositories. This is due to modern browsers' limitations on accessing local files. Hence, if you call this method while offline (and don't have a cached version of jquery and jquery.dataTables), you will not get the jsviewer features. i(tJSVieweri(tHTMLu table{0}-{1}g.Atdisplay_lengthuastropy-defaultRRiRRRRuiufctcsst sort_columnsN(tjsviewerRtIPython.displayRR1RRRRItrandomtrandintRR*RRR|RRiRKRR0RMtipynb(RCRRRt table_classtshow_row_indexRRtjsvt display_tableRRiRR5tsortable_columns((s2lib/python2.7/site-packages/astropy/table/table.pytshow_in_notebooks&)     iudefaultuuse_local_filesudisplay compactc C`sddl} ddl} ddl} ddlm} ddlm} ddlm}|dkri|}n| j }| j j |d}t |d r}|r|r|j|}n|}|j|d d d |d |d|d|d|n|j|d dWdQXy%| j|dkr(dn|}Wn*| jk r^tjdj|nX|j | d| |dS(uRender the table in HTML and show it in a web browser. Parameters ---------- max_lines : int Maximum number of rows to export to the table (set low by default to avoid memory issues, since the browser view requires duplicating the table in memory). A negative value of ``max_lines`` indicates no row limit. jsviewer : bool If `True`, prepends some javascript headers so that the table is rendered as a `DataTables `_ data table. This allows in-browser searching & sorting. browser : str Any legal browser name, e.g. ``'firefox'``, ``'chrome'``, ``'safari'`` (for mac, you may need to use ``'open -a "/Applications/Google Chrome.app" {}'`` for Chrome). If ``'default'``, will use the system default browser. jskwargs : dict Passed to the `astropy.table.JSViewer` init. Defaults to ``{'use_local_files': True}`` which means that the JavaScript libraries will be served from local copies. tableid : str or `None` An html ID tag for the table. Default is ``table{id}``, where id is the unique integer id of the table object, id(self). table_class : str or `None` A string with a list of HTML classes used to style the table. Default is "display compact", and other possible values can be found in https://www.datatables.net/manual/styling/classes css : string A valid CSS string declaring the formatting for the table. Defaults to ``astropy.table.jsviewer.DEFAULT_CSS``. show_row_index : str or False If this does not evaluate to False, a column with the given name will be added to the version of the table that gets displayed. This new column shows the index of the row in the table itself, even when the displayed table is re-sorted by another column. Note that if a column with this name already exists, this option will be ignored. Defaults to "idx". iNi(turljoin(t pathname2urli(t DEFAULT_CSSu table.htmluwRRujsviewerRRtjskwargsttable_idR uhtmludefaultuBrowser '{}' not found.ufile:(tost webbrowserttempfiletextern.six.moves.urllib.parseRtextern.six.moves.urllib.requestRRRR1tmkdtemptpathRYtopenRtwriteR]tErrorRterrorRR(RCRRtbrowserRRR RR RRRRRRttmpdirRttmpR tbr((s2lib/python2.7/site-packages/astropy/table/table.pytshow_in_browsers0-       %c C`su|jj|||d|d|d|d|d|d| d|\} } | drq| jd jt|n| S( uReturn a list of lines for the formatted string representation of the table. If no value of ``max_lines`` is supplied then the height of the screen terminal is used to set ``max_lines``. If the terminal height cannot be determined then the default is taken from the configuration item ``astropy.conf.max_lines``. If a negative value of ``max_lines`` is supplied then there is no line limit applied. The same applies for ``max_width`` except the configuration item is ``astropy.conf.max_width``. Parameters ---------- max_lines : int or `None` Maximum number of rows to output max_width : int or `None` Maximum character width of output show_name : bool Include a header row for column names. Default is True. show_unit : bool Include a header row for unit. Default is to show a row for units only if one or more columns has a defined value for the unit. show_dtype : bool Include a header row for column dtypes. Default is True. html : bool Format the output as an HTML table. Default is False. tableid : str or `None` An ID tag for the table; only used if html is set. Default is "table{id}", where id is the unique integer id of the table object, id(self) align : str or list or tuple or `None` Left/right alignment of columns. Default is right (None) for all columns. Other allowed values are '>', '<', '^', and '0=' for right, left, centered, and 0-padded, respectively. A list of strings can be provided for alignment of tables with multiple columns. tableclass : str or list of str or `None` CSS classes for the table; only used if html is set. Default is None. Returns ------- lines : list Formatted table as a list of strings. RRRRRRRu show_lengthuLength = {0} rows(R{RR@RRRh( RCRRRRRRRRRRR((s2lib/python2.7/site-packages/astropy/table/table.pyRWs=  c C`s,|jj|||d|d|d|dS(uInteractively browse table with a paging interface. Supported keys:: f, : forward one page b : back one page r : refresh same page n : next row p : previous row < : go to beginning > : go to end q : quit browsing h : print this help Parameters ---------- max_lines : int Maximum number of lines in table output max_width : int or `None` Maximum character width of output show_name : bool Include a header row for column names. Default is True. show_unit : bool Include a header row for unit. Default is to show a row for units only if one or more columns has a defined value for the unit. show_dtype : bool Include a header row for column dtypes. Default is True. RRRN(R{t _more_tabcol(RCRRRRR((s2lib/python2.7/site-packages/astropy/table/table.pytmores#cC`sEt|tjr|j|St|ttjfrE|j||St|tjr|j d kr|j j dkr|j||j St|t tfrz|rztd|Drzg|D]}||jkr|^q}|rtdjdj|n|jg|D]}||^qdt|jd|j}tj|d|jjd|jj|_|St|tjr|jd kst|t tfr| r|jgSt|tst|tjst|tst|t r&td |Dr&|j|Std jt |dS( Nuics`s!|]}t|tjVqdS(N(R9RRF(RWRS((s2lib/python2.7/site-packages/astropy/table/table.pys su*Slice name(s) {0} not valid column name(s)u, RzRRReics`s!|]}t|tjVqdS(N(R9RIRL(RWRS((s2lib/python2.7/site-packages/astropy/table/table.pys su&Illegal type {0} for table item access((!R9RRFRiRHRIRJR#RLR3R0RMRNR?R>RRRTRRRYROR RzR}Rt TableGroupst_indicest_keyst_groupstsizeRRPR(RCRNRSt bad_namesR((s2lib/python2.7/site-packages/astropy/table/table.pyRGs: 3( # !    c `st|tjrN||jkrN|jr3|jn|j}td rn|j rnt j ntt j rt j dkr|j rjtn|}tts|jrt |dkrtdts)tdddks)t dkrt |ftddd}tt j rytd|dtqttrjtd|dtqnt}||j_nqt |dkr|d|}nJ|d|d t |d j djdd td d}|(|j|gd tnt |j}t|tjrt|dt rtj ry|j |dSWqt!k rqXn|j|(nt|t"t j#frbtdst$dnt |kr,t%dj&|nxt'|jj(D]\}} | ||=scs`s|] }|VqdS(N((RWR5((s2lib/python2.7/site-packages/astropy/table/table.pys @sc3`s|]}|VqdS(N((RWR4(RV(s2lib/python2.7/site-packages/astropy/table/table.pys Csu&Illegal type {0} for table item access(((3R9RRFRRmRRR2RRItasarrayRLRhR0RRRRRR1tnp_broadcast_toR|Rt_applyR"R/R4R3t add_columnsRiR*treplace_inplacet_replace_column_warningsRRHRJRRTRRRRKRPR>R?RRgRZtisscalart itertoolstrepeatR( RCRNRVt NewColumnR4t new_shapet new_columnRR5RtvalsR6((RVs2lib/python2.7/site-packages/astropy/table/table.pyRUs! ' $#  !    %  % cC`sEt|tjr"|j|nt|trA|j|ndS(N(R9RRFt remove_columnR?tremove_columns(RCRN((s2lib/python2.7/site-packages/astropy/table/table.pyt __delitem__VscC`s |j|S(u/Return column[item] for recarray compatibility.(Ri(RCRN((s2lib/python2.7/site-packages/astropy/table/table.pytfield\scC`s|jS(N(t_masked(RC((s2lib/python2.7/site-packages/astropy/table/table.pyRm`scC`stddS(NuZMasked attribute is read-only (use t = Table(t, masked=True) to convert to a masked table)(R(RCRm((s2lib/python2.7/site-packages/astropy/table/table.pyRmdscC`s t|dr|jdkr<|ttgkr<||_q|jtkrp|tkrptjd||_q|j|krtdj|qtdj||jn-|ttdgkr||_n t d|jr|j |_ n |j |_ dS(u Set the table masked property. Parameters ---------- masked : bool State of table masking (`True` or `False`) u_maskeduQUpgrading Table to masked Table. Use Table.filled() to convert to unmasked table.u&Masked attribute is already set to {0}u;Cannot change masked attribute to {0} once it is set to {1}u)masked should be one of True, False, NoneN( R2R@R1RR|RR/RRRRTRt _column_classR(RCRm((s2lib/python2.7/site-packages/astropy/table/table.pyRyis !       cC`s!|jdkr|jS|jSdS(N(RAR1R(RC((s2lib/python2.7/site-packages/astropy/table/table.pyRscC`s/tjg|jjD]}t|^qS(N(RIR0RiRKR8(RCR5((s2lib/python2.7/site-packages/astropy/table/table.pyR0scC`st|jjS(N(R>RiRe(RC((s2lib/python2.7/site-packages/astropy/table/table.pyRscC`st|jjS(N(R>RiRe(RC((s2lib/python2.7/site-packages/astropy/table/table.pyRescC`st|jdkrdStd|jjD}t|dkrg|jjD]$\}}dj|t|^qZ}tdjdj|n|jS(Nics`s|]}t|VqdS(N(Rh(RWR5((s2lib/python2.7/site-packages/astropy/table/table.pys siu {0} : {1}uColumn length mismatch: {0}u ( RhRiRRKRRRRTRYtpop(RCRR4R5tlen_strs((s2lib/python2.7/site-packages/astropy/table/table.pyt__len__s:!cC`sAy|jj|SWn&tk r<tdj|nXdS(u Return the positional index of column ``name``. Parameters ---------- name : str column name Returns ------- index : int Positional index of column ``name``. Examples -------- Create a table with three columns 'a', 'b' and 'c':: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3], ['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> print(t) a b c --- --- --- 1 0.1 x 2 0.2 y 3 0.3 z Get index of column 'b' of the table:: >>> t.index_column('b') 1 uColumn {0} does not existN(RRRTRR(RCR4((s2lib/python2.7/site-packages/astropy/table/table.pyt index_columns  cC`sY|dkrt|j}n|dk r6|f}n|j|g|g|d|dS(uA Add a new Column object ``col`` to the table. If ``index`` is supplied then insert column before ``index`` position in the list of columns, otherwise append column to the end of the list. Parameters ---------- col : Column Column object to add. index : int or `None` Insert column before this position or at end (default). name : str Column name rename_duplicate : bool Uniquify column name if it already exist. Default is False. Examples -------- Create a table with two columns 'a' and 'b':: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3]], names=('a', 'b')) >>> print(t) a b --- --- 1 0.1 2 0.2 3 0.3 Create a third column 'c' and append it to the end of the table:: >>> col_c = Column(name='c', data=['x', 'y', 'z']) >>> t.add_column(col_c) >>> print(t) a b c --- --- --- 1 0.1 x 2 0.2 y 3 0.3 z Add column 'd' at position 1. Note that the column is inserted before the given index:: >>> col_d = Column(name='d', data=['a', 'b', 'c']) >>> t.add_column(col_d, 1) >>> print(t) a d b c --- --- --- --- 1 a 0.1 x 2 b 0.2 y 3 c 0.3 z Add second column named 'b' with rename_duplicate:: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3]], names=('a', 'b')) >>> col_b = Column(name='b', data=[1.1, 1.2, 1.3]) >>> t.add_column(col_b, rename_duplicate=True) >>> print(t) a b b_1 --- --- --- 1 0.1 1.1 2 0.2 1.2 3 0.3 1.3 Add an unnamed column or mixin object in the table using a default name or by specifying an explicit name with ``name``. Name can also be overridden:: >>> t = Table([[1, 2], [0.1, 0.2]], names=('a', 'b')) >>> col_c = Column(data=['x', 'y']) >>> t.add_column(col_c) >>> t.add_column(col_c, name='c') >>> col_b = Column(name='b', data=[1.1, 1.2]) >>> t.add_column(col_b, name='d') >>> print(t) a b col2 c d --- --- ---- --- --- 1 0.1 x x 1.1 2 0.2 y y 1.2 To add several columns use add_columns. trename_duplicateN(R1RhRiR2(RCR5RR4RF((s2lib/python2.7/site-packages/astropy/table/table.pyt add_columns R   cC`s|dkr+t|jgt|}n't|t|krRtdn|rzg|D]}t|^q_}nt|jdkr|}nt|jj}ttt|d}xLt||D];\}} |j | } |j | d|j | |qW|dkr7dt|}n't|t|kr^tdnxt t||D]\} \}} | dkr|j j dk rqtndj| t|j} n|j jdk rt|}n| |j _ qtW|rt|j} x|D]}d} |j j } |j j | krx_|j j | kr|j jdk rvt|}ndj| | }||j _ | d7} qCW| j|qqWn|j|dS( u Add a list of new Column objects ``cols`` to the table. If a corresponding list of ``indexes`` is supplied then insert column before each ``index`` position in the *original* list of columns, otherwise append columns to the end of the list. Parameters ---------- cols : list of Columns Column objects to add. indexes : list of ints or `None` Insert column before this position or at end (default). names : list of str Column names copy : bool Make a copy of the new columns. Default is True. rename_duplicate : bool Uniquify new column names if they duplicate the existing ones. Default is False. Examples -------- Create a table with two columns 'a' and 'b':: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3]], names=('a', 'b')) >>> print(t) a b --- --- 1 0.1 2 0.2 3 0.3 Create column 'c' and 'd' and append them to the end of the table:: >>> col_c = Column(name='c', data=['x', 'y', 'z']) >>> col_d = Column(name='d', data=['u', 'v', 'w']) >>> t.add_columns([col_c, col_d]) >>> print(t) a b c d --- --- --- --- 1 0.1 x u 2 0.2 y v 3 0.3 z w Add column 'c' at position 0 and column 'd' at position 1. Note that the columns are inserted before the given position:: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3]], names=('a', 'b')) >>> col_c = Column(name='c', data=['x', 'y', 'z']) >>> col_d = Column(name='d', data=['u', 'v', 'w']) >>> t.add_columns([col_c, col_d], [0, 1]) >>> print(t) c a d b --- --- --- --- x 1 u 0.1 y 2 v 0.2 z 3 w 0.3 Add second column 'b' and column 'c' with ``rename_duplicate``:: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3]], names=('a', 'b')) >>> col_b = Column(name='b', data=[1.1, 1.2, 1.3]) >>> col_c = Column(name='c', data=['x', 'y', 'z']) >>> t.add_columns([col_b, col_c], rename_duplicate=True) >>> print(t) a b b_1 c --- --- --- --- 1 0.1 1.1 x 2 0.2 1.2 y 3 0.3 1.3 z Add unnamed columns or mixin objects in the table using default names or by specifying explicit names with ``names``. Names can also be overridden:: >>> t = Table() >>> col_a = Column(data=['x', 'y']) >>> col_b = Column(name='b', data=['u', 'v']) >>> t.add_columns([col_a, col_b]) >>> t.add_columns([col_a, col_b], names=['c', 'd']) >>> print(t) col0 b c d ---- --- --- --- x u x u y v y v u+Number of indexes must match number of colsiiu)Number of names must match number of colsucol{}u{0}_{1}N(N(R1RhRiRTR"R>RKRRRtinsertRR/R4RRRRRtaddR(RCRDtindexesRZRRFR5REt new_indexesRRR4texisting_namest orig_nameRa((s2lib/python2.7/site-packages/astropy/table/table.pyR2#sPW "  (    c C`stj}d|kr:||jkr:tj||}n||jkrV||}n|j||d|krtjdj|t ddnd|kryAt |j |j rdj|}tj|t ddnWqt k rqXnd|krNtj||}||krNdj|}tj|t ddqNnd |krg}||} xEtjD]:} t|j| t| j| krt|j| qtqtW|rd j||}tj|t ddqnd S( uY Same as replace_column but issues warnings under various circumstances. urefcountualwaysureplaced column '{}'t stackleveliusliceuureplaced column '{}' which looks like an array slice. The new column no longer shares memory with the original array.uHreplaced column '{}' and the number of references to the column changed.u attributesu6replaced column '{}' and column attributes {} changed.N(R*treplace_warningsRRjt getrefcounttreplace_columntwarningstwarnRRR+R9tbaseROtAttributeErrorRt attr_namesRR/R@( RCR4R5twarnstrefcounttold_coltmsgt new_refcountt changed_attrstnew_coltattr((s2lib/python2.7/site-packages/astropy/table/table.pyR4sB           $ cC`s||jkr'tdj|n||jjrFtdn|j|gd|g}t|j}||||<|j|j dS(u$ Replace column ``name`` with the new ``col`` object. Parameters ---------- name : str Name of column to replace col : column object (list, ndarray, Column, etc) New column object to replace the existing column Examples -------- Replace column 'a' with a float version of itself:: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3]], names=('a', 'b')) >>> float_a = t['a'].astype(float) >>> t.replace_column('a', float_a) u#column name {0} is not in the tableu#cannot replace a table index columnRZN( RRTRRR/RROR RiRRK(RCR4R5ttRD((s2lib/python2.7/site-packages/astropy/table/table.pyRQscC`s;t|tjtjfs*tdn|j|dS(u Remove a row from the table. Parameters ---------- index : int Index of row to remove Examples -------- Create a table with three columns 'a', 'b' and 'c':: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3], ['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> print(t) a b c --- --- --- 1 0.1 x 2 0.2 y 3 0.3 z Remove row 1 from the table:: >>> t.remove_row(1) >>> print(t) a b c --- --- --- 1 0.1 x 3 0.3 z To remove several rows at the same time use remove_rows. uRow index must be an integerN(R9Rt integer_typesRIRJRt remove_rows(RCR((s2lib/python2.7/site-packages/astropy/table/table.pyt remove_rows"cC`sx|jD]}|j|q Wtjt|dtj}t||<|j}x=|jj D],\}}||}||j _ |||>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3], ['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> print(t) a b c --- --- --- 1 0.1 x 2 0.2 y 3 0.3 z Remove rows 0 and 2 from the table:: >>> t.remove_rows([0, 2]) >>> print(t) a b c --- --- --- 2 0.2 y Note that there are no warnings if the slice operator extends outside the data:: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3], ['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> t.remove_rows(slice(10, 20, 1)) >>> print(t) a b c --- --- --- 1 0.1 x 2 0.2 y 3 0.3 z R0u_groupsN(RRaRItonesRhRRR=RiRR/Rt _replace_colsR2R)(RCt row_specifierRt keep_maskRiR4R5R((s2lib/python2.7/site-packages/astropy/table/table.pyRa)s-     cC`s|j|gdS(uR Remove a column from the table. This can also be done with:: del table[name] Parameters ---------- name : str Name of column to remove Examples -------- Create a table with three columns 'a', 'b' and 'c':: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3], ['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> print(t) a b c --- --- --- 1 0.1 x 2 0.2 y 3 0.3 z Remove column 'b' from the table:: >>> t.remove_column('b') >>> print(t) a c --- --- 1 x 2 y 3 z To remove several columns at the same time use remove_columns. N(R=(RCR4((s2lib/python2.7/site-packages/astropy/table/table.pyR<hs'cC`s{t|tjr|g}nx5|D]-}||jkr%tdj|q%q%Wx|D]}|jj|q]WdS(u Remove several columns from the table. Parameters ---------- names : list A list containing the names of the columns to remove Examples -------- Create a table with three columns 'a', 'b' and 'c':: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3], ['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> print(t) a b c --- --- --- 1 0.1 x 2 0.2 y 3 0.3 z Remove columns 'b' and 'c' from the table:: >>> t.remove_columns(['b', 'c']) >>> print(t) a --- 1 2 3 Specifying only a single column also works. Remove column 'b' from the table:: >>> t = Table([[1, 2, 3], [0.1, 0.2, 0.3], ['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> t.remove_columns('b') >>> print(t) a c --- --- 1 x 2 y 3 z This gives the same as using remove_column. uColumn {0} does not existN(R9RRFRiR\RRRB(RCRZR4((s2lib/python2.7/site-packages/astropy/table/table.pyR=s.   c `s|rtjrdS|jj}tfd|DsBdSg}xf|D]^}|jjkrtj||jj }|j |d|}n|}|j |qOW|j |dS(u8 Convert string-like columns to/from bytestring and unicode (internal only). Parameters ---------- in_kind : str Input dtype.kind out_kind : str Output dtype.kind python3_only : bool Only do this operation for Python 3 Nc3`s!|]}|jjkVqdS(N(R0RM(RWR5(tin_kind(s2lib/python2.7/site-packages/astropy/table/table.pys sR0( RRRiRKRR0RMtretsubtstrROR@R( RCRgtout_kindt python3_onlyRDRER5tnewdtypeR((Rgs2lib/python2.7/site-packages/astropy/table/table.pyt_convert_string_dtypes  cC`s|jdd|dS(u Convert bytestring columns (dtype.kind='S') to unicode (dtype.kind='U') assuming ASCII encoding. Internally this changes string columns to represent each character in the string with a 4-byte UCS-4 equivalent, so it is inefficient for memory but allows Python 3 scripts to manipulate string arrays with natural syntax. The ``python3_only`` parameter is provided as a convenience so that code can be written in a Python 2 / 3 compatible way:: >>> t = Table.read('my_data.fits') >>> t.convert_bytestring_to_unicode(python3_only=True) Parameters ---------- python3_only : bool Only do this operation for Python 3 uSuUN(Rn(RCRl((s2lib/python2.7/site-packages/astropy/table/table.pytconvert_bytestring_to_unicodescC`s|jdd|dS(u Convert ASCII-only unicode columns (dtype.kind='U') to bytestring (dtype.kind='S'). When exporting a unicode string array to a file in Python 3, it may be desirable to encode unicode columns as bytestrings. This routine takes advantage of numpy automated conversion which works for strings that are pure ASCII. The ``python3_only`` parameter is provided as a convenience so that code can be written in a Python 2 / 3 compatible way:: >>> t.convert_unicode_to_bytestring(python3_only=True) >>> t.write('my_data.fits') Parameters ---------- python3_only : bool Only do this operation for Python 3 uUuSN(Rn(RCRl((s2lib/python2.7/site-packages/astropy/table/table.pytconvert_unicode_to_bytestringscC`st|tjr|g}nx5|D]-}||jkr%tdj|q%q%Wtt|jt|}|j |dS(u Keep only the columns specified (remove the others). Parameters ---------- names : list A list containing the names of the columns to keep. All other columns will be removed. Examples -------- Create a table with three columns 'a', 'b' and 'c':: >>> t = Table([[1, 2, 3],[0.1, 0.2, 0.3],['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> print(t) a b c --- --- --- 1 0.1 x 2 0.2 y 3 0.3 z Specifying only a single column name keeps only this column. Keep only column 'a' of the table:: >>> t.keep_columns('a') >>> print(t) a --- 1 2 3 Specifying a list of column names is keeps is also possible. Keep columns 'a' and 'c' of the table:: >>> t = Table([[1, 2, 3],[0.1, 0.2, 0.3],['x', 'y', 'z']], ... names=('a', 'b', 'c')) >>> t.keep_columns(['a', 'c']) >>> print(t) a c --- --- 1 x 2 y 3 z uColumn {0} does not existN( R9RRFRiR\RRR>RReR=(RCRZR4R((s2lib/python2.7/site-packages/astropy/table/table.pyt keep_columnss0  "cC`sA||jkr*tdj|n||j|j_dS(ug Rename a column. This can also be done directly with by setting the ``name`` attribute for a column:: table[name].name = new_name TODO: this won't work for mixins Parameters ---------- name : str The current name of the column. new_name : str The new name for the column Examples -------- Create a table with three columns 'a', 'b' and 'c':: >>> t = Table([[1,2],[3,4],[5,6]], names=('a','b','c')) >>> print(t) a b c --- --- --- 1 3 5 2 4 6 Renaming column 'a' to 'aa':: >>> t.rename_column('a' , 'aa') >>> print(t) aa b c --- --- --- 1 3 5 2 4 6 uColumn {0} does not existN(ReR\RRRiR/R4(RCR4Ra((s2lib/python2.7/site-packages/astropy/table/table.pyt rename_columnOs'cC`s|jt|||dS(uAdd a new row to the end of the table. The ``vals`` argument can be: sequence (e.g. tuple or list) Column values in the same order as table columns. mapping (e.g. dict) Keys corresponding to column names. Missing values will be filled with np.zeros for the column dtype. `None` All values filled with np.zeros for the column dtype. This method requires that the Table object "owns" the underlying array data. In particular one cannot add a row to a Table that was initialized with copy=False from an existing array. The ``mask`` attribute should give (if desired) the mask for the values. The type of the mask should match that of the values, i.e. if ``vals`` is an iterable, then ``mask`` should also be an iterable with the same length, and if ``vals`` is a mapping, then ``mask`` should be a dictionary. Parameters ---------- vals : tuple, list, dict or `None` Use the specified values in the new row mask : tuple, list, dict or `None` Use the specified mask values in the new row Examples -------- Create a table with three columns 'a', 'b' and 'c':: >>> t = Table([[1,2],[4,5],[7,8]], names=('a','b','c')) >>> print(t) a b c --- --- --- 1 4 7 2 5 8 Adding a new row with entries '3' in 'a', '6' in 'b' and '9' in 'c':: >>> t.add_row([3,6,9]) >>> print(t) a b c --- --- --- 1 4 7 2 5 8 3 6 9 N(t insert_rowRh(RCR;R((s2lib/python2.7/site-packages/astropy/table/table.pytadd_row{s3c`s|jt|}|| ks.||krItdj||n|dkrb||7}nd}|dk r|j r|jtn||s|dkr%|dk r|| rtdn|dk rt |j t |j krt dn|rAt fd|DrAt dng}g}xD]}|r||kr|j |||j |dkrtn||qT||} t| dr|j tjd dd | j|j |jo|dk qTt d j|qTW|}|}nt|r|dk ret| sV||retdnt|jt|krt d n|dk rt|jt|krt d qqtgt|j}n td|j} ygx0t|jj||D]\}} } } t| trgt| |j rg|j| dt} n| j|| dd} t| ts|| j_|jrt| j | _!qnt| |dkrt dj|| t| |dn|| j_"|jr!| | j!|s(u __getitem__u__len__u__iter__ukeysuvaluesuitems(R(R:tattrs((R:s2lib/python2.7/site-packages/astropy/table/table.pyt _is_mappingsu&Mismatch between type of vals and masku&keys in mask should match keys in valsc3`s|]}|kVqdS(N((RWR4(R(s2lib/python2.7/site-packages/astropy/table/table.pys su+Keys in vals must all be valid column namesudtypeR3R0u'Value must be supplied for column '{0}'u+Mismatch between number of vals and columnsu,Mismatch between number of masks and columnsu+Vals must be an iterable or mapping or NoneRtaxisiuKIncorrect length for column {0} after inserting {1} (expected {2}, got {3})u>Unable to insert row because of exception in column '{0}': {1}u_groupsN(((RRhRQRRR1RmRyR|RRReRTRR@RR2RItzerosR0RRiR=RRKR9RRRHRR/R4R!R3RRRRsRRdR)(RCRR;RtNRvt vals_listt mask_listR4R5RiRtmask_Rt table_indexterr((Rs2lib/python2.7/site-packages/astropy/table/table.pyRss      0" & "  %   1"   "  $  cC`sx~t|jj|jD]^\}}g|j_xC|jjD]5}||j|j|jj<|jjj|qDWqW||_dS(N(RRiRKR/RRR4R@(RCRiR5R]R((s2lib/python2.7/site-packages/astropy/table/table.pyRd< s + cC`st|tjr|g}n|dk rVt|||}|dk rV|jSni}|ro||d>> t = Table([['Max', 'Jo', 'John'], ['Miller','Miller','Jackson'], ... [12,15,18]], names=('firstname','name','tel')) >>> print(t) firstname name tel --------- ------- --- Max Miller 12 Jo Miller 15 John Jackson 18 Sorting according to standard sorting rules, first 'name' then 'firstname':: >>> t.sort(['name','firstname']) >>> print(t) firstname name tel --------- ------- --- John Jackson 18 Jo Miller 15 Max Miller 12 u/Table sort requires input keys or a table indexiRwN(R1RRTRiR/R4R9RRFRR)t_frozenR|RKttaketsort(RCReRSRJt sort_indext prev_frozenR5((s2lib/python2.7/site-packages/astropy/table/table.pyRn s "  ,      cC`sPx+|jjD]}|ddd|(qWx|jD]}|jq8WdS(u) Reverse the row order of table rows. The table is reversed in place and there are no function arguments. Examples -------- Create a table with three columns:: >>> t = Table([['Max', 'Jo', 'John'], ['Miller','Miller','Jackson'], ... [12,15,18]], names=('firstname','name','tel')) >>> print(t) firstname name tel --------- ------- --- Max Miller 12 Jo Miller 15 John Jackson 18 Reversing order:: >>> t.reverse() >>> print(t) firstname name tel --------- ------- --- John Jackson 18 Jo Miller 15 Max Miller 12 Ni(RiRKRtreverse(RCR5R((s2lib/python2.7/site-packages/astropy/table/table.pyR scO`smtj|||}||jk riy||dt}Wqitk retdj|jqiXn|S(u^ Read and parse a data table and return as a Table. This function provides the Table interface to the astropy unified I/O layer. This allows easily reading a file in many supported data formats using syntax such as:: >>> from astropy.table import Table >>> dat = Table.read('table.dat', format='ascii') >>> events = Table.read('events.fits', format='fits') The arguments and keywords (other than ``format``) provided to this function are passed through to the underlying data reader (e.g. `~astropy.io.ascii.read`). Ru-could not convert reader output to {0} class.(t io_registrytreadRORRRRRR,(R;targsRR((s2lib/python2.7/site-packages/astropy/table/table.pyR s  cO`stj|||dS(uX Write this Table object out in the specified format. This function provides the Table interface to the astropy unified I/O layer. This allows easily writing a file in many supported data formats using syntax such as:: >>> from astropy.table import Table >>> dat = Table([[1, 2], [3, 4]], names=('a', 'b')) >>> dat.write('table.dat', format='ascii') The arguments and keywords (other than ``format``) provided to this function are passed through to the underlying data reader (e.g. `~astropy.io.ascii.write`). N(RR(RCRR((s2lib/python2.7/site-packages/astropy/table/table.pyR scC`sU|j|d|}t|drQtj|d|jjd|jj|_n|S(u; Return a copy of the table. Parameters ---------- copy_data : bool If `True` (the default), copy the underlying data array. Otherwise, use the same data array. The ``meta`` is always deepcopied regardless of the value for ``copy_data``. Ru_groupsRRe(ROR2RR&R)R'R((RCt copy_dataR((s2lib/python2.7/site-packages/astropy/table/table.pyR s cC`s |jtS(N(RR|(RCtmemo((s2lib/python2.7/site-packages/astropy/table/table.pyt __deepcopy__ scC`s |jtS(N(RR(RC((s2lib/python2.7/site-packages/astropy/table/table.pyt__copy__ scC`sGtjr-tdjtt|ntt|j|SdS(Nu unorderable types: Table() < {0}( RRRRRRjRRARgt__lt__(RCtother((s2lib/python2.7/site-packages/astropy/table/table.pyR s  cC`sGtjr-tdjtt|ntt|j|SdS(Nu unorderable types: Table() > {0}( RRRRRRjRRARgt__gt__(RCR((s2lib/python2.7/site-packages/astropy/table/table.pyR s  cC`sGtjr-tdjtt|ntt|j|SdS(Nu!unorderable types: Table() <= {0}( RRRRRRjRRARgt__le__(RCR((s2lib/python2.7/site-packages/astropy/table/table.pyR s  cC`sGtjr-tdjtt|ntt|j|SdS(Nu!unorderable types: Table() >= {0}( RRRRRRjRRARgt__ge__(RCR((s2lib/python2.7/site-packages/astropy/table/table.pyR& s  cC`s.t|tr|j}n|jrt|tjjrQ|j|k}q*tjddg|jj D]}|t f^qj}|jj |k|j |k@}nt|tjjrtjddg|jj D]}|t f^q}|j|j k|j |k@}n|j|k}|S(NiR0( R9RgRvRmRIR RRxR0RZRRuR(RCRtresulttnt false_mask((s2lib/python2.7/site-packages/astropy/table/table.pyt__eq__- s 4%4%cC`s|j|S(N(R(RCR((s2lib/python2.7/site-packages/astropy/table/table.pyt__ne__E scC`s+t|ds$tj||_n|jS(Nu_groups(R2RR&R)(RC((s2lib/python2.7/site-packages/astropy/table/table.pyRH scC`s(|jrtdntj||S(u< Group this table by the specified ``keys`` This effectively splits the table into groups which correspond to unique values of the ``keys`` grouping object. The output is a new `TableGroups` which contains a copy of this table but sorted by row according to ``keys``. The ``keys`` input to `group_by` can be specified in different ways: - String or list of strings corresponding to table column name(s) - Numpy array (homogeneous or structured) with same length as this table - `Table` with same length as this table Parameters ---------- keys : str, list of str, numpy array, or `Table` Key grouping object Returns ------- out : `Table` New table with groups set u4group_by not available for tables with mixin columns(RtNotImplementedErrorRttable_group_by(RCRe((s2lib/python2.7/site-packages/astropy/table/table.pytgroup_byN s cC`sddlm}|jr(tdntd|jjDrVtdnt}x|jjD] \}}t |t r?t j|j r?|j jdkr|jtjt j|| suKCannot convert a table with multi-dimensional columns to a pandas DataFrameuiuuu+converted column '{}' from integer to floatRNiufucu=u|(uiuu(ufuc(u=u|(tpandasRRRTRRiRKR RR9RRIRR0RMtastypetfloatRtnanRRRSRRR+tobjectRktbyteswapRl(RCRRR4R((s2lib/python2.7/site-packages/astropy/table/table.pyt to_pandasl s(  !% !c`s-t}x|jD] }||}tj|j}tj|}|jjdkrtjtj s{t f7ntj t fd|Drd|| stRuR4R(R RiRItarraytisnullR0RMRRFRtbytesRRRRR(R;t dataframeRR4RRRuRS((RRFs2lib/python2.7/site-packages/astropy/table/table.pyt from_pandas s"      ("N(kR,R-R.RRzR#RRR=RRRvR1R|RBRRtpropertyRtsetterRRRRRRRRRRRRRRRRRRRt staticmethodRRRRR[RRRt__str__RRRRRRR#RR%RGRUR>R?RmRyRR0RReRDRERGR2R4RQRbRaR<R=RnRoRpRqRrRtRsRdRRRt classmethodRRRRRRRRRRRRRRRR&R/(((s2lib/python2.7/site-packages/astropy/table/table.pyRgs$  /      !     +                5  @ L  E % $ n     %Y 7  & ? ) 8   ; ,5 ) : !            -.tQTablecB`s eZdZdZdZRS(uvA class to represent tables of heterogeneous data. `QTable` provides a class for heterogeneous tabular data which can be easily modified, for instance adding columns or new rows. The `QTable` class is identical to `Table` except that columns with an associated ``unit`` attribute are converted to `~astropy.units.Quantity` objects. Parameters ---------- data : numpy ndarray, dict, list, Table, or table-like object, optional Data to initialize table. masked : bool, optional Specify whether the table is masked. names : list, optional Specify column names. dtype : list, optional Specify column data types. meta : dict, optional Metadata associated with the table. copy : bool, optional Copy the input data. Default is True. rows : numpy ndarray, list of lists, optional Row-oriented data for table instead of ``data`` argument. copy_indices : bool, optional Copy any indices in the input data. Default is True. **kwargs : dict, optional Additional keyword args when converting table-like object. cC`s t|tS(ug Determine if ``col`` should be added to the table directly as a mixin column. (R<R(RCR5((s2lib/python2.7/site-packages/astropy/table/table.pyR scC`st|trlt|dddk rlt|jdt}||j|jdt}|j|_|}nt t |j |}|S(Nuunitu_quantity_classR( R9RRR1R.RRuRR/RARR(RCR5tq_clstqcol((s2lib/python2.7/site-packages/astropy/table/table.pyR s'  (R,R-R.RR(((s2lib/python2.7/site-packages/astropy/table/table.pyR s RcB`s;eZdZeZdZdZdZdZRS(u Mixin column class to allow storage of arbitrary numpy ndarrays within a Table. This is a subclass of numpy.ndarray and has the same initialization options as ndarray(). cO`sItj|||j|}dt|ddkrE|j|_n|S(Nuinfou__dict__((RIRRRR/(R;R:RRRC((s2lib/python2.7/site-packages/astropy/table/table.pyt__new__ scC`so|dkrdStjtt|jrDtt|j|ndt|ddkrk|j|_ndS(Nuinfou__dict__((R1RtcallableRARt__array_finalize__RR/(RCR:((s2lib/python2.7/site-packages/astropy/table/table.pyR s  cC`s<ttt|j}|d|jf|dRARt __reduce__t__dict__R?(RCt object_state((s2lib/python2.7/site-packages/astropy/table/table.pyR scC`s6|\}}tt|j||jj|dS(N(RARRRR`(RCRtnd_statet own_state((s2lib/python2.7/site-packages/astropy/table/table.pyR# s ( R,R-R.RR/RRRR(((s2lib/python2.7/site-packages/astropy/table/table.pyR s    (Pt __future__RRRRtexternRtextern.six.movesRRRRRR RhRjt collectionsR R RRRR tnumpyRIR RRtioRRtunitsRRtutilsRRtutils.compat.numpyRR0t utils.consoleRtutils.metadataRtutils.data_infoRRRRRRRRRRRR R!R"RxR#tnp_utilsR$R%R/R&R'R(R)R*t__doctest_skip__t UserWarningR+R8R<R=RRgRRLR(((s2lib/python2.7/site-packages/astropy/table/table.pyts\"    ".  w6