Matplotlib funciones de títulos y etiquetas


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

Matplotlib proporciona un conjunto de funciones para establecer el título del gráfico, las etiquetas de los ejes y el título general, que son la base para que un gráfico sea completo y legible.

Funciones involucradas

FunciónFuncionalidadMétodos correspondientes de Axes
title()Establecer el título de Axesax.set_title()
xlabel() / ylabel()Establecer etiquetas de ejes x/yax.set_xlabel() / ax.set_ylabel()
suptitle()Establecer el título general de Figurefig.suptitle()
supxlabel() / supylabel()Establecer etiquetas de ejes x/y a nivel de Figurefig.supxlabel() / fig.supylabel()

Definición de funciones

matplotlib.pyplot.title(label, fontdict=None, loc=None, pad=None,
    *, y=None, **kwargs)
matplotlib.pyplot.xlabel(xlabel, fontdict=None, labelpad=None, *,
    loc=None, **kwargs)
matplotlib.pyplot.ylabel(ylabel, fontdict=None, labelpad=None, *,
    loc=None, **kwargs)
matplotlib.pyplot.suptitle(t, **kwargs)
matplotlib.pyplot.supxlabel(t, **kwargs)
matplotlib.pyplot.supylabel(t, **kwargs)

Parámetros comunes

ParámetroDescripción
label / xlabel / ylabel / tContenido del texto (obligatorio)
fontsize / sizeTamaño de fuente, por ejemplo 14, 'large', 'x-large'
fontweight / weightPeso de fuente: 'normal', 'bold', 'light'
colorColor del texto
fontdictDiccionario de propiedades de fuente, como {'fontsize':14, 'color':'blue'}
locPosición de alineación: 'center' (predeterminado), 'left', 'right'
pad / labelpadEspaciado entre el texto y el borde de los ejes/gráfico (en puntos)
y (solo para title)Posición vertical del título (coordenadas de Axes, 1.0 es la parte superior)

AxesLos métodos de los objetos se nombran usandoset_como prefijo, por ejemploax.set_title()、ax.set_xlabel(), esta es la forma recomendada para la interfaz orientada a objetos.


Ejemplos de uso

Ejemplo 1: Título básico y etiquetas

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)
y = np.sin(x) * np.exp(-x/5)

fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')

ax.plot(x, y, 'steelblue', linewidth=2)

# Establecer el título (nivel de Axes)
ax.set_title('Damped Sine Wave', fontsize=14, fontweight='bold')

# Establecer etiquetas de ejes
ax.set_xlabel('Time (seconds)', fontsize=12)
ax.set_ylabel('Amplitude (V)', fontsize=12)

ax.grid(True, alpha=0.3)
plt.show()

Ejemplo 2: Título general de Figure + etiquetas de ejes

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

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

fig, axes = plt.subplots(2, 2, figsize=(10, 8),
                          layout='constrained')

# Cada subplot tiene su propio título
axes[0, 0].plot(x, np.sin(x)); axes[0, 0].set_title('sin(x)')
axes[0, 1].plot(x, np.cos(x)); axes[0, 1].set_title('cos(x)')
axes[1, 0].plot(x, np.sin(2*x)); axes[1, 0].set_title('sin(2x)')
axes[1, 1].plot(x, np.cos(2*x)); axes[1, 1].set_title('cos(2x)')

# Título general a nivel de Figure
fig.suptitle('Trigonometric Functions Overview',
             fontsize=16, fontweight='bold', y=1.02)

# Etiquetas de ejes a nivel de Figure (centradas en todos los subplots)
fig.supxlabel('x (radians)', fontsize=13)
fig.supylabel('Amplitude', fontsize=13)

plt.show()

Ejemplo 3: Posición y estilo del título

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

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

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
                                 layout='constrained')

# Gráfico izquierdo: título alineado a la izquierda
ax1.plot(x, np.sin(x), 'steelblue')
ax1.set_title('Left-aligned Title',
              loc='left',                # Alineado a la izquierda
              fontsize=12,
              color='steelblue')
ax1.set_xlabel('X-axis', fontsize=10, color='gray')

# Gráfico derecho: título alineado a la derecha
ax2.plot(x, np.cos(x), 'coral')
ax2.set_title('Right-aligned Title',
              loc='right',               # Alineado a la derecha
              fontsize=12,
              color='coral',
              fontstyle='italic')
ax2.set_ylabel('Y-axis', fontsize=10, color='gray',
               rotation=0, labelpad=20)  # Las etiquetas no se rotan

plt.show()

Ejemplo 4: Título con fórmula matemática en LaTeX

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(-5, 5, 200)

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
                                 layout='constrained')

# Distribución gaussiana
sigma, mu = 1.0, 0.0
y1 = 1/(sigma * np.sqrt(2*np.pi)) * np.exp(-(x-mu)**2/(2*sigma**2))
ax1.plot(x, y1, 'steelblue', linewidth=2)

# Usar una fórmula LaTeX como título
ax1.set_title(
    r'$f(x) = frac{1}{sigmasqrt{2pi}}'
    r'expleft(-frac{(x-mu)^2}{2sigma^2}right)$',
    fontsize=12)

# Polinomio
y2 = x**3 - 3*x
ax2.plot(x, y2, 'coral', linewidth=2)
ax2.set_title(r'$f(x) = x^3 - 3x$', fontsize=14)
ax2.axhline(y=0, color='gray', linewidth=0.5)

for ax in [ax1, ax2]:
    ax.set_xlabel('x')
    ax.grid(True, alpha=0.3)

fig.suptitle('Functions with LaTeX Titles', fontsize=14,
             fontweight='bold')
plt.show()
print("ejemplo: LaTeX titles displayed")

Preguntas frecuentes

¿Cuál es la diferencia entre title() y suptitle()?

title()(oax.set_title()): establece el título sobre un solo Axes.

suptitle()(ofig.suptitle()): establece el título general en la parte superior de toda la Figure, cubriendo todos los subplots.

¿Cómo hacer que el título admita chino?

Configurar la fuente:plt.rcParams['font.sans-serif'] = ['SimHei']oplt.rcParams['font.family'] = 'sans-serif'。


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

Otras extensiones