función figure() de Matplotlib


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ámetroTipoDescripción
numint o strIdentificador de Figure. Los enteros son números, las cadenas son etiquetas. Si no existe, se crea uno nuevo; si existe, se activa el existente.
figsizetuple (w, h)Tamaño de Figure (en pulgadas), por ejemplo (8, 6). Por defecto, lo determina rcParams.
dpifloatResolución (puntos por pulgada), por ejemplo 100. Afecta el tamaño de salida en píxeles.
facecolorcolorColor de fondo de Figure
edgecolorcolorColor del borde de Figure
frameonboolSi se muestra el marco de fondo de Figure, por defecto True
clearboolSi num ya existe, si se debe limpiar antes de usarlo
layoutstr o LayoutEngineRecomendadoMotor de diseño: 'constrained', 'compressed', 'tight', 'none'

En el uso diario, rara vez se llama directamentefigure(), 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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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().


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

Otras extensiones