Ergebnistabellen in LaTeX: booktabs, Dezimalausrichtung und gruppierte Spaltenköpfe

BlogEasyLaTeXVeröffentlicht am

Ergebnistabellen in wissenschaftlichen Arbeiten entstehen meist aus drei Bausteinen: booktabs für die Tabelle mit drei horizontalen Linien, die S-Spalte von siunitx für die Ausrichtung am Dezimalpunkt und \multicolumn zusammen mit \cmidrule für gruppierte Spaltenköpfe wie „Datensatz A / Datensatz B“. Ausgehend von Beispieldaten zeigt dieser Artikel einen vollständigen, kompilierbaren Quelltext und erklärt der Reihe nach fett gesetzte Bestwerte, fehlende Werte, Einheiten, Tabellenanmerkungen und die Kontrolle der Zahlen.

Beispieldaten

Die folgenden Zahlen dienen nur zur Demonstration und stammen aus keinem echten Experiment. Angenommen, vier Methoden wurden auf zwei Datensätzen je dreimal ausgeführt und die Mittelwerte als CSV zusammengestellt:

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

Für Prior work liegen auf Datensatz B keine Ergebnisse vor, daher sind die letzten beiden Felder leer. Die Spalte mit der Parameterzahl enthält sowohl 11.2 als auch die ganze Zahl 340 und eignet sich damit gut, um die Dezimalausrichtung zu zeigen.

Vollständiger Quelltext

Speichern Sie den Code als main.tex und kompilieren Sie ihn mit pdfLaTeX. Das Beispiel verwendet die Dokumentklasse article und lädt booktabs, siunitx und 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}

Nach dem Kompilieren enthält das PDF eine Tabelle mit Titel und drei Linien: Oben stehen Dataset A und Dataset B, die jeweils zwei Spalten überspannen und darunter eine kurze Linie haben. In der Parameterspalte steht 340 mit seinem ganzzahligen Teil bündig zu 11.2 und 12.8. In der letzten Zeile sind die vier Kennzahlen fett gesetzt, unter der Tabelle folgt eine Anmerkung in kleiner Schrift.

Ablaufschema: Die Zahlen in CSV, LaTeX-Quelltext und Satzergebnis entsprechen einander eins zu eins. Zur besseren Lesbarkeit zeigt die Abbildung nur zwei Datenzeilen und drei Spalten.

Drei Linien: die Linien von booktabs

booktabs stellt vier Befehle bereit:

BefehlPositionWirkung
\toprulevor der ersten Tabellenzeiledickere obere Linie
\midrulezwischen Kopf und Datendünnere mittlere Linie
\bottomrulenach der letzten Zeiledickere untere Linie
\cmidrule(lr){a-b}unter einem Gruppenkopfkurze Linie nur über die Spalten a bis b

Diese Linien bringen eigenen Abstand nach oben und unten mit, sodass die Tabelle nicht gedrängt wirkt. Mit booktabs verzichtet man üblicherweise auf senkrechte Linien und mischt die Befehle nicht mit \hline, sonst sind die Linienstärken uneinheitlich. Wenn eine Zeitschriftenvorlage etwas anderes vorgibt, gilt die Vorlage.

Das Paket caption und \captionsetup[table]{position=above} im Beispiel regeln den Abstand des Titels. Tabellentitel stehen üblicherweise über der Tabelle, article setzt den Abstand aber standardmäßig für einen Titel unterhalb. Ohne diese beiden Zeilen klebt der Titel an der oberen Linie. \label muss nach \caption stehen, damit die Verweisnummer stimmt.

Dezimalausrichtung: die S-Spalte von siunitx

Eine normale c-Spalte zentriert jede Zelle. Haben die Zahlen unterschiedlich viele Stellen, stehen die Dezimalpunkte versetzt:

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

In diesem Code wird 340 zentriert und steht nicht auf einer Linie mit dem Dezimalpunkt von 11.2. Ändert man den Spaltentyp auf S, zerlegt siunitx jede Zahl in ganzzahligen Teil und Nachkommateil und richtet sie am Dezimalpunkt aus:

Ausrichtung im Vergleich: links eine c-Spalte, rechts S[table-format=3.1]. 340 hat keinen Nachkommateil, seine Einerstelle steht bündig mit den Einerstellen der anderen Zahlen.

table-format teilt siunitx mit, wie viele Stellen reserviert werden:

  • 3.1: höchstens 3 Stellen vor und 1 Stelle nach dem Komma, für 11.2 bis 340.
  • 2.1: 2 Stellen vor und 1 nach dem Komma, für Prozentwerte wie 84.3.
  • Mit Vorzeichen schreibt man etwa +2.1, mit Unsicherheit 2.1(1), siehe weiter unten.

table-format beeinflusst nur Spaltenbreite und Ausrichtung, die Zahlen selbst bleiben unverändert. Ist der Wert zu klein gewählt, ragen Zahlen über die reservierte Breite hinaus und stehen nicht mehr bündig mit dem Kopf. Passen Sie ihn dann an die längste Zahl an.

Nicht-numerische Inhalte in einer S-Spalte müssen in geschweifte Klammern gesetzt werden. Das gilt für den Kopf {Acc (\%)} ebenso wie für den fehlenden Wert {--}. Fehlen die Klammern, versucht siunitx, den Inhalt als Zahl zu lesen, meldet den Fehler Invalid number und bricht die Kompilierung ab.

Gruppierte Spaltenköpfe: \multicolumn und \cmidrule

Ein gruppierter Kopf braucht zwei Zeilen:

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 (\%)} \\
  • Die beiden & am Anfang der ersten Zeile lassen die Spalten Method und Params frei. \multicolumn{2}{c}{Dataset A} fasst die Spalten 3 und 4 zusammen, Dataset B die Spalten 5 und 6. Die Zahl der zusammengefassten Spalten plus die leeren Zellen muss der Gesamtzahl der Spalten entsprechen, hier 6.
  • \cmidrule(lr){3-4} zieht eine kurze Linie unter den Spalten 3 bis 4. (lr) kürzt die Linie an beiden Enden etwas, sodass zwischen den beiden Gruppenlinien eine Lücke bleibt und erkennbar ist, dass sie zu verschiedenen Gruppen gehören.
  • \multicolumn ist ein eingebauter LaTeX-Befehl, \cmidrule stammt aus booktabs. Wird \multicolumn über S-Spalten verwendet, richtet sich die zusammengefasste Zelle nach dem angegebenen c und wird nicht als Zahl ausgewertet. Dataset A braucht deshalb keine geschweiften Klammern.

Soll ein Kopf zwei Zeilen überspannen, etwa damit Method links vertikal zentriert steht, können Sie \multirow aus dem Paket multirow verwenden. In Tabellen mit drei Linien ist es üblicher, solche Bezeichnungen in die zweite Zeile zu setzen und die erste leer zu lassen, wie im Beispiel.

Bestwerte, fehlende Werte, Einheiten und Anmerkungen

Bestwerte fett setzen

Für Fettdruck in einer S-Spalte verwendet das Beispiel \bfseries 88.2 und setzt in der Präambel:

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

siunitx setzt die Schriftstärke standardmäßig zurück. Mit diesen beiden Optionen wirkt \bfseries in der Zelle, und die Zahlen bleiben trotzdem am Dezimalpunkt ausgerichtet. Die in älteren Anleitungen verbreitete Option detect-weight erzeugt in der hier getesteten siunitx v3.6.7 einen Hinweis, dass sie veraltet ist; das Log empfiehlt stattdessen die beiden oben genannten Optionen.

Prüfen Sie vor dem Fettsetzen das Maximum jeder Spalte. In diesem Beispiel liegt Ours bei allen vier Kennzahlen vorn: auf Datensatz A mit 88.2 und 86.4, auf Datensatz B mit 80.3 und 79.6. Bei der Parameterzahl ist weniger besser, sie gehört nicht zu den Spalten, bei denen der höchste Wert der beste ist, und wird im Beispiel nicht fett gesetzt. Kopf oder Titel sollten die Regel für den Fettdruck nennen. Ist bei einer Kennzahl ein niedrigerer Wert besser, sollte das ebenfalls gekennzeichnet werden, etwa mit Loss ($\downarrow$) im Kopf.

Fehlende Werte

Das Beispiel kennzeichnet nicht berichtete Ergebnisse mit {--}. Im PDF erscheint ein kurzer Strich, die Bedeutung wird in der Anmerkung erklärt. Möglich ist auch {n/a}, solange es im ganzen Dokument einheitlich ist. Tragen Sie fehlende Werte nicht als 0 ein, sonst halten Leser das Ergebnis für 0.

Einheiten

Einheiten gehören in den Kopf, in den Zellen stehen nur Zahlen, zum Beispiel {Acc (\%)} und {Params (M)}. Für SI-Einheiten können Sie \unit aus siunitx nutzen:

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}

Mit \sisetup{uncertainty-mode = separate} in der Präambel erscheint 84.3(4) als 84.3 ± 0.4 und 88.2(3) als 88.2 ± 0.3. Die Zahl in Klammern gibt die Unsicherheit der letzten Stelle an, table-format=2.1(1) reserviert dafür eine Stelle. Wenn Sie Standardabweichung oder Standardfehler angeben, nennen Sie in der Anmerkung, welche Größe gemeint ist und auf wie vielen Läufen sie beruht.

Tabellenanmerkungen

Das Beispiel setzt nach tabular mit \footnotesize eine Zeile Erläuterung: wie viele Läufe gemittelt wurden und was -- bedeutet. Bei mehreren Anmerkungen mit Markierungen wie a, b kommt das Paket threeparttable in Frage. Zeitschriftenvorlagen schreiben das Format von Anmerkungen häufig vor; lesen Sie vor der Einreichung die Autorenrichtlinien.

Zahlen prüfen: zwischen Daten und Tabelle darf sich kein Wert ändern

Der häufigste Fehler in Ergebnistabellen sind falsch übertragene Zahlen. Prüfen Sie nach jeder Änderung:

  1. Runden Sie bereits in den Daten. So viele Stellen wie in der CSV stehen, so viele kommen in die Tabelle. siunitx kann zwar runden, etwa liefert \num[round-mode=places, round-precision=1]{88.15} 88.2 und 86.449 86.4, dann stimmen aber die Zahlen im Quelltext nicht mehr mit denen im PDF überein, was bei der Kontrolle leicht übersehen wird.
  2. Zeile für Zeile vergleichen. Die Beispiel-CSV hat 4 Datenzeilen, also muss auch die Tabelle 4 Zeilen haben; jede Zeile hat 5 numerische Felder, die den 5 S-Spalten entsprechen. Leere Felder entsprechen {--}.
  3. Bestwerte erneut prüfen. Nach dem Hinzufügen oder Entfernen einer Zeile oder nach Datenänderungen kann der Fettdruck an der falschen Stelle stehen.
  4. Einheiten und Prozentzeichen prüfen. 0.843 und 84.3 % dürfen nicht in derselben Spalte gemischt werden.

Bei vielen Daten können Sie die Tabellenzeilen per Skript aus der CSV erzeugen und das Ergebnis in LaTeX einfügen, um manuelles Abschreiben zu vermeiden. Unabhängig vom Weg sollten Sie am Ende alles noch einmal mit dem PDF abgleichen.

Häufige Probleme

SymptomUrsacheLösung
Package siunitx Error: Invalid number '('Kopftext in einer S-Spalte ohne geschweifte Klammern{Acc (\%)} schreiben
Invalid number '--'fehlender Wert ohne geschweifte Klammern{--} schreiben
Undefined control sequence bei \toprule oder \cmidrulebooktabs nicht geladen\usepackage{booktabs} in die Präambel aufnehmen
Titel klebt an der oberen LinieTitel steht über der Tabelle, der Abstand ist aber für unten eingestelltcaption laden und position=above setzen
\bfseries wirkt nichtsiunitx setzt die Schriftstärke standardmäßig zurückreset-text-series = false und text-series-to-math = true setzen
Zahlen stehen versetzt zum Kopftable-format reserviert zu wenige Stellenan die längste Zahl der Spalte anpassen
Extra alignment tab has been changed to \creine Zeile hat mehr & als SpaltenTrennzeichen jeder Zeile zählen, zusammengefasste Zellen mit der Zahl der überspannten Spalten rechnen

Weitere Tabellenfehler behandelt der Artikel Häufige Probleme mit KI-generierten LaTeX-Tabellen.

Lokal oder in EasyLaTeX prüfen

Mit einer lokalen Installation von TeX Live oder MiKTeX führen Sie im Verzeichnis von main.tex zwei Läufe aus; der zweite löst \ref auf:

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

Prüfen Sie danach main.log auf Fehler oder Overfull \hbox, öffnen Sie das PDF und gleichen Sie jede Zahl, die Position des Fettdrucks und die Anmerkung mit der CSV ab.

In EasyLaTeX fügen Sie den Quelltext in die Hauptdatei des Projekts ein, prüfen, ob die richtige Hauptdatei ausgewählt ist, und wählen für dieses englische article-Beispiel pdfLaTeX. Bei Kompilierfehlern sehen Sie im Bug-Panel die Meldungen und das Original Log. Wenn Sie Hilfe bei der Fehlersuche brauchen, können Sie Tabellenquelltext und Log dem Agent übergeben, die vorgeschlagenen Änderungen einzeln prüfen und dann neu kompilieren. Bei einer Zeitschriftenvorlage behalten Sie den vorgegebenen Compiler und die Paketeinstellungen bei und prüfen, ob die Vorlage booktabs oder siunitx bereits lädt.

Das vollständige Beispiel, das Snippet mit Einheiten und Unsicherheit, das Rundungsbeispiel und das Vergleichs-Snippet mit c-Spalte wurden mit pdfLaTeX auf TeXLive.net (LaTeX 2026-11-01, siunitx v3.6.7) kompiliert; das Log war fehlerfrei, und das PDF wurde geprüft. Die beiden Fehlermeldungen aus der Tabelle wurden in derselben Umgebung reproduziert. Im Compiler des Produkts und mit konkreten Zeitschriftenvorlagen wurde nicht getestet.

Grundlagen der Tabellensyntax finden Sie unter Einfache Tabellen, verbundene Zellen und lange Tabellen, Titel und Gleitobjekte unter Titel, Labels und Gleitobjekte, Formatvorgaben für die gesamte Arbeit unter Hilfe zur Formatierung wissenschaftlicher Arbeiten.

Quellen