to_latex(self, buf=None, columns=None, col_space=None, header=True, index=True, na_rep='NaN', formatters=None, float_format=None, sparsify=None, index_names=True, bold_rows=False, column_format=None, longtable=None, escape=None, encoding=None, decimal='.', multicolumn=None, multicolumn_format=None, multirow=None, caption=None, label=None, position=None)

Requires \usepackage{booktabs} . The output can be copy/pasted into a main LaTeX document or read from an external file with \input{table.tex} .

Parameters

buf : str, Path or StringIO-like, optional, default None

Buffer to write to. If None, the output is returned as a string.

columns : list of label, optional

The subset of columns to write. Writes all columns by default.

col_space : int, optional

The minimum width of each column.

header : bool or list of str, default True

Write out the column names. If a list of strings is given, it is assumed to be aliases for the column names.

index : bool, default True

Write row names (index).

na_rep : str, default 'NaN'

Missing data representation.

formatters : list of functions or dict of {str: function}, optional

Formatter functions to apply to columns' elements by position or name. The result of each function must be a unicode string. List must be of length equal to the number of columns.

float_format : one-parameter function or str, optional, default None

Formatter for floating point numbers. For example float_format="%.2f" and float_format="{:0.2f}".format will both result in 0.1234 being formatted as 0.12.

sparsify : bool, optional

Set to False for a DataFrame with a hierarchical index to print every multiindex key at each row. By default, the value will be read from the config module.

index_names : bool, default True

Prints the names of the indexes.

bold_rows : bool, default False

Make the row labels bold in the output.

column_format : str, optional

The columns format as specified in :None:None:`LaTeX table format <https://en.wikibooks.org/wiki/LaTeX/Tables>` e.g. 'rcl' for 3 columns. By default, 'l' will be used for all columns except columns of numbers, which default to 'r'.

longtable : bool, optional

By default, the value will be read from the pandas config module. Use a longtable environment instead of tabular. Requires adding a \usepackage{longtable} to your LaTeX preamble.

escape : bool, optional

By default, the value will be read from the pandas config module. When set to False prevents from escaping latex special characters in column names.

encoding : str, optional

A string representing the encoding to use in the output file, defaults to 'utf-8'.

decimal : str, default '.'

Character recognized as decimal separator, e.g. ',' in Europe.

multicolumn : bool, default True

Use \multicolumn to enhance MultiIndex columns. The default will be read from the config module.

multicolumn_format : str, default 'l'

The alignment for multicolumns, similar to :None:None:`column_format` The default will be read from the config module.

multirow : bool, default False

Use \multirow to enhance MultiIndex rows. Requires adding a \usepackage{multirow} to your LaTeX preamble. Will print centered labels (instead of top-aligned) across the contained rows, separating groups via clines. The default will be read from the pandas config module.

caption : str or tuple, optional

Tuple (full_caption, short_caption), which results in \caption[short_caption]{full_caption} ; if a single string is passed, no short caption will be set.

versionadded

versionchanged

Optionally allow caption to be a tuple (full_caption, short_caption) .

label : str, optional

The LaTeX label to be placed inside \label{} in the output. This is used with \ref{} in the main .tex file.

versionadded

position : str, optional

The LaTeX positional argument for tables, to be placed after \begin{} in the output.

versionadded

Returns

str or None

If buf is None, returns the result as a string. Otherwise returns None.

Render object to a LaTeX tabular, longtable, or nested table.

See Also

DataFrame.to_html

Render a DataFrame as an HTML table.

DataFrame.to_string

Render a DataFrame to a console-friendly tabular output.

Styler.to_latex

Render a DataFrame to LaTeX with conditional formatting.

Examples

This example is valid syntax, but we were not able to check execution

>>> df = pd.DataFrame(dict(name=['Raphael', 'Donatello'],
...                   mask=['red', 'purple'],
...                   weapon=['sai', 'bo staff']))
... print(df.to_latex(index=False))  # doctest: +SKIP
\begin{tabular}{lll}
 \toprule
       name &    mask &    weapon \\
 \midrule
    Raphael &     red &       sai \\
  Donatello &  purple &  bo staff \\
\bottomrule
\end{tabular}

See :

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them

---

File: /pandas/core/generic.py#3180
type: <class 'function'>
Commit: