Fonctions de lignes d'étendue et de champ vectoriel de Matplotlib
Documentation de référence de Matplotlib
Les fonctions de lignes d'étendue servent à ajouter des lignes de référence et des bandes ombrées qui s'étendent sur tout l'objet Axes d'un graphique ; les fonctions de champ vectoriel servent à tracer des diagrammes de flèches et des tracés de lignes de courant.
Aperçu des fonctions
| Fonction | Description |
|---|---|
| axhline() | Ajouter une ligne horizontale s'étendant sur tout l'objet Axes |
| axhspan() | Ajouter une bande ombrée horizontale s'étendant sur tout l'objet Axes |
| axvline() | Ajouter une ligne verticale s'étendant sur tout l'objet Axes |
| axvspan() | Ajouter une bande ombrée verticale s'étendant sur tout l'objet Axes |
| axline() | Ajouter une ligne infinie passant par deux points |
| quiver() | Tracer un champ vectoriel (diagramme de flèches) |
| quiverkey() | Ajouter une légende d'échelle à un champ vectoriel |
| barbs() | Tracer un diagramme de barbules de vent (pour la météorologie) |
| streamplot() | Tracer un diagramme de lignes de courant |
Fonctions d'intervalle
axhline() / axvline()
matplotlib.pyplot.axhline(y=0, xmin=0, xmax=1, **kwargs) matplotlib.pyplot.axvline(x=0, ymin=0, ymax=1, **kwargs)
axhspan() / axvspan()
matplotlib.pyplot.axhspan(ymin, ymax, xmin=0, xmax=1, **kwargs) matplotlib.pyplot.axvspan(xmin, xmax, ymin=0, ymax=1, **kwargs)
axline()
matplotlib.pyplot.axline(xy1, xy2=None, *, slope=None, **kwargs)
Exemples
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
y = np.sin(x)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5),
layout='constrained')
# Graphique de gauche : courbes d'intervalle
ax1.plot(x, y, 'k-', alpha=0.7)
ax1.axhline(y=0, color='gray', linewidth=0.8) # ligne horizontale y=0
ax1.axhline(y=0.5, color='green', linestyle='--') # y=0.5
ax1.axvline(x=np.pi, color='red', linestyle='--') # x=π
ax1.axvspan(np.pi, 2*np.pi, alpha=0.15, # Bande ombrée
color='red', label='Phase 2')
ax1.axhspan(0.5, 1.0, xmin=0.6, xmax=1.0, # Bande ombrée locale
alpha=0.15, color='blue')
ax1.set_title('Fonctions d'étendue')
ax1.legend()
# Graphique de droite : axline définit une droite infinie passant par deux points
ax2.plot([0, 2, 4], [0, 2, 3], 'ro', label='Points de données')
ax2.axline((0, 0), (2, 2), color='blue', linestyle='--',
label='Passant par (0,0) et (2,2)')
ax2.axline((0, 0), slope=1.5, color='green',
linestyle=':', label='De (0,0) avec pente=1.5')
ax2.set_xlim(-1, 5)
ax2.set_ylim(-1, 5)
ax2.set_title('axline()')
ax2.legend()
ax2.grid(True, alpha=0.3)
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
y = np.sin(x)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5),
layout='constrained')
# Graphique de gauche : courbes d'intervalle
ax1.plot(x, y, 'k-', alpha=0.7)
ax1.axhline(y=0, color='gray', linewidth=0.8) # ligne horizontale y=0
ax1.axhline(y=0.5, color='green', linestyle='--') # y=0.5
ax1.axvline(x=np.pi, color='red', linestyle='--') # x=π
ax1.axvspan(np.pi, 2*np.pi, alpha=0.15, # Bande ombrée
color='red', label='Phase 2')
ax1.axhspan(0.5, 1.0, xmin=0.6, xmax=1.0, # Bande ombrée locale
alpha=0.15, color='blue')
ax1.set_title('Fonctions d'étendue')
ax1.legend()
# Graphique de droite : axline définit une droite infinie passant par deux points
ax2.plot([0, 2, 4], [0, 2, 3], 'ro', label='Points de données')
ax2.axline((0, 0), (2, 2), color='blue', linestyle='--',
label='Passant par (0,0) et (2,2)')
ax2.axline((0, 0), slope=1.5, color='green',
linestyle=':', label='De (0,0) avec pente=1.5')
ax2.set_xlim(-1, 5)
ax2.set_ylim(-1, 5)
ax2.set_title('axline()')
ax2.legend()
ax2.grid(True, alpha=0.3)
plt.show()
Fonctions de champ vectoriel
quiver() - Champ vectoriel
matplotlib.pyplot.quiver(*args, **kwargs) # X, Y, U, V: 网格坐标和矢量分量 # C: 可选的颜色数据
streamplot() - Tracé de lignes de courant
matplotlib.pyplot.streamplot(x, y, u, v, density=1,
linewidth=None, color=None, cmap=None, **kwargs)
barbs() - Tracé de barbules de vent
matplotlib.pyplot.barbs(*args, **kwargs) # X, Y, U, V: 网格坐标和风分量
Exemples
import matplotlib.pyplot as plt
import numpy as np
# Créer des données de champ vectoriel
x = np.linspace(-3, 3, 15)
y = np.linspace(-3, 3, 15)
X, Y = np.meshgrid(x, y)
# Champ de vortex
U = -Y
V = X
# Norme de la vitesse
speed = np.sqrt(U**2 + V**2)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5),
layout='constrained')
# Graphique de gauche : tracé de flèches quiver
q = ax1.quiver(X, Y, U, V, speed, cmap='viridis',
scale=50, width=0.005)
fig.colorbar(q, ax=ax1, label='Vitesse')
ax1.set_title('quiver() - Champ de flèches')
ax1.set_aspect('equal')
# Graphique de droite : tracé de lignes de courant streamplot
strm = ax2.streamplot(x, y, U, V, color=speed,
cmap='plasma', density=1.5, linewidth=1.5)
fig.colorbar(strm.lines, ax=ax2, label='Vitesse')
ax2.set_title('streamplot() - Lignes de courant')
ax2.set_aspect('equal')
plt.show()
import numpy as np
# Créer des données de champ vectoriel
x = np.linspace(-3, 3, 15)
y = np.linspace(-3, 3, 15)
X, Y = np.meshgrid(x, y)
# Champ de vortex
U = -Y
V = X
# Norme de la vitesse
speed = np.sqrt(U**2 + V**2)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5),
layout='constrained')
# Graphique de gauche : tracé de flèches quiver
q = ax1.quiver(X, Y, U, V, speed, cmap='viridis',
scale=50, width=0.005)
fig.colorbar(q, ax=ax1, label='Vitesse')
ax1.set_title('quiver() - Champ de flèches')
ax1.set_aspect('equal')
# Graphique de droite : tracé de lignes de courant streamplot
strm = ax2.streamplot(x, y, U, V, color=speed,
cmap='plasma', density=1.5, linewidth=1.5)
fig.colorbar(strm.lines, ax=ax2, label='Vitesse')
ax2.set_title('streamplot() - Lignes de courant')
ax2.set_aspect('equal')
plt.show()
Exemple de barbs()
Exemples
import matplotlib.pyplot as plt
import numpy as np
# Données de champ de vent simulées
x = np.linspace(0, 10, 10)
y = np.linspace(0, 8, 8)
X, Y = np.meshgrid(x, y)
# Composantes du vent (vent uniforme vers l'est + perturbation aléatoire)
U = 10 + np.random.randn(*X.shape) * 3
V = np.random.randn(*X.shape) * 5
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
# Tracé de barbules de vent : les barbules représentent la vitesse du vent, la direction indique la direction du vent
ax.barbs(X, Y, U, V, length=6)
ax.set_title('barbs() - Barbules de vent (météorologiques)')
ax.set_xlabel('Longitude')
ax.set_ylabel('Latitude')
ax.set_xlim(-1, 11)
ax.set_ylim(-1, 9)
plt.show()
import numpy as np
# Données de champ de vent simulées
x = np.linspace(0, 10, 10)
y = np.linspace(0, 8, 8)
X, Y = np.meshgrid(x, y)
# Composantes du vent (vent uniforme vers l'est + perturbation aléatoire)
U = 10 + np.random.randn(*X.shape) * 3
V = np.random.randn(*X.shape) * 5
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
# Tracé de barbules de vent : les barbules représentent la vitesse du vent, la direction indique la direction du vent
ax.barbs(X, Y, U, V, length=6)
ax.set_title('barbs() - Barbules de vent (météorologiques)')
ax.set_xlabel('Longitude')
ax.set_ylabel('Latitude')
ax.set_xlim(-1, 11)
ax.set_ylim(-1, 9)
plt.show()
Autres extensions