Ce qui suit a été construit à partir de la page https://matplotlib.org/tutorials/introductory/usage.html#sphx-glr-tutorials-introductory-usage-py

Documentation

Intro générale : https://matplotlib.org/index.html

User's Guide : https://matplotlib.org/users/index.html

Concepts de base

Un "graphique" est strucutré de la manière suivante :

  • Figure est l'objet de plus haut niveau : "coquille externe" du graphique
  • Axes contient l'objet graphique en lui-même
  • Axis est un axe du graphique (conrtôle des labels, xmin, xmax, etc.)
  • Artist est chaque élément dessiné sur un graphique (ligne, titre, etc)
  • Canvas est la zone de tracé du graphe

Les données à tracer doivent être de type array de numpy. (np.array)

Toute utilisation de matplotlib commence donc toujours par importer les modules matplotlib.pyplot et numpy sous la forme usuelle ci-dessous :

In [1]:
import matplotlib.pyplot as plt
import numpy as np

Le module pyplot crée automatiquement (et de façon transparente) les objets figure et axes nécessaires à la construction d'un graphique. Chaque "élément" qu'on rajoute par la suite (ex : plt.plot() ou plt.title()) s'ajoute à la figureet l'axe actif.

Pour visualiser la figure créée, il faut utiliser la commande plt.show()

L'utilisation de pyplot est plus simple (mais permet de faire des choses moins précises) que l'utilisation de matplotlib de façon orientée objet.

In [2]:
x = np.linspace(0, 2, 100)

plt.plot(x, x, label='linéaire')
plt.plot(x, x**2, label='carré')
plt.plot(x, x**3, label='cube')

plt.xlabel('abscisses')
plt.ylabel('ordonnées')

plt.title("Graphique basique")

plt.legend()

plt.show()

Des compléments (parfois utiles...)

Toolkits : des ajouts. https://matplotlib.org/api/toolkits/index.html

Pour des graphes 3D : https://matplotlib.org/api/toolkits/mplot3d/index.html

Dautres outils complémentaires (cartographie par exple) : https://matplotlib.org/thirdpartypackages/index.html

Anatomie d'une Figure