ó šßÈ[c@`sdZddlmZmZmZddlZddlmZddlm Z dej fd „ƒYZ d ej fd „ƒYZ d ejfd „ƒYZde fd„ƒYZde fd„ƒYZdefd„ƒYZde fd„ƒYZdefd„ƒYZdejfd„ƒYZdefd„ƒYZde fd„ƒYZde fd„ƒYZd efd!„ƒYZd"ejfd#„ƒYZd$e fd%„ƒYZd&e fd'„ƒYZd(efd)„ƒYZd*efd+„ƒYZd,efd-„ƒYZ d.efd/„ƒYZ!dS(0s+An extensible ASCII table reader and writer. basic.py: Basic table read / write functionality for simple character delimited files with various options for column header definition. :Copyright: Smithsonian Astrophysical Observatory (2011) :Author: Tom Aldcroft (aldcroft@head.cfa.harvard.edu) i(tabsolute_importtdivisiontprint_functionNi(tcorei(tzipt BasicHeadercB`s eZdZdZdZdZRS(s¤ Basic table Header Reader Set a few defaults for common ascii table formats (start at line 0, comments begin with ``#`` and possibly white space) is\s*#s# (t__name__t __module__t__doc__t start_linetcommentt write_comment(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRst BasicDatacB`s eZdZdZdZdZRS(s¢ Basic table Data Reader Set a few defaults for common ascii table formats (start at line 1, comments begin with ``#`` and possibly white space) is\s*#s# (RRRR R R (((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR stBasiccB`s&eZdZdZdZeZeZRS(s8 Read a character-delimited table with a single header line at the top followed by data lines to the end of the table. Lines beginning with # as the first non-whitespace character are comments. This reader is highly configurable. :: rdr = ascii.get_reader(Reader=ascii.Basic) rdr.header.splitter.delimiter = ' ' rdr.data.splitter.delimiter = ' ' rdr.header.start_line = 0 rdr.data.start_line = 1 rdr.data.end_line = None rdr.header.comment = r'\s*#' rdr.data.comment = r'\s*#' Example table:: # Column definition is the first uncommented line # Default delimiter is the space character. apples oranges pears # Data starts after the header column definition, blank lines ignored 1 2 3 4 5 6 tbasics"Basic table with custom delimiters( RRRt _format_namet _descriptionRt header_classR t data_class(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR ,s tNoHeaderHeadercB`seZdZdZRS(s  Reader for table header without a header Set the start of header line number to `None`, which tells the basic reader there is no header line. N(RRRtNoneR (((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRNst NoHeaderDatacB`seZdZdZRS(sz Reader for table data without a header Data starts at first uncommented line since there is no header line. i(RRRR (((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRXstNoHeadercB`s&eZdZdZdZeZeZRS(s Read a table with no header line. Columns are autonamed using header.auto_format which defaults to "col%d". Otherwise this reader the same as the :class:`Basic` class from which it is derived. Example:: # Table data 1 2 "hello there" 3 4 world t no_headersBasic table with no headers( RRRRRRRRR(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRas  tCommentedHeaderHeadercB`s eZdZd„Zd„ZRS(s› Header class for which the column definition line starts with the comment character. See the :class:`CommentedHeader` class for an example. cc`sNtj|jƒ}x5|D]-}|j|ƒ}|r||jƒVqqWdS(sƒ Return only lines that start with the comment regexp. For these lines strip out the matching characters. N(tretcompileR tmatchtend(tselftlinest re_commenttlineR((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyt process_linesws  cC`s'|j|j|jj|jƒƒdS(N(tappendR tsplittertjointcolnames(RR((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pytwrite‚s(RRRR!R&(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRqs tCommentedHeadercB`s8eZdZdZdZeZeZd„Z d„Z RS(sŒ Read a file where the column names are given in a line that begins with the header comment character. ``header_start`` can be used to specify the line index of column names, and it can be a negative index (for example -1 for the last commented line). The default delimiter is the character.:: # col1 col2 col3 # Comment line 1 2 3 4 5 6 tcommented_headers Column names in a commented linecC`s¥tt|ƒj|ƒ}d|jkr¡|jj}|dkrYt|jdƒ|}n|jd| |jd|d|jd<|jds¡|jd=q¡n|S(s Read input data (file-like object, filename, list of strings, or single string) into a Table and return the result. tcommentsii(tsuperR'treadtmetatheaderR tlen(Rttabletouttidx((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR+™s  + cC`s'|jj|ƒ|jj||ƒdS(sL Write comment lines after, rather than before, the header. N(R-R&twrite_comments(RRR,((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyt write_header¬s( RRRRRRRRRR+R3(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR'†s  tTabHeaderSplittercB`seZdZdZdZRS(s/Split lines on tab and do not remove whitespaces N(RRRt delimiterRt process_line(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR4´stTabDataSplittercB`seZdZdZeZRS(sS Don't strip data value whitespace since that is significant in TSV tables N(RRRRt process_valtFalsetskipinitialspace(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR7ºst TabHeadercB`seZdZeZRS(s? Reader for header of tables with tab separated header (RRRR4tsplitter_class(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR;ÂstTabDatacB`seZdZeZRS(s; Reader for data of tables with tab separated data (RRRR7R<(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR=ÉstTabcB`s&eZdZdZdZeZeZRS(s Read a tab-separated file. Unlike the :class:`Basic` reader, whitespace is not stripped from the beginning and end of either lines or individual column values. Example:: col1 col2 col3 # Comment line 1 2 5 ttabs%Basic table with tab-separated values( RRRRRR;RR=R(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR>Ðs  t CsvSplittercB`seZdZdZRS(s? Split on comma for CSV (comma-separated-value) tables t,(RRRR5(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR@âst CsvHeadercB`s eZdZeZdZdZRS(sJ Header that uses the :class:`astropy.io.ascii.basic.CsvSplitter` N(RRRR@R<RR R (((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRBéstCsvDatacB`s2eZdZeZejdfgZdZ dZ RS(sH Data that uses the :class:`astropy.io.ascii.basic.CsvSplitter` tN( RRRR@R<Rtmaskedt fill_valuesRR R (((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRCòs tCsvcB`s5eZdZdZeZdZeZe Z d„Z RS(sV Read a CSV (comma-separated-values) file. Example:: num,ra,dec,radius,mag 1,32.23222,10.1211,0.8,18.1 2,38.12321,-88.1321,2.2,17.0 Plain csv (comma separated value) files typically contain as many entries as there are columns on each line. In contrast, common spreadsheet editors stop writing if all remaining cells on a line are empty, which can lead to lines where the rightmost entries are missing. This Reader can deal with such files. Masked values (indicated by an empty '' field value when reading) are written out in the same way with an empty ('') field. This is different from the typical default for `astropy.io.ascii` in which missing values are indicated by ``--``. Example:: num,ra,dec,radius,mag 1,32.23222,10.1211 2,38.12321,-88.1321,2.2,17.0 tcsvsComma-separated-valuescC`s7t|ƒ|kr3|j|t|ƒdgƒn|S(sQ Adjust row if it is too short. If a data row is shorter than the header, add empty values to make it the right length. Note that this will *not* be called if the row already matches the header. Parameters ---------- str_vals : list A list of value strings from the current row of the table. ncols : int The expected number of entries from the table header. Returns ------- str_vals : list List of strings to be parsed into data entries in the output table. RD(R.textend(Rtstr_valstncols((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pytinconsistent_handlers!( RRRRtTruet_io_registry_can_writeRRBRRCRRL(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRGüst RdbHeadercB`sCeZdZiejd6ejd6Zd„Zd„Zd„Z RS(s Header for RDB tables tntscC`s |jdS(Niÿÿÿÿ(traw_type(Rtcol((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pytget_type_map_key>sc C`s|j|ƒ}gttdƒ|j|ƒƒD]\}}|^q.}t|ƒdkrgtdƒ‚n|\|_}t|jƒt|ƒkr tdƒ‚ntd„|DƒƒrÎtdj|ƒƒ‚n|j ƒx;t|j |ƒD]'\}}||_ |j |ƒ|_ qëWdS(sw Initialize the header Column objects from the table ``lines``. This is a specialized get_cols for the RDB type: Line 0: RDB col names Line 1: RDB col definitions Line 2+: RDB data rows Parameters ---------- lines : list List of table lines Returns ------- None isRDB header requires 2 linessCRDB header mismatch between number of column names and column typescs`s(|]}tjd|tjƒ VqdS(s \d*(N|S)$N(RRt IGNORECASE(t.0tx((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pys ^ss5RDB types definitions do not all match [num](N|S): {}N(R!RtrangeR#R.t ValueErrortnamestanytformatt_set_cols_from_namestcolsRRt get_col_typettype( RRt header_linest_thltheader_vals_listt raw_typesRSRR((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pytget_colsAs7  cC`s|j|jj|jƒƒg}x?|jD]4}|jjjdkrMdnd}|j|ƒq,W|j|jj|ƒƒdS(NtStUtN(RgRh(R"R#R$R%R^tinfotdtypetkind(RRt rdb_typesRStrdb_type((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyR&fs !( RRRRtNumTypetStrTypet col_type_mapRTRfR&(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRO7s     %tRdbDatacB`seZdZdZRS(s= Data reader for RDB data. Starts reading at line 2. i(RRRR (((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRrqstRdbcB`s5eZdZdZdgZdZdZeZe Z RS(s Read a tab-separated file with an extra line after the column definition line. The RDB format meets this definition. Example:: col1 col2 col3 N S N 1 2 5 In this reader the second line is just ignored. trdbs.rdbs0Tab-separated with a type definition header line( RRRRt_io_registry_format_aliasest_io_registry_suffixRRORRrR(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyRsxs  ("Rt __future__RRRRRDRtextern.six.movesRt BaseHeaderRtBaseDataR t BaseReaderR RRRRR'tDefaultSplitterR4R7R;R=R>R@RBRCRGRORrRs(((s5lib/python2.7/site-packages/astropy/io/ascii/basic.pyt s0   "  .  ;: