Ergebnistabellen in LaTeX: booktabs, Dezimalausrichtung und gruppierte Spaltenköpfe
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:
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.6Fü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.
\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:
| Befehl | Position | Wirkung |
|---|---|---|
\toprule | vor der ersten Tabellenzeile | dickere obere Linie |
\midrule | zwischen Kopf und Daten | dünnere mittlere Linie |
\bottomrule | nach der letzten Zeile | dickere untere Linie |
\cmidrule(lr){a-b} | unter einem Gruppenkopf | kurze 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:
\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ür11.2bis340.2.1: 2 Stellen vor und 1 nach dem Komma, für Prozentwerte wie84.3.- Mit Vorzeichen schreibt man etwa
+2.1, mit Unsicherheit2.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:
& & \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.\multicolumnist ein eingebauter LaTeX-Befehl,\cmidrulestammt ausbooktabs. Wird\multicolumnüber S-Spalten verwendet, richtet sich die zusammengefasste Zelle nach dem angegebenencund 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:
\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:
\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:
- Runden Sie bereits in den Daten. So viele Stellen wie in der CSV stehen, so viele kommen in die Tabelle.
siunitxkann zwar runden, etwa liefert\num[round-mode=places, round-precision=1]{88.15}88.2 und86.44986.4, dann stimmen aber die Zahlen im Quelltext nicht mehr mit denen im PDF überein, was bei der Kontrolle leicht übersehen wird. - 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
{--}. - Bestwerte erneut prüfen. Nach dem Hinzufügen oder Entfernen einer Zeile oder nach Datenänderungen kann der Fettdruck an der falschen Stelle stehen.
- 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
| Symptom | Ursache | Lö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 \cmidrule | booktabs nicht geladen | \usepackage{booktabs} in die Präambel aufnehmen |
| Titel klebt an der oberen Linie | Titel steht über der Tabelle, der Abstand ist aber für unten eingestellt | caption laden und position=above setzen |
\bfseries wirkt nicht | siunitx setzt die Schriftstärke standardmäßig zurück | reset-text-series = false und text-series-to-math = true setzen |
| Zahlen stehen versetzt zum Kopf | table-format reserviert zu wenige Stellen | an die längste Zahl der Spalte anpassen |
Extra alignment tab has been changed to \cr | eine Zeile hat mehr & als Spalten | Trennzeichen 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:
pdflatex -interaction=nonstopmode -halt-on-error main.texpdflatex -interaction=nonstopmode -halt-on-error main.texPrü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
- Dokumentation des Pakets booktabs: Verwendung von
\toprule,\midruleund\cmidrulesowie Empfehlungen für Tabellen mit drei Linien. - Dokumentation des Pakets siunitx:
S-Spalte,table-format, Optionen für Unsicherheit und Rundung. - Dokumentation des Pakets caption:
positionund Titelabstand.