pandas.DataFrame.to_latex#

DataFrame.to_latex(buf=None, *, столбцы=None, header=True, index=True, na_rep='NaN', форматеры=None, float_format=None, разрежать=None, index_names=True, bold_rows=False, column_format=None, longtable=None, escape=None, кодировка=None, десятичный='.', многостолбцовый=None, GH 5123=None, multirow=None, заголовок=None, метка=None, позиция=None)[источник]#

Отобразить объект в виде таблицы LaTeX, longtable или вложенной таблицы.

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

Изменено в версии 2.0.0: Рефакторинг для использования реализации Styler через шаблонизацию jinja2.

Параметры:

bufstr, Path или StringIO-like, опционально, по умолчанию None: Буфер для записи. Если None, вывод возвращается в виде строки.
столбцысписок меток, опционально: Подмножество столбцов для записи. По умолчанию записываются все столбцы.
headerbool или список строк, по умолчанию True: Записать названия столбцов. Если задан список строк, предполагается, что это псевдонимы для названий столбцов.
indexbool, по умолчанию True: Записать имена строк (индекс).
na_repstr, по умолчанию ‘NaN’: Представление отсутствующих данных.
форматерысписок функций или словарь {{str: function}}, необязательно: Функции форматирования для применения к элементам столбцов по позиции или имени. Результат каждой функции должен быть строкой в Unicode. Список должен иметь длину, равную количеству столбцов.
float_formatоднопараметрическая функция или str, опционально, по умолчанию None: Форматирование для чисел с плавающей точкой. Например float_format="%.2f" и float_format="{{:0.2f}}".format приведут к форматированию 0.1234 как 0.12.
разрежатьbool, необязательно: Установить в False для DataFrame с иерархическим индексом, чтобы выводить каждый ключ мультииндекса в каждой строке. По умолчанию значение будет считываться из конфигурационного модуля.
index_namesbool, по умолчанию True: Выводит названия индексов.
bold_rowsbool, по умолчанию False: Сделать метки строк жирными в выводе.
column_formatstr, optional: Формат столбцов, как указано в Формат таблицы LaTeX например, 'rcl' для 3 столбцов. По умолчанию 'l' будет использоваться для всех столбцов, кроме столбцов с числами, которые по умолчанию используют 'r'.
longtablebool, необязательно: Использовать среду longtable вместо tabular. Требует добавления usepackage{{longtable}} в преамбулу LaTeX. По умолчанию значение будет прочитано из модуля конфигурации pandas и установлено в True если опция styler.latex.environment является “longtable”.

Изменено в версии 2.0.0: Параметр pandas, влияющий на этот аргумент, изменился.
escapebool, необязательно: По умолчанию значение будет прочитано из модуля конфигурации pandas и установлено в True если опция styler.format.escape является “latex”. При установке в False предотвращает экранирование специальных символов LaTeX в именах столбцов.

Изменено в версии 2.0.0: Параметр pandas, влияющий на этот аргумент, изменился, как и значение по умолчанию на False.
кодировкаstr, optional: Строка, представляющая кодировку для использования в выходном файле, по умолчанию 'utf-8'.
десятичныйstr, default ‘.’: Символ, распознаваемый как десятичный разделитель, например, ',' в Европе.
многостолбцовыйbool, по умолчанию True: Используйте multicolumn для улучшения MultiIndex столбцов. Значение по умолчанию будет прочитано из модуля конфигурации и установлено как опция styler.sparse.columns.

Изменено в версии 2.0.0: Параметр pandas, влияющий на этот аргумент, изменился.
GH 5123строка, по умолчанию 'r': Выравнивание для многоколонок, аналогичное column_format Значение по умолчанию будет считано из конфигурационного модуля и установлено как опция styler.latex.multicol_align.

Изменено в версии 2.0.0: Опция pandas, влияющая на этот аргумент, изменилась, как и значение по умолчанию на "r".
multirowbool, по умолчанию True: Используйте multirow для улучшения строк MultiIndex. Требует добавления usepackage{{multirow}} в преамбулу LaTeX. Будет печатать центрированные метки (вместо выровненных по верху) по охватываемым строкам, разделяя группы с помощью clines. Значение по умолчанию будет прочитано из модуля конфигурации pandas и установлено как опция styler.sparse.index.

Изменено в версии 2.0.0: Параметр pandas, влияющий на этот аргумент, изменился, как и значение по умолчанию на True.
заголовокstr или tuple, опционально: Кортеж (full_caption, short_caption), что приводит к \caption[short_caption]{{full_caption}}; если передана одна строка, короткая подпись не будет установлена.
меткаstr, optional: Метка LaTeX, которая будет размещена внутри \label{{}} в выводе. Используется с \ref{{}} в основной ветке .tex файл.
позицияstr, optional: Позиционный аргумент LaTeX для таблиц, который должен быть размещён после \begin{{}} в выводе.

Возвращает:

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

Смотрите также

io.formats.style.Styler.to_latex: Отрисовать DataFrame в LaTeX с условным форматированием.
DataFrame.to_string: Отобразить DataFrame в табличном формате, удобном для консоли.
DataFrame.to_html: Отобразить DataFrame как HTML-таблицу.

Примечания

Начиная с v2.0.0 этот метод изменился для использования реализации Styler как части Styler.to_latex() через jinja2 шаблонизация. Это означает, что jinja2 является требованием и должен быть установлен для работы этого метода. Рекомендуется пользователям перейти на использование Styler, поскольку эта реализация обновляется чаще и обеспечивает гораздо большую гибкость вывода.

Примеры

Преобразовать общий DataFrame в LaTeX с форматированием:

>>> df = pd.DataFrame(dict(name=['Raphael', 'Donatello'],
...                        age=[26, 45],
...                        height=[181.23, 177.65]))
>>> print(df.to_latex(index=False,
...                   formatters={"name": str.upper},
...                   float_format="{:.1f}".format,
... ))  
\begin{tabular}{lrr}
\toprule
name & age & height \\
\midrule
RAPHAEL & 26 & 181.2 \\
DONATELLO & 45 & 177.7 \\
\bottomrule
\end{tabular}