Fonctions de traçage avancées de 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
| Fonction | Description |
|---|---|
| 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ètre | Description |
|---|---|
| x, y | Coordonné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()
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()
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()
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()
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()
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()
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()
# 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()
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()
Autres extensions