función figure() de Matplotlib
Documentación de referencia de Matplotlib
figure()Se usa para crear una nueva Figure (lienzo) o activar una Figure existente.
Figure es el contenedor de nivel superior de todos los gráficos; gestiona el tamaño de todo el gráfico, el DPI y todos los subgráficos.
Definición de la función
matplotlib.pyplot.figure(num=None, figsize=None, dpi=None, *,
facecolor=None, edgecolor=None, frameon=True,
FigureClass=<class 'matplotlib.figure.Figure'>,
clear=False, layout=None, **kwargs)
Descripción de parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| num | int o str | Identificador de Figure. Los enteros son números, las cadenas son etiquetas. Si no existe, se crea uno nuevo; si existe, se activa el existente. |
| figsize | tuple (w, h) | Tamaño de Figure (en pulgadas), por ejemplo (8, 6). Por defecto, lo determina rcParams. |
| dpi | float | Resolución (puntos por pulgada), por ejemplo 100. Afecta el tamaño de salida en píxeles. |
| facecolor | color | Color de fondo de Figure |
| edgecolor | color | Color del borde de Figure |
| frameon | bool | Si se muestra el marco de fondo de Figure, por defecto True |
| clear | bool | Si num ya existe, si se debe limpiar antes de usarlo |
| layout | str o LayoutEngine | RecomendadoMotor de diseño: 'constrained', 'compressed', 'tight', 'none' |
En el uso diario, rara vez se llama directamente
figure(), es más común usarsubplots()Crea Figure y Axes de una sola vez. Usar figure() por separado se usa principalmente en escenarios de múltiples Figures o para personalizar propiedades del lienzo.
Ejemplos de uso
Ejemplo 1: Crear una Figure de tamaño personalizado
Ejemplo
import numpy as np
# Crear una Figure con tamaño específico y alto DPI
fig = plt.figure(figsize=(10, 4), dpi=100,
facecolor='#f8f9fa',
layout='constrained')
# Agregar subplot manualmente
ax1 = fig.add_subplot(1, 2, 1)
ax2 = fig.add_subplot(1, 2, 2)
x = np.linspace(0, 10, 100)
ax1.plot(x, np.sin(x), 'steelblue', linewidth=2)
ax1.set_title('Plot 1')
ax2.plot(x, np.cos(x), 'coral', linewidth=2)
ax2.set_title('Plot 2')
plt.show()
Ejemplo 2: Gestión de múltiples Figures
Ejemplo
import numpy as np
x = np.linspace(0, 10, 100)
# Crear Figure #1
fig1 = plt.figure(1, figsize=(6, 4))
ax1 = fig1.subplots()
ax1.plot(x, np.sin(x), 'blue')
ax1.set_title('Figure 1: sin(x)')
# Crear Figure #2
fig2 = plt.figure(2, figsize=(6, 4))
ax2 = fig2.subplots()
ax2.plot(x, np.cos(x), 'red')
ax2.set_title('Figure 2: cos(x)')
# Activar Figure #1 y continuar operando
plt.figure(1)
plt.plot(x, np.sin(2*x), '--', alpha=0.5)
# Guardar una Figure específica
fig1.savefig('ejemplo_fig1.png', dpi=150)
fig2.savefig('ejemplo_fig2.png', dpi=150)
print("ejemplo: two figures saved")
plt.show()
Ejemplo 3: Diseño automático con el parámetro layout
Ejemplo
import numpy as np
# Comparar las configuraciones de layout
# Sin usar layout (las etiquetas pueden superponerse)
fig1 = plt.figure(1, figsize=(8, 4))
for i in range(3):
ax = fig1.add_subplot(1, 3, i+1)
ax.plot(np.random.randn(50).cumsum())
ax.set_title(f'Plot {i+1}')
ax.set_xlabel('A very long x label')
# Usar layout='constrained' (maneja automáticamente la superposición)
fig2 = plt.figure(2, figsize=(8, 4), layout='constrained')
for i in range(3):
ax = fig2.add_subplot(1, 3, i+1)
ax.plot(np.random.randn(50).cumsum())
ax.set_title(f'Plot {i+1}')
ax.set_xlabel('A very long x label')
plt.figure(1)
plt.suptitle('Without layout', y=1.02)
plt.figure(2)
plt.suptitle('With layout="constrained"', y=1.02)
plt.show()
print("ejemplo: compare layout settings")
Preguntas frecuentes
¿Cuál es la unidad de medida de figsize?
Pulgadas (inches). El tamaño real en píxeles = figsize × dpi. Por ejemplofigsize=(8,6), dpi=100Genera una imagen de 800×600 píxeles.
¿Qué opción de layout es la mejor?
'constrained'Es la opción recomendada en la mayoría de los casos; maneja automáticamente el espaciado entre subplots y etiquetas.
'compressed'Comprime aún más los márgenes; adecuado para escenarios que necesitan maximizar el área de datos.
'none'No usa diseño automático (por defecto); se puede ajustar manualmente con subplots_adjust().
Otras extensiones