Función subplots() de 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ámetro | Tipo | Descripción |
|---|---|---|
| nrows | int | Número de filas de subgráficos, por defecto 1 |
| ncols | int | Número de columnas de subgráficos, por defecto 1 |
| sharex / sharey | bool o str | Si se comparten los ejes x/y. Se puede pasar 'all'/'row'/'col'/'none' o un valor booleano |
| squeeze | bool | Si es True, en una sola fila/columna se eliminan automáticamente las dimensiones sobrantes, por defecto True |
| width_ratios | list | Proporció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_ratios | list | Proporció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_kw | dict | Parámetros pasados a la creación de subgráficos, por ejemplo dict(projection='polar') crea un subgráfico de coordenadas polares |
| gridspec_kw | dict | Parámetros pasados a GridSpec, por ejemplo dict(hspace=0.3, wspace=0.3) establece el espaciado entre subgráficos |
| **fig_kw | dict | Pará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 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 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 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 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 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).
Otras extensiones