ó šßÈ[c@`sídZddlmZmZmZddlZddlmZddlm Z ddl m Z iid d 6d d 6d d6d d6d6id d 6d d 6dd6dd6d6i d d 6dd6dd6dd6dd6d d 6dd6dd6dd6dd6idd6dd6d6d6Z ej dƒZd „Zd!„Zd"e jfd#„ƒYZd$e jfd%„ƒYZd&e jfd'„ƒYZd(e jfd)„ƒYZd*efd+„ƒYZd,efd-„ƒYZd.efd/„ƒYZd0efd1„ƒYZdS(2sÑAn extensible ASCII table reader and writer. latex.py: Classes to read and write LaTeX tables :Copyright: Smithsonian Astrophysical Observatory (2011) :Author: Tom Aldcroft (aldcroft@head.cfa.harvard.edu) i(tabsolute_importtdivisiontprint_functionNi(tsix(tzipi(tcorettablet tabletypes \hline \hlinet header_starts\hlinet header_endtdata_endtAAs \hline\hlinet doublelinestcaptiont tablealignt col_aligntpreamblet data_startt tablefoots unit of col1tcol1s unit of col2tcol2tunitsttemplates(?rss \\(t delimitertjoin(R3tvalsR?((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyR@os(t__name__t __module__t__doc__R?R2R7R;R@(((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyR+Qs   t LatexHeadercB`s5eZdZdZeZd„Zd„Zd„ZRS(s(Class to read the header of Latex Tabless\begin{tabular}cC`s.t||jƒ}|dk r&|dSdSdS(Ni(R*RR$(R3R%R)((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyt start_linezs cC`si}g|jD]}|jj^q}xat|j|ƒD]M\}}|r;y|jddƒ||( RBRCRDRR+tsplitter_classRFRRR\(((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyREus   t LatexDatacB`s;eZdZdZdZeZd„Zd„Z d„Z RS(s&Class to read the data in LaTeX tabless \end{tabular}cC`s1|jrt||jƒS|jj|ƒdSdS(Ni(RR*theaderRF(R3R%((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyRF©s cC`s!|jrt||jƒSdSdS(N(R R*R$(R3R%((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pytend_line¯s cC`s’t|jd|ƒtjj||ƒt|jd|ƒ|j|jƒt|jd|ƒ|jddk rŽ|jd|jddƒndS(NRR RRs\end{R9(RR&RtBaseDataR\RR R$(R3R%((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyR\µsN( RBRCRDR$RR R+R]RFR`R\(((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyR^£s  tLatexcB`s_eZdZdZdgZdZdZeZe Z dddgidd d„Z d d „Z RS( sWrite and read LaTeX tables. This class implements some LaTeX specific commands. Its main purpose is to write out a table in a form that LaTeX can compile. It is beyond the scope of this class to implement every possible LaTeX command, instead the focus is to generate a syntactically valid LaTeX tables. This class can also read simple LaTeX tables (one line per table row, no ``\multicolumn`` or similar constructs), specifically, it can read the tables that it writes. Reading a LaTeX table, the following keywords are accepted: **ignore_latex_commands** : Lines starting with these LaTeX commands will be treated as comments (i.e. ignored). When writing a LaTeX table, the some keywords can customize the format. Care has to be taken here, because python interprets ``\\`` in a string as an escape character. In order to pass this to the output either format your strings as raw strings with the ``r`` specifier or use a double ``\\\\``. Examples:: caption = r'My table \label{mytable}' caption = 'My table \\\\label{mytable}' **latexdict** : Dictionary of extra parameters for the LaTeX output * tabletype : used for first and last line of table. The default is ``\\begin{table}``. The following would generate a table, which spans the whole page in a two-column document:: ascii.write(data, sys.stdout, Writer = ascii.Latex, latexdict = {'tabletype': 'table*'}) If ``None``, the table environment will be dropped, keeping only the ``tabular`` environment. * tablealign : positioning of table in text. The default is not to specify a position preference in the text. If, e.g. the alignment is ``ht``, then the LaTeX will be ``\\begin{table}[ht]``. * col_align : Alignment of columns If not present all columns will be centered. * caption : Table caption (string or list of strings) This will appear above the table as it is the standard in many scientific publications. If you prefer a caption below the table, just write the full LaTeX command as ``latexdict['tablefoot'] = r'\caption{My table}'`` * preamble, header_start, header_end, data_start, data_end, tablefoot: Pure LaTeX Each one can be a string or a list of strings. These strings will be inserted into the table without any further processing. See the examples below. * units : dictionary of strings Keys in this dictionary should be names of columns. If present, a line in the LaTeX table directly below the column names is added, which contains the values of the dictionary. Example:: from astropy.io import ascii data = {'name': ['bike', 'car'], 'mass': [75,1200], 'speed': [10, 130]} ascii.write(data, Writer=ascii.Latex, latexdict = {'units': {'mass': 'kg', 'speed': 'km/h'}}) If the column has no entry in the ``units`` dictionary, it defaults to the **unit** attribute of the column. If this attribute is not specified (i.e. it is None), the unit will be written as ``' '``. Run the following code to see where each element of the dictionary is inserted in the LaTeX table:: from astropy.io import ascii data = {'cola': [1,2], 'colb': [3,4]} ascii.write(data, Writer=ascii.Latex, latexdict=ascii.latex.latexdicts['template']) Some table styles are predefined in the dictionary ``ascii.latex.latexdicts``. The following generates in table in style preferred by A&A and some other journals:: ascii.write(data, Writer=ascii.Latex, latexdict=ascii.latex.latexdicts['AA']) As an example, this generates a table, which spans all columns and is centered on the page:: ascii.write(data, Writer=ascii.Latex, col_align='|lr|', latexdict={'preamble': r'\begin{center}', 'tablefoot': r'\end{center}', 'tabletype': 'table*'}) **caption** : Set table caption Shorthand for:: latexdict['caption'] = caption **col_align** : Set the column alignment. If not present this will be auto-generated for centered columns. Shorthand for:: latexdict['col_align'] = col_align R&s.texs LaTeX tablethlinetvspacet tablelineRVcC`sÕtt|ƒjƒi|_|j|j_|j|j_d|jd<|jj|ƒ|rm||jd((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyR@es(RBRCRDR2R7R@(((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyRtNs  t AASTexHeadercB`s,eZdZdZeZd„Zd„ZRS(sÀIn a `deluxetable `_ some header keywords differ from standard LaTeX. This header is modified to take that into account. s \tableheadcC`s t|dƒS(Ns \tablehead(R*(R3R%((s5lib/python2.7/site-packages/astropy/io/ascii/latex.pyRFsscC`s†d|jkr,t|jƒd|jdeZdZdZdgZdZdZeZe Z d„Z RS(sŽWrite and read AASTeX tables. This class implements some AASTeX specific commands. AASTeX is used for the AAS (American Astronomical Society) publications like ApJ, ApJL and AJ. It derives from the ``Latex`` reader and accepts the same keywords. However, the keywords ``header_start``, ``header_end``, ``data_start`` and ``data_end`` in ``latexdict`` have no effect. taastexRVs(AASTeX deluxetable used for AAS journalscK`sFtt|ƒj|d|ko/d|dksBd|jd s:       $.#