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ètreTypeDescription
*argsArguments variablesPrend en charge plusieurs conventions d'appel : plot(y), plot(x, y), plot(x, y, 'fmt'), plot(x1, y1, 'fmt1', x2, y2, 'fmt2', ...)
scalex / scaleyboolIndique s'il faut automatiquement mettre à l'échelle les axes x/y pour adapter les données, la valeur par défaut est True
dataObjet indexableSi 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 ccolorCouleur de ligne, par ex. 'red', '#ff0000', 'tab:blue'
linestyle ou lsstrStyle de ligne : '-' (continu), '--' (tirets), '-.' (tiret-point), ':' (pointillé), '' (aucune ligne)
linewidth ou lwfloatLargeur de ligne, valeur par défaut environ 1.5
markerstrMarqueurs de points de données : '.', 'o', 's', '^', '*', '+' (signe plus), 'x', etc.
markersize ou msfloatTaille du marqueur
labelstrÉtiquette de légende, utilisée avec legend()
alphafloatTransparence, de 0 (entièrement transparent) à 1 (entièrement opaque)
zorderfloatOrdre 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èreCouleurCaractèreCouleur
'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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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.


Documentation de référence de Matplotlib

Autres extensions