Numéro de référence de l'API

Lorsque vous utilisez la bibliothèque, vous créez généralement des objets Figure et Axes et appelez leurs méthodes pour ajouter du contenu et modifier l'apparence.

  • matplotlib.figure: création d'axes, contenu au niveau des chiffres

  • matplotlib.axes: la plupart des méthodes de traçage, les libellés des axes, l'accès au style des axes, etc.

Exemple : Nous créons une figure figet des axes ax. Ensuite, nous appelons des méthodes sur eux pour tracer des données, ajouter des étiquettes d'axe et un titre de figure.

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 4, 0.05)
y = np.sin(x*np.pi)

fig, ax = plt.subplots(figsize=(3,2), constrained_layout=True)
ax.plot(x, y)
ax.set_xlabel('t [s]')
ax.set_ylabel('S [V]')
ax.set_title('Sine wave')
fig.set_facecolor('lightsteelblue')

( Code source , png )

../_images/index-11.png

Modèles d'utilisation #

Ci-dessous, nous décrivons plusieurs approches courantes du traçage avec Matplotlib. Voir Matplotlib Application Interfaces (APIs) pour une explication des compromis entre les API utilisateur prises en charge.

L'API explicite #

À la base, Matplotlib est une bibliothèque orientée objet. Nous vous recommandons de travailler directement avec les objets si vous avez besoin de plus de contrôle et de personnalisation de vos tracés.

Dans de nombreux cas, vous créerez un Figureet un ou plusieurs Axesen utilisant pyplot.subplotset à partir de là, vous ne travaillerez que sur ces objets. Cependant, il est également possible de créer Figureexplicitement des s (par exemple lors de leur inclusion dans des applications GUI).

Lecture complémentaire :

L'API implicite #

matplotlib.pyplotest une collection de fonctions qui font fonctionner Matplotlib comme MATLAB. Chaque fonction pyplot apporte des modifications à une figure : par exemple, crée une figure, crée une zone de traçage dans une figure, trace des lignes dans une zone de traçage, décore le tracé avec des étiquettes, etc.

pyplotest principalement destiné aux tracés interactifs et aux cas simples de génération de tracés programmatiques.

Lecture complémentaire :

L'API pylab (déconseillé) #

Avertissement

Étant donné qu'une importation massive dans l'espace de noms global peut entraîner un comportement inattendu, l'utilisation de pylab est fortement déconseillée. Utilisez à la matplotlib.pyplot place.

pylabest un module qui inclut matplotlib.pyplot, numpy, numpy.fft, numpy.linalg, numpy.random, et quelques fonctions supplémentaires, le tout dans un seul espace de noms. Son objectif initial était d'imiter une méthode de travail de type MATLAB en important toutes les fonctions dans l'espace de noms global. Ceci est considéré comme un mauvais style de nos jours.

Modules #

Liste alphabétique des modules :