PanoramaNiveau · Débutant~14 min de lecture

Matplotlib

Tout ce que Python sait dessiner.

Un tableau de chiffres se lit ligne par ligne. Un graphique se comprend d’un coup d’œil. Matplotlib est la bibliothèque Python qui transforme des données en graphiques. Ce guide ne contient aucun code : il fait le tour de ce qu’elle sait dessiner, pour savoir quoi lui demander.

À la fin de ce guide, tu sauras :

  • Situer Matplotlib parmi les outils Python
  • Nommer les éléments d’une figure
  • Associer une forme de données à un type de graphique
  • Repérer les possibilités d’export, d’animation et d’interaction
Tags
  • Python
  • Sans code
Publié
Fenêtre Matplotlib « Figure 1 » réunissant quatre graphiques : deux courbes, des barres, un nuage de points et une carte de chaleur, avec la barre d’outils de zoom et d’enregistrement

1. Qu’est-ce que Matplotlib ?

Matplotlib est une bibliothèque libre et gratuite pour le langage Python. Créée en 2003 par John D. Hunter, elle s’inspirait des graphiques de MATLAB, d’où son nom. Elle est devenue la référence pour tracer des graphiques en Python, en sciences comme en analyse de données.

Elle produit trois sortes de résultats :

  • Créer des images fixes pour un rapport, une présentation ou un site
  • Animer un graphique pour montrer une évolution image par image
  • Ouvrir une fenêtre interactive pour zoomer et explorer les données
L’idée centrale

Matplotlib ne choisit pas le graphique à ta place. Elle fournit des briques : une figure, des axes, des tracés, du texte. Chaque élément se règle, de la couleur d’une ligne à la position d’une légende.

Beaucoup d’outils s’appuient sur elle sans le dire. Quand pandas affiche un graphique ou que seaborn produit une visualisation statistique, c’est Matplotlib qui dessine.

2. L’anatomie d’une figure

Tous les graphiques Matplotlib partagent le même vocabulaire. Le connaître aide à lire la documentation et à décrire ce que l’on veut obtenir.

Schéma d’une figure Matplotlib : la figure contient une zone de tracé avec titre, étiquettes d’axes, graduations, grille, légende et deux courbesVentes 2026806040200janfévmaravrmaijuinMoisVentesBoutiqueEn ligne12345678
  1. Figure : la toile entière, qui peut contenir plusieurs graphiques
  2. Axes : la zone de tracé d’un graphique, avec son repère
  3. Titre : le message principal du graphique
  4. Étiquettes d’axe : le nom et l’unité de chaque axe
  5. Graduations : les repères chiffrés le long des axes
  6. Grille : les lignes de fond qui facilitent la lecture
  7. Légende : la correspondance entre couleurs et séries
  8. Tracés : les courbes, barres, points ou surfaces eux-mêmes

Attention au mot « axes » : en français, un axe désigne une ligne graduée. Dans Matplotlib, Axes désigne tout le graphique situé dans la figure. Une figure peut donc contenir plusieurs Axes, chacun avec ses deux axes.

3. Données par paires

Dans la documentation : Pairwise data

Des couples (x, y) : une mesure pour chaque instant, chaque catégorie ou chaque valeur d’une fonction. C’est la famille la plus utilisée.

Lire les étiquettes

Sous chaque graphique, la signature reprend celle de la documentation officielle : le nom de la fonction, puis les données attendues. En minuscules, x et y sont des séries de valeurs. En majuscules, X, Y et Z sont des grilles, c’est-à-dire des tableaux à deux dimensions.

Variantes : les barres se tracent aussi à l’horizontale, groupées ou empilées. Une courbe peut n’afficher que ses points, changer de trait ou passer en échelle logarithmique.

4. Distributions statistiques

Dans la documentation : Statistical distributions

Une ou plusieurs séries de valeurs dont on veut voir la répartition. Plusieurs de ces fonctions calculent elles-mêmes la distribution : elles comptent, trient et résument à ta place.

Camembert, avec prudence : l’œil compare mal les angles. Au-delà de quatre ou cinq parts, ou quand elles sont proches, des barres sont plus lisibles.

5. Données sur grille

Dans la documentation : Gridded data

Un tableau de valeurs rangées en lignes et en colonnes : une image, une carte de températures, un champ de vent mesuré sur une grille régulière. Pour les champs, U et V donnent la composante horizontale et verticale en chaque point.

6. Données sur grille irrégulière

Dans la documentation : Irregularly gridded data

Des mesures prises à des endroits dispersés, comme des stations météo. Matplotlib relie ces points en triangles, puis trace sur ce maillage.

7. Données 3D et volumétriques

Dans la documentation : 3D and volumetric data

Des points dans l’espace, des surfaces ou des volumes. Ces graphiques passent par mplot3d, une boîte à outils livrée avec Matplotlib. Dans la fenêtre interactive, la vue pivote à la souris.

Et aussi

Au-delà de ces cinq familles, la galerie montre d’autres formes : graphiques polaires et radars, diagrammes de Gantt, diagrammes de Sankey pour les flux, tableaux sous un graphique et photos annotées.

8. Composer et personnaliser

Un bon graphique ne s’arrête pas au choix du type. Matplotlib permet de régler la composition, la lecture et l’apparence de chaque figure.

Plusieurs graphiques par figure

Ranger des graphiques en grille, composer une mise en page libre, insérer un encart ou partager un axe entre graphiques.

Échelles et axes

Passer en échelle logarithmique, afficher des dates, ajouter un second axe vertical pour une autre unité.

Couleurs et palettes

Choisir parmi des dizaines de palettes, dont viridis, lisible en noir et blanc et par les personnes daltoniennes, avec sa barre de couleurs.

Texte et annotations

Pointer un détail avec une flèche, afficher la valeur au bout des barres, écrire des formules mathématiques.

Styles prêts à l’emploi

Changer tout l’aspect d’un coup avec une feuille de style : fond sombre, style épuré, rendu proche d’autres outils.

Charte graphique

Fixer une fois les polices, couleurs et tailles par défaut pour que tous les graphiques d’un projet se ressemblent.

9. Exporter, animer, interagir

Une fois dessiné, un graphique peut partir dans un document, devenir une animation ou rester ouvert pour l’exploration.

BesoinPossibilitéBon à savoir
Image pour le webPNG, JPEG, WebPLa résolution se règle en points par pouce (dpi)
Impression, mise en pageSVG, PDF, EPSFormats vectoriels : nets à toutes les tailles
Document LaTeXPGFLe graphique reprend les polices du document
AnimationGIF, MP4Le MP4 demande l’outil gratuit FFmpeg
ExplorationFenêtre interactiveZoomer, se déplacer, lire les coordonnées, enregistrer
Petite interfaceCurseurs, boutons, casesModifier un paramètre et voir le graphique changer
NotebookJupyterLe graphique s’affiche sous la cellule, interactif avec une extension

10. L’écosystème autour de Matplotlib

Matplotlib sert de socle à d’autres bibliothèques, plus spécialisées ou plus rapides à utiliser.

  • pandas : tracer un tableau de données directement depuis ses colonnes
  • seaborn : obtenir des graphiques statistiques soignés avec moins de réglages
  • Cartopy : dessiner des cartes géographiques et leurs projections
  • mplfinance : tracer des chandeliers boursiers et des volumes

Ses limites : Matplotlib excelle pour les images de qualité publication. Pour un graphique interactif intégré à une page web, avec survol et filtres, des outils comme Plotly, Bokeh ou Altair sont souvent plus adaptés.

11. Mise en pratique : choisir le bon graphique

Avant de tracer, il faut savoir quelle question le graphique doit éclairer. Voici quatre situations :

  • Les ventes mensuelles d’une boutique sur deux ans
  • Le nombre d’inscrits dans chacune des douze formations d’une école
  • Les notes de 300 élèves à un examen
  • La taille et le poids de 500 personnes

Objectif : associer chaque situation à un type de graphique adapté.

  1. Identifier la question posée : évolution, comparaison, distribution ou relation
  2. Retrouver la famille correspondante dans ce guide
  3. Choisir un graphique dans cette famille
  4. Vérifier son choix sur la page Plot types de Matplotlib

Question pour vérifier ta compréhension :

Quel graphique choisir pour chaque situation, et pourquoi un camembert conviendrait-il mal à la deuxième ?

Afficher la réponse

Les ventes mensuelles sont des données par paires, mois et montant : une courbe. Les inscrits par formation aussi : des barres, horizontales et triées pour laisser la place aux noms. Les notes forment une distribution : un histogramme ou une boîte à moustaches. Taille et poids sont deux mesures par personne : un nuage de points, ou un histogramme 2D si les points se superposent. Un camembert à douze parts proches serait illisible, car l’œil compare mal les angles.

12. À retenir

Matplotlib, en bref

  • Transformer des données Python en graphiques fixes, animés ou interactifs
  • Penser en figure, en zones de tracé et en éléments réglables
  • Partir de la question : évolution, comparaison, distribution ou relation
  • Préférer les longueurs aux angles pour comparer
  • Exporter en vectoriel pour l’impression, en PNG pour le web

13. Guides associés

14. Pour aller plus loin

Parcourir tous les types de graphiques, chacun avec son exemple :

Matplotlib : Plot types (en anglais)(nouvel onglet)

Explorer des centaines d’exemples classés par thème :

Matplotlib : galerie d’exemples (en anglais)(nouvel onglet)

Garder sous la main les réglages principaux, sur une page :

Matplotlib : cheatsheets officielles (en anglais)(nouvel onglet)