Fonctions de lignes d'étendue et de champ vectoriel de Matplotlib


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

FonctionDescription
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()

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()

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()

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

Autres extensions