Fonctions de traçage avancées de Matplotlib


Matplotlib 参考文档Documentation de référence de Matplotlib

En plus des fonctions de tracé de base telles que plot() et bar(), Matplotlib fournit également une variété de fonctions de tracé spécialisées pour des scénarios comme les diagrammes en escalier, les diagrammes à tiges, les diagrammes en aires empilées et les graphiques polaires.

Aperçu des fonctions

FonctionDescription
step()Tracer un diagramme en escalier (les données changent par paliers constants par morceaux)
stem()Tracer un diagramme à tiges (lignes verticales + marqueurs au sommet)
eventplot()Tracer un diagramme d'événements (plusieurs lignes horizontales marquant la position des événements)
stackplot()Tracer un diagramme en aires empilées
broken_barh()Tracer un diagramme à barres brisées horizontal (style diagramme de Gantt)
vlines() / hlines()Tracer plusieurs lignes de référence verticales/horizontales
fill()Tracer des polygones remplis
polar()Tracer dans un système de coordonnées polaires
loglog() / semilogx() / semilogy()Tracé de ligne avec coordonnées logarithmiques
grouped_bar()Diagramme à barres groupées (nouveau dans 3.10+)
bar_label() / pie_label()Ajouter des étiquettes de valeurs aux diagrammes à barres/circulaires

step() - Graphique en escalier

matplotlib.pyplot.step(x, y, *args, where='pre', **kwargs)
ParamètreDescription
x, yCoordonnées des points de données
oùPosition de l'étape : 'pre' (avant), 'post' (après), 'mid' (milieu)

Exemples

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 10, 0.5)
y = np.sin(x)

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

# Comparer les trois modes de where
ax.plot(x, y, 'gray', alpha=0.3, label='Original (plot)')
ax.step(x, y, where='pre', label='where="pre"', linewidth=2)
ax.step(x, y, where='post', label='where="post"', linewidth=2)
ax.step(x, y, where='mid', label='where="mid"', linewidth=2)

ax.set_title('step() - Tracé en escalier')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

stem() - Tracé à tiges

matplotlib.pyplot.stem(*args, linefmt=None, markerfmt=None,
    basefmt=None, bottom=0, orientation='vertical', **kwargs)

Exemples

import matplotlib.pyplot as plt
import numpy as np

n = 30
x = np.arange(n)
y = np.random.randn(n) * 2

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
                                 layout='constrained')

# Tracé à tiges vertical
ax1.stem(x, y, linefmt='steelblue', markerfmt='o',
         basefmt='gray')
ax1.set_title('stem() vertical')

# Tracé à tiges horizontal
ax2.stem(x, y, linefmt='coral', markerfmt='s',
         basefmt='gray', orientation='horizontal')
ax2.set_title('stem() horizontal')

plt.show()

stackplot() - Graphique en aires empilées

matplotlib.pyplot.stackplot(x, *args, labels=None, colors=None,
    baseline='zero', **kwargs)

Exemples

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 10, 0.1)
y1 = np.sin(x) + 2
y2 = np.cos(x) + 2
y3 = 0.5 * np.sin(2*x) + 2

fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')

ax.stackplot(x, y1, y2, y3,
             labels=['Signal 1', 'Signal 2', 'Signal 3'],
             colors=['#3498db', '#e74c3c', '#2E7DCC'],
             alpha=0.7)

ax.set_title('stackplot() - Graphique en aires empilées')
ax.legend(loc='upper right')
plt.show()

vlines() / hlines() - Lignes de référence

matplotlib.pyplot.vlines(x, ymin, ymax, colors=None, **kwargs)
matplotlib.pyplot.hlines(y, xmin, xmax, colors=None, **kwargs)

Exemples

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)
y = np.sin(x)

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
ax.plot(x, y, 'k-', linewidth=2, alpha=0.7)

# Plusieurs lignes verticales (marquant les multiples de π)
pi_x = [np.pi, 2*np.pi, 3*np.pi]
ax.vlines(pi_x, ymin=-1.5, ymax=1.5,
          colors='red', linestyles='--', alpha=0.5,
          label='multiples de π')

# Plusieurs lignes horizontales (marquant ±1)
ax.hlines([-1, 0, 1], xmin=0, xmax=10,
          colors=['gray','gray','gray'],
          linestyles=['--',':','--'], alpha=0.5)

ax.set_title('vlines() et hlines()')
ax.legend()
plt.show()

loglog() / semilogx() / semilogy() - Coordonnées logarithmiques

matplotlib.pyplot.loglog(*args, **kwargs)
matplotlib.pyplot.semilogx(*args, **kwargs)
matplotlib.pyplot.semilogy(*args, **kwargs)

Exemples

import matplotlib.pyplot as plt
import numpy as np

x = np.logspace(0, 3, 50)      # 10^0 à 10^3
y1 = x**2
y2 = x**1.5
y3 = np.exp(x/50)

fig, axes = plt.subplots(1, 3, figsize=(12, 4),
                          layout='constrained')

# Doublement logarithmique
axes[0].loglog(x, y1, 'b-', label='x²')
axes[0].loglog(x, y2, 'r--', label='x¹·⁵')
axes[0].set_title('loglog()')
axes[0].grid(True, alpha=0.3)
axes[0].legend()

# Axe des x logarithmique
axes[1].semilogx(x, y3, 'green', label='exp(x/50)')
axes[1].set_title('semilogx()')
axes[1].grid(True, alpha=0.3)

# Axe des y logarithmique
axes[2].semilogy(x, y3, 'purple', label='exp(x/50)')
axes[2].set_title('semilogy()')
axes[2].grid(True, alpha=0.3)

plt.show()

eventplot() - Tracé d'événements

matplotlib.pyplot.eventplot(positions, orientation='horizontal',
    lineoffsets=1, linelengths=1, linewidths=None, colors=None, **kwargs)

Exemples

import matplotlib.pyplot as plt
import numpy as np

np.random.seed(42)

# Temps des événements pour trois canaux
events_A = np.random.rand(20) * 10
events_B = np.random.rand(15) * 10
events_C = np.random.rand(25) * 10

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

ax.eventplot([events_A, events_B, events_C],
             colors=['#e74c3c', '#3498db', '#2E7DCC'],
             lineoffsets=[0, 1, 2],    # Position verticale de chaque ligne
             linelengths=0.8,
             linewidths=1.5)

ax.set_title('eventplot() - Diagramme de chronologie des événements')
ax.set_xlabel('Temps (s)')
ax.set_yticks([0, 1, 2])
ax.set_yticklabels(['Canal A', 'Canal B', 'Canal C'])
plt.show()

broken_barh() - Diagramme à barres brisées

matplotlib.pyplot.broken_barh(xranges, yrange, **kwargs)

Exemples

import matplotlib.pyplot as plt

# Simuler un diagramme de Gantt
tasks = [
    [(0, 5)],                   # Tâche 1 : commence à 0, dure 5
    [(3, 4)],                   # Tâche 2 : commence à 3, dure 4
    [(2, 3), (6, 3)],          # Tâche 3 : deux périodes
    [(5, 4)],                   # Tâche 4
    [(1, 2), (4, 2), (8, 2)],  # Tâche 5 : trois périodes
]

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

colors = ['#3498db', '#e74c3c', '#2E7DCC', '#f39c12', '#9b59b6']
for i, (task, color) in enumerate(zip(tasks, colors)):
    ax.broken_barh(task, (i - 0.4, 0.8), facecolors=color)

ax.set_title('broken_barh() - Diagramme de style Gantt')
ax.set_xlabel('Temps')
ax.set_yticks(range(5))
ax.set_yticklabels([f'Tâche {i+1}' for i in range(5)])
ax.grid(True, alpha=0.3)
plt.show()

fill() - Polygone rempli

matplotlib.pyplot.fill(*args, **kwargs)

Exemples

import matplotlib.pyplot as plt
import numpy as np

fig, ax = plt.subplots(layout='constrained')

# Remplir un losange
x = [1, 2, 1, 0]
y = [0, 1, 2, 1]
ax.fill(x, y, alpha=0.5, color='steelblue',
        edgecolor='black', label='Losange')

# Remplir un pentagone
theta = np.linspace(0, 2*np.pi, 6)
x2 = 2.5 + np.cos(theta)
y2 = 1 + np.sin(theta)
ax.fill(x2, y2, alpha=0.5, color='coral',
        edgecolor='black', label='Pentagone')

ax.set_title('fill() - Polygones remplis')
ax.set_aspect('equal')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

Matplotlib 参考文档Documentation de référence de Matplotlib

Autres extensions