Fonction plot() de Matplotlib
Documentation de référence de Matplotlib
plot()C'est la fonction la plus centrale de Matplotlib, utilisée pour dessiner des graphiques en courbes.
Elle crée des lignes en reliant les points de coordonnées x et y donnés, et prend en charge la personnalisation de la couleur, du style de ligne, du marqueur et de l'épaisseur de ligne.
Définition de fonction
Interface pyplot
matplotlib.pyplot.plot(*args, scalex=True, scaley=True, data=None, **kwargs)
Interface Axes
Axes.plot(*args, scalex=True, scaley=True, data=None, **kwargs)
Description du paramètre
| Paramètre | Type | Description |
|---|---|---|
| *args | Arguments variables | Prend en charge plusieurs conventions d'appel : plot(y), plot(x, y), plot(x, y, 'fmt'), plot(x1, y1, 'fmt1', x2, y2, 'fmt2', ...) |
| scalex / scaley | bool | Indique s'il faut automatiquement mettre à l'échelle les axes x/y pour adapter les données, la valeur par défaut est True |
| data | Objet indexable | Si fourni, des chaînes de caractères peuvent être utilisées comme arguments pour référencer des colonnes de données dans celui-ci. |
| color ou c | color | Couleur de ligne, par ex. 'red', '#ff0000', 'tab:blue' |
| linestyle ou ls | str | Style de ligne : '-' (continu), '--' (tirets), '-.' (tiret-point), ':' (pointillé), '' (aucune ligne) |
| linewidth ou lw | float | Largeur de ligne, valeur par défaut environ 1.5 |
| marker | str | Marqueurs de points de données : '.', 'o', 's', '^', '*', '+' (signe plus), 'x', etc. |
| markersize ou ms | float | Taille du marqueur |
| label | str | Étiquette de légende, utilisée avec legend() |
| alpha | float | Transparence, de 0 (entièrement transparent) à 1 (entièrement opaque) |
| zorder | float | Ordre des couches, plus la valeur est grande, plus il est dessiné au-dessus |
La chaîne de format fmt se compose de trois parties :
'[Color][Marker][Line Style]'tel que'ro--'indique rouge, marqueur cercle, ligne en pointillés. L'ordre des parties est arbitraire.
Abréviations de couleurs courantes
| Caractère | Couleur | Caractère | Couleur |
|---|---|---|---|
| 'b' | Bleu | 'r' | قرمز |
| 'g' | Vert | 'c' | Cyan |
| 'm' | Magenta | 'y' | Jaune |
| 'k' | مشکی | 'w' | Blanc |
Exemples d'utilisation
Exemple 1 : le graphique en courbes le plus simple
Si seules les valeurs y sont transmises, x utilise automatiquement des indices commençant à 0.
Exemple
import numpy as np
# Générer 50 points de données entre 0 et 10
x = np.linspace(0, 10, 50)
y = np.sin(x) # Fonction sinus
# Appel le plus simple : x, y
plt.plot(x, y)
plt.title('Simple Line Plot')
plt.xlabel('x')
plt.ylabel('sin(x)')
plt.grid(True, alpha=0.3)
plt.show()
Exemple 2 : plusieurs courbes + chaîne de format
Tracez plusieurs courbes sur le même graphique, en utilisant différentes couleurs, styles de ligne et marqueurs.
Exemple
import numpy as np
x = np.linspace(0, 10, 50)
y1 = np.sin(x)
y2 = np.cos(x)
y3 = np.sin(x) * np.exp(-x / 3) # Sinusoïde amortie
# Plusieurs courbes, chacune avec un format différent
plt.plot(x, y1, 'b-o', label='sin(x)') # Ligne bleue pleine + marqueurs circulaires
plt.plot(x, y2, 'r--s', label='cos(x)') # Ligne rouge en tirets + marqueurs carrés
plt.plot(x, y3, 'g-.^', label='sin(x) amorti') # Ligne verte en tirets-points + marqueurs triangles
plt.title('Plusieurs lignes avec différents styles')
plt.xlabel('x')
plt.ylabel('y')
plt.legend()
plt.grid(True, alpha=0.3)
plt.show()
Exemple 3 : Personnalisation du style avec des arguments nommés
Utilisez des arguments nommés pour un contrôle plus fin de l'apparence de la ligne.
Exemple
import numpy as np
x = np.linspace(0, 2 * np.pi, 100)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Utilisez des arguments nommés au lieu d'une chaîne de format, plus lisible
ax.plot(x, np.sin(x),
color='steelblue', # Nom de la couleur
linestyle='-', # Ligne continue
linewidth=2.5, # Largeur de ligne
marker='o', # Marqueur cercle
markersize=4, # Taille du marqueur
markerfacecolor='red', # Couleur de remplissage du marqueur
markeredgecolor='black', # Couleur du contour du marqueur
markeredgewidth=0.5, # Largeur du contour du marqueur
alpha=0.8, # Transparence globale
label='sin(x)')
# Comparaison : ligne en tirets sans marqueurs
ax.plot(x, np.cos(x),
color='#ff6600', # Couleur hexadécimale
linestyle='--',
linewidth=2,
label='cos(x)')
ax.set_title('Styles de ligne personnalisés', fontsize=14)
ax.set_xlabel('x (radians)')
ax.set_ylabel('Amplitude')
ax.legend(loc='upper right')
ax.grid(True, alpha=0.2)
plt.show()
print("exemple : tracé personnalisé affiché")
Exemple 4 : utilisation du paramètre data (prise en charge de DataFrame)
Lorsque les données sont un dict ou un DataFrame pandas, des noms de colonnes sous forme de chaîne peuvent être utilisés.
Exemple
import numpy as np
# Organiser les données sous forme de dictionnaire
data = {
'time': np.arange(0, 10, 0.5),
'voltage': np.sin(np.arange(0, 10, 0.5)) * 5 + 10,
'current': np.cos(np.arange(0, 10, 0.5)) * 2 + 5,
}
fig, ax = plt.subplots(layout='constrained')
# Référencer les données via le paramètre data + les noms de colonnes sous forme de chaînes
ax.plot('time', 'voltage', 'b-', data=data, label='Tension (V)')
ax.plot('time', 'current', 'r--', data=data, label='Courant (A)')
ax.set_title('Utilisation du paramètre data avec des noms de colonnes')
ax.set_xlabel('Temps (s)')
ax.set_ylabel('Valeur')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Exemple 5 : Appel sur un objet Axes (approche recommandée)
L'utilisation de l'interface Axes orientée objet est plus claire dans les scénarios à plusieurs sous-graphiques.
Exemple
import numpy as np
x = np.linspace(0, 10, 100)
# Créer deux sous-graphiques côte à côte
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
layout='constrained')
# Sous-graphique de gauche : fonction mathématique
ax1.plot(x, np.sin(x), label='sin(x)')
ax1.plot(x, np.cos(x), label='cos(x)')
ax1.set_title('Fonctions mathématiques')
ax1.legend()
ax1.grid(True, alpha=0.3)
# Sous-graphique droit : tendance des données
data = np.random.randn(100).cumsum() # Marche aléatoire
ax2.plot(data, color='teal', linewidth=1.5)
ax2.set_title('Marche aléatoire (somme cumulée)')
ax2.set_xlabel('Étape')
ax2.set_ylabel('Position')
ax2.grid(True, alpha=0.3)
plt.show()
FAQ
Ordre de x et y dans plot()
L'appel standard estplot(x, y), x vient en premier, y vient ensuite.
Si un seul tableau est passé, par ex.plot(y), alors x est automatiquement considéré commerange(0, len(y))。
Comment tracer des segments de ligne discontinus ?
Pour les données contenant NaN, plot() coupe automatiquement la ligne à NaN, ce qui peut être utilisé pour tracer des lignes segmentées.
La chaîne fmt et les arguments nommés peuvent-ils être utilisés ensemble ?
Oui, les arguments nommés remplacent les paramètres correspondants dans la chaîne fmt. Par exempleplot(x, y, 'ro', color='blue')Ici, marker='o' provient de fmt, mais color sera remplacé par bleu.
Autres extensions