Les bases de pgfplots : graphiques LaTeX avec exemples
Chargez pgfplots, ouvrez un tikzpicture contenant un axis, et ajoutez chaque série de données avec \addplot, sous forme de liste de coordonnées ou de formule.
Le plus petit graphique
Tout graphique pgfplots comporte les trois mêmes couches : un tikzpicture, un axis à l’intérieur, et un \addplot par série de données. Chargez le package avec \usepackage{pgfplots} dans le préambule.
Quatre points reliés par une ligne
\begin{tikzpicture}
\begin{axis}
\addplot coordinates {(0,1) (1,3) (2,2) (3,4)};
\end{axis}
\end{tikzpicture}L’axe choisit lui-même son intervalle et ses graduations à partir des données. Un \addplot sans option prend sa couleur et son marqueur dans la liste cyclique par défaut : bleu avec des marqueurs ronds pour la première série, rouge avec des carrés pour la deuxième, et ainsi de suite.
Tracer une formule
Au lieu de coordonnées, donnez à \addplot une formule entre accolades. domain fixe l’intervalle de x et samples le nombre de points. Sans ces options, pgfplots utilise l’intervalle de -5 à 5 avec 25 points.
Une fonction avec domain et samples
\begin{tikzpicture}
\begin{axis}
\addplot[blue, thick, domain=-2:2, samples=60] {x^3 - 2*x};
\end{axis}
\end{tikzpicture}Les options entre crochets après \addplot définissent le style de cette série. Si vous donnez des options sans +, la série est tracée en noir (ou dans la couleur indiquée) sans marqueurs ; \addplot+[...] conserve le style de la liste cyclique et y ajoute vos options.
Étiquettes, titre, légende et grille
Ces options se placent sur l’axis : elles s’appliquent donc à tout le graphique.
Étiquettes d’axes, titre, légende et grille
\begin{tikzpicture}
\begin{axis}[
title={Cooling of a cup of tea},
xlabel={Time (min)},
ylabel={Temperature ($^\circ$C)},
grid=major,
legend pos=north east,
]
\addplot coordinates {(0,80) (5,64) (10,53) (15,44) (20,38)};
\addlegendentry{Measured}
\addplot[red, domain=0:20, samples=40] {22 + 58*exp(-0.08*x)};
\addlegendentry{Model}
\end{axis}
\end{tikzpicture}
Les étiquettes sont du texte : les maths se placent donc entre $ ... $ comme dans un paragraphe. \addlegendentry après chaque \addplot nomme cette série ; vous pouvez aussi lister tous les noms à la fin avec \legend{Measured, Model}.
Options d’axe courantes
| Option | Effet | Dans Scissor LaTeX |
|---|---|---|
xlabel, ylabel, title | texte le long des axes et au-dessus du graphique | Fonctionne |
xmin, xmax, ymin, ymax | fixent l’intervalle visible | Fonctionne |
width, height | taille de toute la figure, par exemple width=\linewidth | Fonctionne |
grid=major, grid=both | lignes de grille aux graduations principales (et secondaires) | Fonctionne |
xtick={0,1,2}, xticklabels={a,b,c} | choisissent les graduations et leurs étiquettes | Fonctionne |
legend pos=north west | north west, north east, south west, south east, outer north east | Fonctionne |
axis lines=left | une paire d’axes en L avec des flèches au lieu d’un cadre | Fonctionne (aussi middle, center, none) |
enlargelimits=false | pas d’espace supplémentaire autour des données | Fonctionne |
axis equal | la même échelle sur les deux axes | Pas encore pris en charge : ignorée avec un message dans l’onglet Problèmes |
La plupart des autres options du manuel de pgfplots fonctionnent aussi ; la page courbes liste les styles et les marqueurs. Une option que le moteur de rendu ne connaît pas est ignorée, et l’onglet Problèmes la nomme.
Taille et placement
Par défaut, un graphique mesure environ 240 sur 207 points, la valeur par défaut de pgfplots. Définissez width et height sur l’axe pour la modifier. Pour donner une légende et un numéro à un graphique, placez le tikzpicture dans une figure, comme une image.
Un graphique dans une figure avec légende
\begin{figure}[h]
\centering
\begin{tikzpicture}
\begin{axis}[width=7cm, height=4.5cm, xlabel=$x$, ylabel=$x^2$]
\addplot[domain=0:2, samples=30] {x^2};
\end{axis}
\end{tikzpicture}
\caption{A parabola on $[0, 2]$.}
\label{fig:parabola}
\end{figure}
Figure~\ref{fig:parabola} shows the parabola.
\resizebox{0.5\linewidth}{!}{...} autour d’un seul tikzpicture fonctionne aussi : la figure est mise à l’échelle de cette largeur.
Ce qui diffère d’une installation TeX
Tout ce qui figure sur cette page compile aussi dans une installation TeX avec pgfplots. Le manuel complet se trouve sur CTAN : ctan.org/pkg/pgfplots.
Questions et réponses
Dois-je installer pgfplots ?
Non. Écrivez \usepackage{pgfplots} comme d’habitude. Scissor LaTeX reconnaît le package et dessine lui-même les graphiques, dans le navigateur.
Pourquoi la courbe de ma fonction est-elle anguleuse ?
pgfplots relie 25 points par défaut. Ajoutez samples=100 (ou plus) à l’\addplot ou à l’axe pour une courbe plus lisse, ou ajoutez smooth pour tracer une courbe passant par les points.
Puis-je utiliser pgfplots sans tikzpicture ?
Non : en LaTeX, l’environnement axis se trouve toujours dans un tikzpicture. Scissor LaTeX suit la même règle, si bien que votre code compile aussi ailleurs.
Chaque exemple de cette page est composé par Scissor LaTeX lors de la génération du site. Dernière mise à jour : 2026-11-07.