pandas.Series.to_latex

Series.to_latex(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)[source]

Вывод объекта в LaTeX таблицу, длинную таблицу или вложенную таблицу.

Требуется \usepackage{booktabs}. Вывод можно скопировать/вставить в основной документ LaTeX или читать из внешнего файла с помощью \input{table.tex}.

Изменено в версии 1.0.0: Добавлены аргументы caption и label.

Изменено в версии 1.2.0: Добавлен аргумент position, изменено значение аргумента caption.

Параметры

buf:str, Path или StringIO-подобный объект, необязательно, по умолчанию None

Буфер для записи. Если None, результат возвращается в виде строки.

columns:список меток, необязательно

Подмножество столбцов для записи. По умолчанию записываются все столбцы.

col_space:int, необязательно

Минимальная ширина каждого столбца.

header:bool или список строк, по умолчанию True

Выводить названия столбцов. Если передан список строк, предполагается, что это псевдонимы для названий столбцов.

index:bool, по умолчанию True

Выводить имена строк (индекс).

na_rep:строка, по умолчанию ‘NaN’

Представление пропущенных данных.

formatters:список функций или словарь {строка: функция}, необязательно

Функции форматирования для применения к элементам столбцов по позиции или имени. Результатом каждой функции должна быть строка Unicode. Список должен иметь длину, равную количеству столбцов.

float_format:функция с одним параметром или строка, необязательно, по умолчанию None

Функция форматирования для чисел с плавающей запятой. Например float_format="%.2f" и float_format="{:0.2f}".format приведут к форматированию 0.1234 как 0.12.

sparsify:bool, необязательно

Установите в False для DataFrame с иерархическим индексом, чтобы печатать каждый ключ многоуровневого индекса в каждой строке. По умолчанию значение будет считано из модуля конфигурации.

index_names:bool, по умолчанию True

Выводит имена индексов.

bold_rows:bool, по умолчанию False

Сделать метки строк жирными в выводе.

column_format:строка, необязательно

Формат столбцов, как указано в формате LaTeX таблиц, например, ‘rcl’ для 3 столбцов. По умолчанию для всех столбцов, кроме столбцов с числами, используется ‘l’, для которых по умолчанию используется ‘r’.

longtable:bool, необязательно

По умолчанию значение будет взято из модуля конфигурации pandas. Используйте среду longtable вместо tabular. Требуется добавить usepackage{longtable} в преамбулу LaTeX.

escape:bool, необязательно

По умолчанию значение будет взято из модуля конфигурации pandas. При значении False предотвращает экранирование специальных символов LaTeX в именах столбцов.

encoding:строка, необязательно

Строка, представляющая кодировку, используемую в выходном файле, по умолчанию ‘utf-8’.

decimal:строка, по умолчанию ‘.’

Символ, распознаваемый как десятичный разделитель, например ‘,’ в Европе.

multicolumn:bool, по умолчанию True

Использовать multicolumn для улучшения столбцов MultiIndex. Значение по умолчанию будет считано из модуля конфигурации.

multicolumn_format:строка, по умолчанию ‘l’

Выравнивание для multicolumns, аналогично column_format. Значение по умолчанию будет считано из модуля конфигурации.

multirow:bool, по умолчанию False

Использовать multirow для улучшения строк MultiIndex. Требуется добавить usepackage{multirow} в преамбулу LaTeX. Будет печатать центрированные метки (вместо выравнивания по верху) по содержащимся строкам, разделяя группы с помощью clines. Значение по умолчанию будет считано из модуля конфигурации pandas.

caption:строка или кортеж, необязательно

Кортеж (full_caption, short_caption), что приводит к \caption[short_caption]{full_caption}; если передана единственная строка, короткая подпись не будет установлена.

Новое в версии 1.0.0.

Изменено в версии 1.2.0: Допускается передача caption в качестве кортежа (full_caption, short_caption).

label:строка, необязательно

Метка LaTeX, которая будет размещена внутри \label{} в выводе. Используется с \ref{} в основном файле .tex.

Новое в версии 1.0.0.

position:строка, необязательно

Позиционный аргумент LaTeX для таблиц, который будет помещен после \begin{} в выводе.

Новое в версии 1.2.0.

Возвращает

строка или None

Если buf равно None, возвращает результат в виде строки. В противном случае возвращает None.

См. также

io.formats.style.Styler.to_latex

Вывод DataFrame в LaTeX с условным форматированием.

DataFrame.to_string

Вывод DataFrame в консольный вывод в табличном формате.

DataFrame.to_html

Вывод DataFrame как HTML таблицы.

Примеры

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