Таблицы результатов в LaTeX: booktabs, выравнивание по десятичной точке и сгруппированная шапка

БлогEasyLaTeXОпубликовано

Таблицы с результатами экспериментов в статьях обычно собирают из трёх элементов: booktabs для таблицы с тремя горизонтальными линиями, столбец S из siunitx для выравнивания чисел по десятичной точке и \multicolumn вместе с \cmidrule для сгруппированной шапки вида «набор данных A / набор данных B». Ниже на примере данных приведён полный компилируемый исходный код и по порядку разобраны выделение лучших значений, пропущенные значения, единицы измерения, примечания к таблице и сверка чисел.

Пример данных

Числа ниже приведены только для демонстрации и не получены в реальном эксперименте. Предположим, что четыре метода запускались по три раза на двух наборах данных, а средние значения собраны в CSV:

Plain text
method,params_m,acc_a,f1_a,acc_b,f1_bBaseline,11.2,84.3,82.1,76.5,74.0Prior work,340,87.1,85.6,,Baseline + aug.,11.2,86.7,85.0,78.9,77.2Ours,12.8,88.2,86.4,80.3,79.6

Для Prior work результаты на наборе B не опубликованы, поэтому два последних поля пустые. В столбце с числом параметров есть и 11.2, и целое 340, что удобно для демонстрации десятичного выравнивания.

Полный исходный код

Сохраните код как main.tex и скомпилируйте pdfLaTeX. В примере используется класс документа article и загружаются booktabs, siunitx и caption.

LaTeX
\documentclass[a4paper,11pt]{article}\usepackage{booktabs}\usepackage{siunitx}\usepackage{caption}\captionsetup[table]{position=above}\sisetup{  reset-text-series   = false,  text-series-to-math = true,}​\begin{document}​\begin{table}[htbp]  \centering  \caption{Results on two benchmarks (illustrative data).    Best values in each column are in bold.}  \label{tab:results}  \begin{tabular}{      l      S[table-format=3.1]      S[table-format=2.1]      S[table-format=2.1]      S[table-format=2.1]      S[table-format=2.1]    }    \toprule    & & \multicolumn{2}{c}{Dataset A} & \multicolumn{2}{c}{Dataset B} \\    \cmidrule(lr){3-4} \cmidrule(lr){5-6}    Method & {Params (M)} & {Acc (\%)} & {F1 (\%)} & {Acc (\%)} & {F1 (\%)} \\    \midrule    Baseline        &  11.2 & 84.3 & 82.1 & 76.5 & 74.0 \\    Prior work      & 340   & 87.1 & 85.6 & {--} & {--} \\    Baseline + aug. &  11.2 & 86.7 & 85.0 & 78.9 & 77.2 \\    Ours            &  12.8 & \bfseries 88.2 & \bfseries 86.4                            & \bfseries 80.3 & \bfseries 79.6 \\    \bottomrule  \end{tabular}​  \medskip  \footnotesize  Mean of three runs; -- means not reported.\end{table}​Table~\ref{tab:results} compares four methods.​\end{document}

После компиляции в PDF получается таблица с заголовком и тремя линиями: вверху Dataset A и Dataset B, каждый занимает два столбца и подчёркнут короткой линией; в столбце параметров 340 выровнено по целой части с 11.2 и 12.8; четыре метрики в последней строке выделены жирным; под таблицей идёт строка примечания мелким шрифтом.

Схема процесса: числа в CSV, исходном коде LaTeX и свёрстанной таблице однозначно соответствуют друг другу. Для наглядности на рисунке оставлены только две строки данных и три столбца.

Три линии: команды booktabs

booktabs предоставляет четыре команды:

КомандаМестоНазначение
\topruleперед первой строкой таблицыверхняя линия, более толстая
\midruleмежду шапкой и даннымисредняя линия, более тонкая
\bottomruleпосле последней строкинижняя линия, более толстая
\cmidrule(lr){a-b}под групповым заголовкомкороткая линия только под столбцами с a по b

У этих линий есть собственные отступы сверху и снизу, поэтому таблица не выглядит тесной. С booktabs обычно не используют вертикальные линии и не смешивают эти команды с \hline, иначе толщина линий будет разной. Если шаблон журнала требует иного, следуйте шаблону.

Пакет caption и \captionsetup[table]{position=above} в примере отвечают за отступ заголовка. Заголовок таблицы принято ставить над ней, а article по умолчанию рассчитывает отступ для заголовка снизу. Без этих двух строк заголовок прилипает к верхней линии. \label нужно писать после \caption, иначе номер в ссылке будет неверным.

Десятичное выравнивание: столбец S из siunitx

Обычный столбец c центрирует каждую ячейку. Если у чисел разное количество цифр, десятичные точки оказываются на разных позициях:

LaTeX
\begin{tabular}{lcc}  \hline  Method & Params (M) & Acc (\%) \\  \hline  Baseline & 11.2 & 84.3 \\  Prior work & 340 & 87.1 \\  \hline\end{tabular}

Здесь 340 центрируется и не совпадает по десятичной точке с 11.2. Если сменить тип столбца на S, siunitx разделит каждое число на целую и дробную части и выровняет их по десятичной точке:

Сравнение выравнивания: слева столбец c, справа S[table-format=3.1]. У 340 нет дробной части, его разряд единиц выровнен по разряду единиц остальных чисел.

table-format сообщает siunitx, сколько разрядов резервировать:

  • 3.1: до 3 цифр в целой части и 1 в дробной, для значений от 11.2 до 340.
  • 2.1: 2 цифры в целой части и 1 в дробной, для процентов вроде 84.3.
  • Со знаком пишут, например, +2.1, с погрешностью — 2.1(1), см. ниже.

table-format влияет только на ширину столбца и выравнивание, сами числа не меняются. Если значение слишком мало, числа выходят за отведённую ширину и не совпадают с шапкой; тогда подберите его по самому длинному числу.

Нечисловое содержимое в столбце S нужно заключать в фигурные скобки. Так оформлены и шапка {Acc (\%)}, и пропущенное значение {--}. Без скобок siunitx пытается разобрать их как числа, выдаёт ошибку Invalid number и останавливает компиляцию.

Сгруппированная шапка: \multicolumn и \cmidrule

Для сгруппированной шапки нужны две строки:

LaTeX
& & \multicolumn{2}{c}{Dataset A} & \multicolumn{2}{c}{Dataset B} \\\cmidrule(lr){3-4} \cmidrule(lr){5-6}Method & {Params (M)} & {Acc (\%)} & {F1 (\%)} & {Acc (\%)} & {F1 (\%)} \\
  • Два & в начале первой строки оставляют пустыми столбцы Method и Params. \multicolumn{2}{c}{Dataset A} объединяет столбцы 3 и 4, Dataset B — столбцы 5 и 6. Число объединённых столбцов вместе с пустыми ячейками должно равняться общему числу столбцов таблицы, здесь 6.
  • \cmidrule(lr){3-4} рисует короткую линию под столбцами 3–4. (lr) немного укорачивает линию с обоих концов, так что между двумя групповыми линиями остаётся промежуток и видно, что они относятся к разным группам.
  • \multicolumn — встроенная команда LaTeX, \cmidrule входит в booktabs. Когда \multicolumn применяется к столбцам S, объединённая ячейка выравнивается по указанному c и не разбирается как число, поэтому Dataset A не нужно заключать в фигурные скобки.

Если заголовок должен занимать две строки, например чтобы Method слева был центрирован по вертикали, можно использовать \multirow из пакета multirow. В таблицах с тремя линиями чаще такие заголовки ставят во вторую строку, а первую оставляют пустой, как в примере.

Лучшие значения, пропуски, единицы и примечания

Выделение лучших значений

Для жирного шрифта в столбце S в примере используется \bfseries 88.2, а в преамбуле задано:

LaTeX
\sisetup{  reset-text-series   = false,  text-series-to-math = true,}

По умолчанию siunitx сбрасывает насыщенность шрифта. Эти две опции позволяют \bfseries в ячейке работать, а числа при этом остаются выровненными по десятичной точке. Опция detect-weight, часто встречающаяся в старых руководствах, в проверенной здесь версии siunitx v3.6.7 вызывает сообщение об устаревании, и лог рекомендует использовать вместо неё две опции выше.

Перед выделением проверьте максимум в каждом столбце. В этом примере Ours лидирует по всем четырём метрикам: на наборе A — 88.2 и 86.4, на наборе B — 80.3 и 79.6. Для числа параметров лучше меньшее значение, это не столбец, где наибольшее значение является лучшим, поэтому в примере он не выделен. Правило выделения стоит указать в шапке или заголовке. Если для метрики лучше меньшее значение, это тоже нужно отметить, например Loss ($\downarrow$) в шапке.

Пропущенные значения

В примере неопубликованные результаты обозначены {--}: в PDF это короткое тире, а его смысл объяснён в примечании. Можно писать и {n/a}, главное — единообразно во всём тексте. Не записывайте пропуск как 0: читатель решит, что результат равен 0.

Единицы измерения

Единицы указываются в шапке, в ячейках остаются только числа, например {Acc (\%)}, {Params (M)}. Для единиц СИ можно использовать \unit из siunitx:

LaTeX
\begin{tabular}{l S[table-format=2.1(1)] S[table-format=3.0]}  \toprule  Method & {Acc (\%)} & {Latency (\unit{\milli\second})} \\  \midrule  Baseline & 84.3(4) & 12  \\  Ours     & 88.2(3) & 105 \\  \bottomrule\end{tabular}

Если добавить в преамбулу \sisetup{uncertainty-mode = separate}, 84.3(4) выводится как 84.3 ± 0.4, а 88.2(3) — как 88.2 ± 0.3. Число в скобках означает погрешность последнего разряда, table-format=2.1(1) резервирует под неё один разряд. Если в статье приводится стандартное отклонение или стандартная ошибка, укажите в примечании, что именно и по скольким запускам.

Примечания к таблице

В примере после tabular с помощью \footnotesize добавлена строка пояснения: по скольким запускам усреднены значения и что означает --. Если примечаний много и нужны пометки a, b и т. д., можно использовать пакет threeparttable. Шаблоны журналов обычно задают формат примечаний, поэтому перед подачей сверьтесь с требованиями для авторов.

Сверка чисел: на пути от данных к таблице значения не должны меняться

Самая частая ошибка в таблицах результатов — неверно перенесённые числа. После каждой правки рекомендуется проверять:

  1. Округление выполняется на этапе данных. Сколько знаков в CSV, столько и в таблице. siunitx тоже умеет округлять, например \num[round-mode=places, round-precision=1]{88.15} даёт 88.2, а 86.449 — 86.4, но тогда числа в исходном коде расходятся с числами в PDF, и при проверке это легко пропустить.
  2. Построчная сверка. В примере CSV 4 строки данных, значит, и в таблице должно быть 4 строки; в каждой строке 5 числовых полей, соответствующих 5 столбцам S. Пустым полям соответствует {--}.
  3. Повторная проверка лучших значений. После добавления или удаления строки или изменения данных выделение может оказаться не там.
  4. Проверка единиц и знака процента. 0.843 и 84.3% нельзя смешивать в одном столбце.

При большом объёме данных строки таблицы можно генерировать скриптом из CSV и вставлять результат в LaTeX, чтобы меньше переписывать вручную. Каким бы способом вы ни пользовались, в конце всё равно сверьте таблицу с PDF.

Частые проблемы

СимптомПричинаИсправление
Package siunitx Error: Invalid number '('текст шапки в столбце S не заключён в фигурные скобкиписать {Acc (\%)}
Invalid number '--'пропущенное значение не заключено в фигурные скобкиписать {--}
Undefined control sequence указывает на \toprule или \cmidruleне загружен booktabsдобавить \usepackage{booktabs} в преамбулу
заголовок прилипает к верхней линиизаголовок стоит над таблицей, а отступ рассчитан для заголовка снизузагрузить caption и задать position=above
\bfseries не делает текст жирнымsiunitx по умолчанию сбрасывает насыщенность шрифтазадать reset-text-series = false и text-series-to-math = true
числа смещены относительно шапкиtable-format резервирует недостаточно разрядовподобрать по самому длинному числу в столбце
Extra alignment tab has been changed to \crв строке больше &, чем столбцовпересчитать разделители в каждой строке, объединённую ячейку считать по числу объединённых столбцов

Другие ошибки в таблицах разобраны в статье Частые проблемы в таблицах LaTeX, созданных ИИ.

Проверка локально или в EasyLaTeX

При локальной установке TeX Live или MiKTeX запустите компиляцию дважды в каталоге с main.tex; второй проход нужен для разрешения \ref:

Shell
pdflatex -interaction=nonstopmode -halt-on-error main.texpdflatex -interaction=nonstopmode -halt-on-error main.tex

Затем проверьте main.log на ошибки и Overfull \hbox, откройте PDF и сверьте с CSV каждое число, расположение жирного шрифта и примечание.

В EasyLaTeX поместите исходный код в главный файл проекта, убедитесь, что выбран правильный главный файл, и для этого англоязычного примера на article выберите pdfLaTeX. При ошибке компиляции смотрите сообщения и Original Log на панели Bug. Если нужна помощь в поиске причины, можно передать исходный код таблицы и лог Agent, по отдельности проверить предложенные правки и скомпилировать заново. При работе с шаблоном журнала сохраните требуемые им компилятор и настройки пакетов и проверьте, не загружает ли шаблон уже booktabs или siunitx.

Полный пример, фрагмент с единицами и погрешностью, пример округления и сравнительный фрагмент со столбцом c скомпилированы pdfLaTeX на TeXLive.net (LaTeX 2026-11-01, siunitx v3.6.7): ошибок в логе нет, PDF просмотрен. Две ошибки из таблицы воспроизведены в той же среде. В компиляторе продукта и с конкретными шаблонами журналов проверка не проводилась.

Базовый синтаксис таблиц описан в разделе Простые таблицы, объединение ячеек и длинные таблицы, заголовки и плавающие объекты — в разделе Заголовки, метки и плавающие объекты, требования к оформлению статьи целиком — в справке по оформлению статей.

Источники