matplotlib.pyplot

matplotlib.pyplotest une interface basée sur l'état pour matplotlib. Il fournit un moyen de traçage implicite, semblable à MATLAB. Il ouvre également les figures sur votre écran et agit en tant que gestionnaire de l'interface graphique des figures.

pyplot est principalement destiné aux tracés interactifs et aux cas simples de génération de tracés programmatiques :

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
plt.plot(x, y)

L'API explicite orientée objet est recommandée pour les tracés complexes, bien que pyplot soit encore généralement utilisé pour créer la figure et souvent les axes de la figure. Voir pyplot.figure, pyplot.subplots, et pyplot.subplot_mosaicpour créer des figures, et Axes API pour les méthodes de traçage sur un Axes :

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

Voir Matplotlib Application Interfaces (APIs) pour une explication des compromis entre les interfaces implicites et explicites.

Commandes de traçage

acorr	Tracez l'autocorrélation de x .
angle_spectrum	Tracez le spectre d'angle.
annotate	Annotez le point xy avec du texte text .
arrow	Ajoutez une flèche aux Axes.
autoscale	Mise à l'échelle automatique de la vue de l'axe sur les données (bascule).
axes	Ajoutez un Axe à la figure actuelle et faites-en les Axes actuels.
axhline	Ajoutez une ligne horizontale à travers les Axes.
axhspan	Ajoutez une étendue horizontale (rectangle) sur les axes.
axis	Méthode pratique pour obtenir ou définir certaines propriétés d'axe.
axline	Ajouter une ligne droite infiniment longue.
axvline	Ajoutez une ligne verticale à travers les Axes.
axvspan	Ajoutez une étendue verticale (rectangle) sur les axes.
bar	Faites un graphique en barres.
bar_label	Étiquetez un diagramme à barres.
barbs	Tracez un champ 2D de barbes.
barh	Faites un diagramme à barres horizontales.
box	Activez ou désactivez la case des axes sur les axes actuels.
boxplot	Dessinez un tracé en boîte et à moustaches.
broken_barh	Tracez une séquence horizontale de rectangles.
cla	Effacer les axes actuels.
clabel	Étiquetez un tracé de contour.
clf	Efface la figure actuelle.
clim	Définissez les limites de couleur de l'image actuelle.
close	Ferme une fenêtre de figure.
cohere	Tracez la cohérence entre x et y .
colorbar	Ajouter une barre de couleurs à un tracé.
contour	Tracer les courbes de niveau.
contourf	Tracer les contours remplis.
csd	Tracez la densité spectrale croisée.
delaxes	Supprimez un Axes(par défaut les axes actuels) de sa figure.
draw	Redessine la figure actuelle.
draw_if_interactive	Redessine la figure actuelle si en mode interactif.
errorbar	Tracez y par rapport à x sous forme de lignes et/ou de marqueurs avec des barres d'erreur attachées.
eventplot	Tracez des lignes parallèles identiques aux positions données.
figimage	Ajoutez une image non rééchantillonnée à la figure.
figlegend	Placer une légende sur la figure.
fignum_exists	Renvoie si le chiffre avec l'identifiant donné existe.
figtext	Ajouter du texte à la figure.
figure	Créez une nouvelle figure ou activez une figure existante.
fill	Tracez des polygones remplis.
fill_between	Remplissez la zone entre deux courbes horizontales.
fill_betweenx	Remplissez la zone entre deux courbes verticales.
findobj	Trouvez des objets d'artiste.
gca	Obtenez les Axes actuels.
gcf	Obtenez le chiffre actuel.
gci	Obtenez l'artiste coloriable actuel.
get	Renvoie la valeur de la propriété d'un Artistou imprime -les toutes.
get_cmap	Obtenez une instance de palette de couleurs, par défaut les valeurs rc si le nom est None.
get_figlabels	Renvoie une liste d'étiquettes de figure existantes.
get_fignums	Renvoie une liste des numéros de figure existants.
getp	Renvoie la valeur de la propriété d'un Artistou imprime -les toutes.
grid	Configurez les lignes de la grille.
hexbin	Créez un diagramme de regroupement hexagonal 2D des points x , y .
hist	Calculer et tracer un histogramme.
hist2d	Créez un histogramme 2D.
hlines	Tracez des lignes horizontales à chaque y de xmin à xmax .
imread	Lit une image d'un fichier dans un tableau.
imsave	Enregistrez un tableau en tant que fichier image.
imshow	Affichez les données sous forme d'image, c'est-à-dire sur un raster régulier 2D.
install_repl_displayhook	Connectez-vous au crochet d'affichage du shell actuel.
ioff	Désactiver le mode interactif.
ion	Activer le mode interactif.
isinteractive	Renvoie si les tracés sont mis à jour après chaque commande de traçage.
legend	Placez une légende sur les Axes.
locator_params	Contrôlez le comportement des principaux localisateurs de tiques.
loglog	Créez un tracé avec une mise à l'échelle logarithmique sur les axes x et y.
magnitude_spectrum	Tracez le spectre de magnitude.
margins	Définissez ou récupérez les marges de mise à l'échelle automatique.
matshow	Afficher un tableau sous forme de matrice dans une nouvelle fenêtre de figure.
minorticks_off	Supprimez les tiques mineures des axes.
minorticks_on	Afficher les graduations mineures sur les axes.
pause	Exécutez la boucle d'événements de l'interface graphique pendant des secondes d' intervalle .
pcolor	Créez un tracé en pseudo-couleur avec une grille rectangulaire non régulière.
pcolormesh	Créez un tracé en pseudo-couleur avec une grille rectangulaire non régulière.
phase_spectrum	Tracez le spectre de phase.
pie	Tracez un graphique circulaire.
plot	Tracez y par rapport à x sous forme de lignes et/ou de marqueurs.
plot_date	[ Déconseillé ] Tracé contraignant l'axe à traiter les flottants comme des dates.
polar	Faire un tracé polaire.
psd	Tracez la densité spectrale de puissance.
quiver	Tracez un champ de flèches 2D.
quiverkey	Ajouter une clé à un tracé de carquois.
rc	Réglez le courant rcParams. groupe est le groupement pour le rc, par exemple, pour lines.linewidthle groupe est lines, pour axes.facecolor, le groupe est axes, et ainsi de suite. Group peut également être une liste ou un tuple de noms de groupe, par exemple ( xtick , ytick ). kwargs est une paire nom/valeur d'attribut de dictionnaire, par exemple, ::.
rc_context	Renvoie un gestionnaire de contexte pour modifier temporairement rcParams.
rcdefaults	Restaurez le rcParamsstyle interne par défaut de Matplotlib.
rgrids	Obtenir ou définir le quadrillage radial sur le tracé polaire actuel.
savefig	Enregistrez la figure actuelle.
sca	Définissez les axes actuels sur ax et la figure actuelle sur le parent de ax .
scatter	Un nuage de points de y vs.
sci	Définissez l'image actuelle.
semilogx	Faites un tracé avec une mise à l'échelle logarithmique sur l'axe des x.
semilogy	Faites un tracé avec une mise à l'échelle logarithmique sur l'axe y.
set_cmap	Définissez la palette de couleurs par défaut et appliquez-la à l'image actuelle, le cas échéant.
set_loglevel	Définissez le niveau de l'enregistreur racine et du gestionnaire de l'enregistreur racine de Matplotlib, en créant le gestionnaire s'il n'existe pas encore.
setp	Définissez une ou plusieurs propriétés sur un Artistou répertoriez les valeurs autorisées.
show	Afficher tous les chiffres ouverts.
specgram	Tracez un spectrogramme.
spy	Tracez le modèle de parcimonie d'un tableau 2D.
stackplot	Dessinez un graphique en aires empilées.
stairs	Une fonction constante pas à pas comme une ligne avec des bords de délimitation ou un tracé rempli.
stem	Créez un graphique à tiges.
step	Faites un pas à pas.
streamplot	Dessinez les lignes de courant d'un flux vectoriel.
subplot	Ajoutez un Axe à la figure actuelle ou récupérez un Axe existant.
subplot2grid	Créez une sous-parcelle à un emplacement spécifique à l'intérieur d'une grille régulière.
subplot_mosaic	Créez une disposition d'axes basée sur l'art ASCII ou des listes imbriquées.
subplot_tool	Lancez une fenêtre d'outil de sous-parcelle pour une figure.
subplots	Créez une figure et un ensemble de sous-parcelles.
subplots_adjust	Ajustez les paramètres de mise en page de la sous-parcelle.
suptitle	Ajoutez un sous-titre centré à la figure.
switch_backend	Fermez toutes les figures ouvertes et définissez le backend Matplotlib.
table	Ajouter un tableau à un Axes.
text	Ajoutez du texte aux Axes.
thetagrids	Obtenir ou définir les lignes de grille thêta sur le tracé polaire actuel.
tick_params	Modifiez l'apparence des graduations, des étiquettes de graduation et du quadrillage.
ticklabel_format	Configurez le ScalarFormatterutilisé par défaut pour les axes linéaires.
tight_layout	Ajustez le rembourrage entre et autour des sous-parcelles.
title	Définissez un titre pour les Axes.
tricontour	Tracez des courbes de niveau sur une grille triangulaire non structurée.
tricontourf	Dessinez des régions de contour sur une grille triangulaire non structurée.
tripcolor	Créez un tracé en pseudo-couleur d'une grille triangulaire non structurée.
triplot	Dessinez une grille triangulaire non structurée sous forme de lignes et/ou de marqueurs.
twinx	Créez et renvoyez un deuxième axe qui partage l' axe des x .
twiny	Créez et renvoyez un deuxième axe qui partage l' axe y .
uninstall_repl_displayhook	Déconnectez-vous du crochet d'affichage du shell actuel.
violinplot	Faites une intrigue de violon.
vlines	Tracez des lignes verticales à chaque x de ymin à ymax .
xcorr	Tracez la corrélation croisée entre x et y .
xkcd	Activez le mode de dessin de style croquis xkcd .
xlabel	Définissez l'étiquette de l'axe des x.
xlim	Obtenir ou définir les limites x des axes actuels.
xscale	Définissez l'échelle de l'axe des abscisses.
xticks	Obtenez ou définissez les emplacements et les étiquettes des graduations actuelles de l'axe des x.
ylabel	Définissez l'étiquette de l'axe y.
ylim	Obtenir ou définir les limites y des axes actuels.
yscale	Définissez l'échelle de l'axe y.
yticks	Obtenez ou définissez les emplacements et les étiquettes des graduations actuelles de l'axe des ordonnées.

Autres commandes

connect	Lie la fonction func à l'événement s .
disconnect	Déconnectez le rappel avec l'id cid .
get_current_fig_manager	Renvoie le gestionnaire de figures de la figure actuelle.
ginput	Appel bloquant pour interagir avec une figurine.
new_figure_manager	Créez une nouvelle instance de gestionnaire de figurines.
waitforbuttonpress	Appel bloquant pour interagir avec la figure.

Palettes de couleurs

Les palettes de couleurs sont disponibles via le registre des palettes de couleurs matplotlib.colormaps. Pour plus de commodité, ce registre est disponible en pyplottant que

matplotlib.pyplot. palettes de couleurs

Conteneur pour les palettes de couleurs connues de Matplotlib par leur nom.

Expérimental

Bien que nous nous attendions à ce que l'API soit définitive, nous la marquons formellement comme expérimentale pour la version 3.5, car nous souhaitons conserver la possibilité d'adapter l'API pour la version 3.6 en cas de besoin.

L'instance de registre universel est matplotlib.colormaps. Les utilisateurs ne devraient pas avoir besoin de s'instancier ColormapRegistryeux-mêmes.

L'accès en lecture utilise une interface de type dict mappant les noms à Colormaps :

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

Les s retournés Colormapsont des copies, de sorte que leur modification ne change pas la définition globale de la palette de couleurs.

Des palettes de couleurs supplémentaires peuvent être ajoutées via ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

De plus, il existe des fonctions de raccourci pour définir des palettes de couleurs intégrées ; par exemple plt.viridis()est équivalent à plt.set_cmap('viridis').

matplotlib.pyplot. color_sequences

Conteneur pour les séquences de couleurs connues de Matplotlib par leur nom.

L'instance de registre universel est matplotlib.color_sequences. Les utilisateurs ne devraient pas avoir besoin de s'instancier ColorSequenceRegistry eux-mêmes.

L'accès en lecture utilise une interface de type dict mappant les noms à des listes de couleurs :

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

Les listes retournées sont des copies, de sorte que leur modification ne change pas la définition globale de la séquence de couleurs.

Des séquences de couleurs supplémentaires peuvent être ajoutées via ColorSequenceRegistry.register:

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])