Función subplots() de Matplotlib


Matplotlib 参考文档Documentación de referencia de Matplotlib

subplots()Es la forma recomendada de crear una Figure y un conjunto de Axes (subgráficos), ya que con una sola llamada se completa la creación del lienzo y los subgráficos.

Es la función de entrada principal de la interfaz orientada a objetos de Matplotlib.

Definición de la función

Interfaz pyplot

matplotlib.pyplot.subplots(nrows=1, ncols=1, *, sharex=False,
    sharey=False, squeeze=True, width_ratios=None,
    height_ratios=None, subplot_kw=None, gridspec_kw=None,
    **fig_kw)

Método Figure

Figure.subplots(nrows=1, ncols=1, *, sharex=False, sharey=False,
    squeeze=True, width_ratios=None, height_ratios=None,
    subplot_kw=None, gridspec_kw=None)

Descripción de parámetros

ParámetroTipoDescripción
nrowsintNúmero de filas de subgráficos, por defecto 1
ncolsintNúmero de columnas de subgráficos, por defecto 1
sharex / shareybool o strSi se comparten los ejes x/y. Se puede pasar 'all'/'row'/'col'/'none' o un valor booleano
squeezeboolSi es True, en una sola fila/columna se eliminan automáticamente las dimensiones sobrantes, por defecto True
width_ratioslistProporción de ancho de cada columna, por ejemplo [1, 2] indica que la 2.ª columna es 2 veces más ancha que la 1.ª
height_ratioslistProporción de alto de cada fila, por ejemplo [2, 1] indica que la 1.ª fila es 2 veces más alta que la 2.ª
subplot_kwdictParámetros pasados a la creación de subgráficos, por ejemplo dict(projection='polar') crea un subgráfico de coordenadas polares
gridspec_kwdictParámetros pasados a GridSpec, por ejemplo dict(hspace=0.3, wspace=0.3) establece el espaciado entre subgráficos
**fig_kwdictParámetros pasados a la creación de Figure, por ejemplo figsize=(8,6), dpi=100, layout='constrained'

El valor de retorno de subplots() es una tupla(fig, ax). Cuando solo hay una fila y una columna, ax es un único objeto Axes; cuando hay varias filas y columnas, ax es un arreglo bidimensional de Axes.


Ejemplos de uso

Ejemplo 1: Subgráfico único

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

# Crear un único subgráfico (la forma más común)
fig, ax = plt.subplots(figsize=(6, 4), layout='constrained')

x = np.linspace(0, 10, 100)
ax.plot(x, np.sin(x))
ax.set_title('Single Subplot')
ax.set_xlabel('x')
ax.set_ylabel('sin(x)')
ax.grid(True, alpha=0.3)
plt.show()

Ejemplo 2: Una fila con varias columnas / Una columna con varias filas

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

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

# Una fila y tres columnas
fig, axes = plt.subplots(1, 3, figsize=(12, 4),
                          layout='constrained')

# axes es un arreglo unidimensional
axes[0].plot(x, np.sin(x), color='blue')
axes[0].set_title('sin(x)')

axes[1].plot(x, np.cos(x), color='red')
axes[1].set_title('cos(x)')

axes[2].plot(x, np.tan(x), color='green')
axes[2].set_title('tan(x)')
axes[2].set_ylim(-5, 5)  # Limitar el rango de y

for ax in axes:
    ax.set_xlabel('x')
    ax.grid(True, alpha=0.3)

fig.suptitle('Three Subplots in One Row', fontsize=14)
plt.show()

Ejemplo 3: Cuadrícula 2x2 + proporción de ancho y alto

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

# Proporción ancho/alto: la 1.ª fila es más alta, la 2.ª columna es más ancha
fig, axes = plt.subplots(2, 2,
                          figsize=(10, 8),
                          width_ratios=[1, 2],   # El ancho de la 2.ª columna es 2 veces el de la 1.ª
                          height_ratios=[2, 1],   # La altura de la 1.ª fila es 2 veces la de la 2.ª
                          layout='constrained',
                          sharex='col',           # Cada columna comparte el eje x
                          sharey='row')           # Cada fila comparte el eje y

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

# axes es un arreglo bidimensional, axes[fila, col]
axes[0, 0].plot(x, np.sin(x))
axes[0, 0].set_title('sin(x)')

axes[0, 1].plot(x, np.cos(x), 'orange')
axes[0, 1].set_title('cos(x)')

axes[1, 0].plot(x, np.sin(2*x), 'green')
axes[1, 0].set_title('sin(2x)')

axes[1, 1].plot(x, np.cos(2*x), 'red')
axes[1, 1].set_title('cos(2x)')

fig.suptitle('2x2 Grid with Width/Height Ratios', fontsize=14)
plt.show()

Ejemplo 4: sharex y sharey ejes compartidos

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

np.random.seed(42)

# Compartir el eje x, conveniente para comparar series temporales
fig, axes = plt.subplots(3, 1, figsize=(8, 6),
                          sharex=True,            # Compartir el eje x
                          layout='constrained')

t = np.linspace(0, 20, 200)

# Los tres subgráficos comparten el eje x y se alinean en el mismo tiempo
axes[0].plot(t, np.sin(t), 'blue')
axes[0].set_ylabel('Signal 1')
axes[0].grid(True, alpha=0.3)

axes[1].plot(t, np.cos(t * 1.5), 'green')
axes[1].set_ylabel('Signal 2')
axes[1].grid(True, alpha=0.3)

axes[2].plot(t, np.sin(t * 0.7) + np.cos(t * 1.3), 'red')
axes[2].set_xlabel('Time (s)')
axes[2].set_ylabel('Signal 3')
axes[2].grid(True, alpha=0.3)

fig.suptitle('Shared X-Axis: Three Time Series', fontsize=14)
plt.show()

Ejemplo 5: Subgráfico de coordenadas polares

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
    subplot_kw={'projection': 'polar'},  # Ambos son de coordenadas polares
    layout='constrained')

theta = np.linspace(0, 2 * np.pi, 100)

# Gráfico izquierdo: rosa polar (rose curve)
r1 = np.abs(np.sin(3 * theta))
ax1.plot(theta, r1, color='blue', linewidth=2)
ax1.set_title('Polar: Rose Curve (r=|sin(3θ)|)')

# Gráfico derecho: espiral de Arquímedes
r2 = theta / 6
ax2.plot(theta, r2, color='red', linewidth=2)
ax2.set_title('Polar: Archimedean Spiral')

plt.show()

Preguntas frecuentes

¿Para qué sirve el parámetro squeeze?

squeeze=TrueCuando (por defecto):subplots(1,1)devuelveax(no [ax]),subplots(1,3)devuelve un arreglo unidimensional.

squeeze=FalseCuando , siempre devuelve un arreglo bidimensional (sin importar filas y columnas), adecuado para escenarios que requieren procesamiento uniforme.

¿Cuál es la diferencia entre subplot_kw y gridspec_kw?

subplot_kwSe pasa a cada función de creación de Axes, comoprojection='polar'。

gridspec_kwSe pasa al administrador de diseño GridSpec, comohspace=0.4(espaciado vertical entre subgráficos).


Matplotlib 参考文档Documentación de referencia de Matplotlib

Otras extensiones