Comment faire un tableau de résultats en LaTeX ? Trois filets, alignement décimal et en-têtes groupés

BlogEasyLaTeXPublié le

Dans un article, un tableau de résultats expérimentaux se construit généralement en combinant trois outils : booktabs pour le tableau à trois filets, la colonne S de siunitx pour aligner les nombres sur le séparateur décimal, et \multicolumn avec \cmidrule pour les en-têtes groupés du type « Dataset A / Dataset B ». En partant d'un jeu de données d'exemple, cet article donne le code source complet et compilable, puis détaille la mise en gras de la meilleure valeur, les valeurs manquantes, les unités, les notes de tableau et la vérification des chiffres.

Données d'exemple

Les chiffres ci-dessous servent uniquement à la démonstration et ne proviennent d'aucune expérience réelle. On suppose que quatre méthodes ont été exécutées trois fois sur chacun de deux jeux de données, et que les moyennes ont été rassemblées dans un 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 ne publie pas de résultats sur le jeu B, d'où les deux derniers champs vides. La colonne des paramètres contient à la fois 11.2 et l'entier 340, ce qui permet justement de montrer l'alignement décimal.

Code source complet

Enregistrez-le sous main.tex et compilez-le avec pdfLaTeX. L'exemple utilise la classe article et charge booktabs, siunitx et 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}

Après compilation, le PDF contient un tableau à trois filets avec titre : en haut, Dataset A et Dataset B s'étendent chacun sur deux colonnes, avec un filet court sous chaque groupe ; dans la colonne des paramètres, 340 est aligné sur la partie entière de 11.2 et 12.8 ; les quatre indicateurs de la dernière ligne sont en gras, et une note en petits caractères figure sous le tableau.

Schéma du processus : les chiffres du CSV, du code LaTeX et du rendu se correspondent un à un. Pour la lisibilité, la figure ne conserve que deux lignes et trois colonnes.

Tableau à trois filets : les filets de booktabs

booktabs fournit quatre commandes :

CommandePositionRôle
\topruleAvant la première ligneFilet supérieur, plus épais
\midruleEntre l'en-tête et les donnéesFilet intermédiaire, plus fin
\bottomruleAprès la dernière ligneFilet inférieur, plus épais
\cmidrule(lr){a-b}Sous un en-tête groupéFilet court couvrant seulement les colonnes a à b

Ces filets ont leur propre espacement au-dessus et au-dessous, ce qui évite un tableau tassé. Avec booktabs, on ne trace en général pas de filets verticaux, et on évite de le mélanger avec \hline, sous peine d'épaisseurs incohérentes. Si le modèle de la revue impose autre chose, c'est le modèle qui fait foi.

Le package caption et \captionsetup[table]{position=above} de l'exemple gèrent l'espacement du titre. Par convention, le titre d'un tableau se place au-dessus, mais article calcule par défaut l'espacement pour un titre placé en dessous ; sans ces deux lignes, le titre touche le filet supérieur. \label doit venir après \caption pour que le numéro de renvoi soit correct.

Alignement décimal : la colonne S de siunitx

Une colonne c ordinaire centre chaque cellule. Quand les nombres n'ont pas le même nombre de chiffres, les séparateurs décimaux se décalent :

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

Ici, 340 est centré et ne s'aligne pas sur le point décimal de 11.2. En passant au type de colonne S, siunitx découpe chaque nombre en partie entière et partie décimale, puis les aligne sur le point décimal :

Schéma de l'alignement : à gauche une colonne c, à droite S[table-format=3.1]. 340 n'a pas de partie décimale ; son chiffre des unités est aligné sur celui des autres nombres.

table-format indique à siunitx combien de chiffres réserver :

  • 3.1 : jusqu'à 3 chiffres pour la partie entière et 1 décimale, pour des valeurs de 11.2 à 340.
  • 2.1 : 2 chiffres entiers et 1 décimale, pour des pourcentages comme 84.3.
  • Avec un signe, on écrit +2.1 ou équivalent ; avec une incertitude, 2.1(1) (voir plus bas).

table-format n'agit que sur la largeur et l'alignement de la colonne ; il ne modifie pas les nombres. S'il est trop petit, les nombres débordent de la largeur réservée et ne sont plus alignés avec l'en-tête ; il suffit alors de l'ajuster sur le nombre le plus long.

Tout contenu non numérique d'une colonne S doit être placé entre accolades. C'est le cas de l'en-tête {Acc (\%)} et de la valeur manquante {--}. Sans accolades, siunitx tente de les lire comme des nombres, signale l'erreur Invalid number et la compilation s'arrête.

En-têtes groupés : \multicolumn et \cmidrule

Un en-tête groupé demande deux lignes :

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 (\%)} \\
  • Les deux & en début de première ligne laissent libres les colonnes Method et Params. \multicolumn{2}{c}{Dataset A} fusionne les colonnes 3 et 4, Dataset B les colonnes 5 et 6. Le nombre de colonnes fusionnées plus les cellules vides doit être égal au nombre total de colonnes du tableau, ici 6.
  • \cmidrule(lr){3-4} trace un filet court sous les colonnes 3 à 4. (lr) raccourcit légèrement les deux extrémités, ce qui laisse un espace entre les deux filets : le lecteur voit qu'ils appartiennent à des groupes différents.
  • \multicolumn est une commande native de LaTeX ; \cmidrule vient de booktabs. Utilisée sur des colonnes S, une cellule \multicolumn suit l'alignement c indiqué et n'est pas analysée comme un nombre ; Dataset A n'a donc pas besoin d'accolades.

Si un en-tête doit s'étendre sur deux lignes, par exemple pour centrer verticalement Method à gauche, on peut utiliser \multirow du package multirow. Dans un tableau à trois filets, il est plus courant de placer ce titre sur la deuxième ligne et de laisser la première vide, comme dans l'exemple.

Meilleures valeurs, valeurs manquantes, unités et notes

Mettre en gras la meilleure valeur

Pour mettre en gras dans une colonne S, l'exemple utilise \bfseries 88.2 et ajoute dans le préambule :

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

Par défaut, siunitx réinitialise la graisse de la police ; ces deux options permettent à \bfseries de s'appliquer dans la cellule tout en conservant l'alignement décimal. L'option detect-weight, fréquente dans les anciens tutoriels, est signalée comme obsolète dans siunitx v3.6.7, la version testée ici, et le log recommande de la remplacer par les deux options ci-dessus.

Avant de mettre en gras, vérifiez le maximum de chaque colonne. Dans cet exemple, Ours est le meilleur sur les quatre indicateurs : 88.2 et 86.4 sur le jeu A, 80.3 et 79.6 sur le jeu B. Pour le nombre de paramètres, plus petit est meilleur : ce n'est pas une colonne où « le plus élevé est le meilleur », et l'exemple ne la met pas en gras. L'en-tête ou le titre doit expliquer la règle de mise en gras, et signaler aussi les indicateurs pour lesquels une valeur plus basse est meilleure, par exemple avec Loss ($\downarrow$) dans l'en-tête.

Valeurs manquantes

L'exemple utilise {--} pour les résultats non publiés, rendu dans le PDF par un tiret court, et en explique le sens dans la note du tableau. {n/a} convient aussi, à condition de rester cohérent dans tout le document. N'écrivez pas 0 à la place d'une valeur manquante : le lecteur croirait que le résultat vaut 0.

Unités

Les unités figurent dans l'en-tête et les cellules ne contiennent que des nombres, par exemple {Acc (\%)} ou {Params (M)}. Pour des unités normalisées, on peut utiliser \unit de 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}

Avec \sisetup{uncertainty-mode = separate} ajouté au préambule, 84.3(4) s'affiche 84.3 ± 0.4 et 88.2(3) s'affiche 88.2 ± 0.3. Le chiffre entre parenthèses est l'incertitude sur le dernier chiffre, et table-format=2.1(1) lui réserve une position. Si l'article donne des écarts-types ou des erreurs standard, la note doit préciser lequel des deux et sur combien d'exécutions il est calculé.

Notes de tableau

L'exemple ajoute après tabular une ligne d'explication en \footnotesize, qui indique le nombre d'exécutions moyennées et le sens de --. S'il y a beaucoup de notes avec des appels du type a, b, on peut envisager le package threeparttable. Les modèles de revue imposent souvent un format pour les notes ; consultez les instructions aux auteurs avant soumission.

Vérifier les chiffres : aucune valeur ne doit changer entre les données et le tableau

Le problème le plus courant dans un tableau de résultats, ce sont les chiffres mal recopiés. Après chaque modification, vérifiez :

  1. L'arrondi se fait au niveau des données. Le tableau reprend exactement le nombre de chiffres du CSV. siunitx sait aussi arrondir, par exemple \num[round-mode=places, round-precision=1]{88.15} donne 88.2 et 86.449 donne 86.4, mais les chiffres du code source ne correspondent alors plus à ceux du PDF, et une erreur peut passer inaperçue à la relecture.
  2. Comparer ligne par ligne. Le CSV d'exemple contient 4 lignes de données, le tableau doit donc en avoir 4 ; chaque ligne compte 5 champs numériques, qui correspondent aux 5 colonnes S. Les champs vides correspondent à {--}.
  3. Revérifier les meilleures valeurs. Après l'ajout ou la suppression d'une ligne, ou une modification des données, le gras peut ne plus être au bon endroit.
  4. Vérifier unités et pourcentages. 0.843 et 84.3% ne doivent pas cohabiter dans la même colonne.

Avec beaucoup de données, on peut générer les lignes du tableau à partir du CSV avec un script, puis coller le résultat dans LaTeX, pour limiter la recopie manuelle. Quelle que soit la méthode, il faut finir par une relecture du PDF face aux données.

Problèmes fréquents

SymptômeCauseCorrection
Package siunitx Error: Invalid number '('Texte d'en-tête sans accolades dans une colonne SÉcrire {Acc (\%)}
Invalid number '--'Valeur manquante sans accoladesÉcrire {--}
Undefined control sequence sur \toprule ou \cmidrulebooktabs n'est pas chargéAjouter \usepackage{booktabs} au préambule
Titre collé au filet supérieurTitre placé au-dessus du tableau, mais espacement prévu pour un titre en dessousCharger caption et régler position=above
\bfseries ne met pas en grassiunitx réinitialise la graisse par défautRégler reset-text-series = false et text-series-to-math = true
Nombres décalés par rapport à l'en-têtetable-format ne réserve pas assez de chiffresL'ajuster sur le nombre le plus long de la colonne
Extra alignment tab has been changed to \crUne ligne contient plus de & que de colonnesCompter les séparateurs de chaque ligne ; une cellule fusionnée compte pour le nombre de colonnes qu'elle fusionne

Pour d'autres erreurs de tableaux, voir Problèmes fréquents dans les tableaux LaTeX générés par IA.

Vérifier en local ou dans EasyLaTeX

Avec TeX Live ou MiKTeX en local, lancez deux fois la compilation dans le dossier de main.tex ; la seconde passe résout \ref :

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

Vérifiez ensuite que main.log ne contient ni erreur ni Overfull \hbox, puis ouvrez le PDF et comparez chaque chiffre, le gras et la note avec le CSV.

Dans EasyLaTeX, placez le code dans le fichier principal du projet, vérifiez que le bon fichier principal est sélectionné et choisissez pdfLaTeX pour cet exemple article en anglais. En cas d'erreur de compilation, consultez les messages et l'Original Log dans le panneau Bug ; pour vous aider à localiser le problème, vous pouvez transmettre le code du tableau et le log à l'Agent, relire ses modifications une par une, puis recompiler. Avec un modèle de revue, conservez le compilateur et les réglages de packages qu'il impose, et vérifiez s'il charge déjà booktabs ou siunitx.

L'exemple complet, l'extrait sur les unités et l'incertitude, l'exemple d'arrondi et l'extrait comparatif avec une colonne c ont été compilés avec pdfLaTeX sur TeXLive.net (LaTeX 2026-11-01, siunitx v3.6.7), sans erreur dans le log, et le PDF a été vérifié ; les deux erreurs du tableau des problèmes ont été reproduites dans le même environnement. Aucun test n'a été fait avec le compilateur du produit ni avec un modèle de revue particulier.

Pour la syntaxe de base des tableaux, voir Tableaux de base, cellules fusionnées et tableaux longs ; pour les titres et les flottants, Titres, étiquettes et flottants ; et pour les exigences de mise en forme d'un article complet, l'aide sur la mise en forme des articles.

Références