Таблицы результатов в LaTeX: booktabs, выравнивание по десятичной точке и сгруппированная шапка
Таблицы с результатами экспериментов в статьях обычно собирают из трёх элементов: booktabs для таблицы с тремя горизонтальными линиями, столбец S из siunitx для выравнивания чисел по десятичной точке и \multicolumn вместе с \cmidrule для сгруппированной шапки вида «набор данных A / набор данных B». Ниже на примере данных приведён полный компилируемый исходный код и по порядку разобраны выделение лучших значений, пропущенные значения, единицы измерения, примечания к таблице и сверка чисел.
Пример данных
Числа ниже приведены только для демонстрации и не получены в реальном эксперименте. Предположим, что четыре метода запускались по три раза на двух наборах данных, а средние значения собраны в CSV:
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.
\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 центрирует каждую ячейку. Если у чисел разное количество цифр, десятичные точки оказываются на разных позициях:
\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
Для сгруппированной шапки нужны две строки:
& & \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, а в преамбуле задано:
\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:
\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. Шаблоны журналов обычно задают формат примечаний, поэтому перед подачей сверьтесь с требованиями для авторов.
Сверка чисел: на пути от данных к таблице значения не должны меняться
Самая частая ошибка в таблицах результатов — неверно перенесённые числа. После каждой правки рекомендуется проверять:
- Округление выполняется на этапе данных. Сколько знаков в CSV, столько и в таблице.
siunitxтоже умеет округлять, например\num[round-mode=places, round-precision=1]{88.15}даёт 88.2, а86.449— 86.4, но тогда числа в исходном коде расходятся с числами в PDF, и при проверке это легко пропустить. - Построчная сверка. В примере CSV 4 строки данных, значит, и в таблице должно быть 4 строки; в каждой строке 5 числовых полей, соответствующих 5 столбцам S. Пустым полям соответствует
{--}. - Повторная проверка лучших значений. После добавления или удаления строки или изменения данных выделение может оказаться не там.
- Проверка единиц и знака процента. 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:
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 просмотрен. Две ошибки из таблицы воспроизведены в той же среде. В компиляторе продукта и с конкретными шаблонами журналов проверка не проводилась.
Базовый синтаксис таблиц описан в разделе Простые таблицы, объединение ячеек и длинные таблицы, заголовки и плавающие объекты — в разделе Заголовки, метки и плавающие объекты, требования к оформлению статьи целиком — в справке по оформлению статей.
Источники
- Документация пакета booktabs: использование
\toprule,\midrule,\cmidruleи рекомендации по таблицам с тремя линиями. - Документация пакета siunitx: столбец
S,table-format, опции погрешности и округления. - Документация пакета caption:
positionи отступ заголовка.