HOWTO · Matplotlib
Cómo añadir título a las subtramas en Matplotlib
Podemos añadir un título a las subtramas en Matplotlib usando Axes.set_title(), Axes.title.set_text() o los ejes actuales de pyplot (plt.gca()).
En esta página
Para dar a cada subtrama su propio título, llama a Axes.set_title() en el eje correspondiente. Es la opción más clara cuando creas varios gráficos a la vez, porque cada título queda asociado al eje que describe. El título de una subtrama corresponde a un eje; si quieres un título para toda la figura, usa uno general, como fig.suptitle().
Añadir títulos a las subtramas con Axes.set_title()
Cuando se establece squeeze=False, plt.subplots() devuelve una figura y un arreglo de ejes. El ejemplo siguiente representa cuatro series, empareja cada eje con una etiqueta descriptiva y ajusta la distribución antes de mostrar la figura. Así, axes conserva dos dimensiones tanto en una cuadrícula de 2×2 como en una sola fila (1×N), una sola columna (N×1) o una única subtrama (1×1). Para usar una cuadrícula de otro tamaño, ajusta los argumentos de plt.subplots() y proporciona un título para cada eje.
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 2 * np.pi, 100)
series = [np.sin(x), np.cos(x), np.sin(2 * x), np.cos(2 * x)]
titles = ["Sine", "Cosine", "Sine, double frequency", "Cosine, double frequency"]
fig, axes = plt.subplots(2, 2, figsize=(8, 5), squeeze=False)
for ax, y, title in zip(axes.flat, series, titles):
ax.plot(x, y)
ax.set_title(title)
fig.tight_layout()
plt.show()
Como squeeze=False mantiene los ejes en un arreglo bidimensional incluso en una cuadrícula de 1×1, axes.flat permite iterar de forma uniforme por las cuatro formas de cuadrícula: 2×2, 1×N, N×1 y 1×1. zip() empareja cada eje y cada serie de datos con un título, así que mantén esas colecciones en el mismo orden y con la misma longitud.
El argumento label es el texto que aparece sobre un eje. También puedes pasar opciones como fontsize o loc para controlar el aspecto y la posición del título. Procura que los títulos largos sean concisos; si los títulos o las etiquetas contiguos tienen poco espacio, aumenta el tamaño de la figura o ajusta el espaciado antes de mostrarla. tight_layout() es un buen punto de partida, aunque una distribución con muchos elementos decorativos puede requerir ajustes adicionales del espaciado.
Establecer títulos de subtramas con Axes.title.set_text()
Un eje también expone su título como un objeto de texto. Usa Axes.title.set_text() para establecer o actualizar ese texto una vez creado el eje. Puede resultar práctico si el programa ya conserva una referencia al objeto de texto o si cambia el título más adelante. Para configurar el gráfico inicialmente, Axes.set_title() suele ser más directo y deja clara la operación en la llamada al eje.
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 2 * np.pi, 100)
fig, axes = plt.subplots(1, 2, figsize=(8, 3.5), squeeze=False)
axes[0, 0].plot(x, np.sin(x))
axes[0, 1].plot(x, np.cos(x))
axes[0, 0].title.set_text("Sine")
axes[0, 1].title.set_text("Cosine")
fig.tight_layout()
plt.show()
Por ejemplo, después de crear un eje llamado ax, llama a ax.title.set_text("Updated title"). Esto actualiza el título de ese eje; no establece el título de todas las subtramas de la figura. Si hay varios ejes, selecciona explícitamente el que quieras actualizar o itera por los ejes y sus cadenas correspondientes, como en el primer ejemplo. Ambas API modifican el título del eje, así que elige un método para cada operación en lugar de establecer el mismo título dos veces.
Establecer títulos de subtramas con los ejes actuales de pyplot
Al usar la interfaz de estado de pyplot, plt.gca() devuelve el eje actual. Puedes establecer su título con plt.gca().set_title("Title"); la forma equivalente con el objeto de texto es plt.gca().title.set_text("Title"). Los paréntesis son importantes: gca() es una llamada a una función que obtiene el eje actual. Estas formas solo afectan al eje que está seleccionado en ese momento, por lo que resultan útiles al representar un eje cada vez.
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 2 * np.pi, 100)
series = [np.sin(x), np.cos(x), np.sin(2 * x), np.cos(2 * x)]
titles = ["Sine", "Cosine", "Sine, double frequency", "Cosine, double frequency"]
plt.figure(figsize=(8, 5))
for position, (y, title) in enumerate(zip(series, titles), start=1):
plt.subplot(2, 2, position)
plt.plot(x, y)
plt.gca().set_title(title)
plt.tight_layout()
plt.show()
En una cuadrícula, selecciona cada subtrama antes de establecer su título. Por ejemplo, plt.subplot(2, 2, position) selecciona una posición del uno al cuatro; después, plt.gca().set_title(title) aplica el título a ese eje. Si creas la cuadrícula con fig, axes = plt.subplots(...), normalmente es más fácil seguir el código si usas las referencias a los ejes devueltas, y dependerás menos del estado actual de pyplot.
Termina de configurar la figura antes de llamar a plt.show(). En particular, llama a plt.tight_layout() antes de mostrarla para que la distribución tenga en cuenta los títulos de las subtramas.
Corregir títulos superpuestos o recortados y títulos ausentes
Un título se centra sobre su eje, de modo que un título largo puede ser más ancho que el propio eje. Con los dos títulos usados en el ejemplo siguiente, en una figura de tamaño (8, 3.5), las cajas de título medidas se superponen 15 píxeles cuando no se aplica ningún ajuste de distribución, así que el final de un título se mete en el comienzo del siguiente. Llamar a fig.tight_layout() los separa —la misma medición deja entonces un espacio de 39 píxeles—, pero tight_layout() solo redistribuye el espacio entre las subtramas; no reduce el texto del título. Con ese tamaño de figura, el segundo título se extiende entonces 11 píxeles más allá del borde derecho de la figura y queda recortado en la salida renderizada. La corrección completa consiste en dar espacio a los títulos: mantén tight_layout() y ensancha la figura, como en este ejemplo, o acorta los títulos. Reducir el fontsize del título a 11 con el tamaño original también deja ambos títulos por completo dentro de la figura.
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 2 * np.pi, 100)
fig, axes = plt.subplots(1, 2, figsize=(9, 3.5), squeeze=False)
axes[0, 0].plot(x, np.sin(x))
axes[0, 1].plot(x, np.cos(x))
axes[0, 0].set_title("Sine wave measured at the first sensor")
axes[0, 1].set_title("Cosine wave measured at the second sensor")
fig.tight_layout()
plt.show()
Con el tamaño (9, 3.5), ambos títulos terminan dentro de la figura, con espacio entre ellos, y ningún texto queda cortado. En cambio, un título ausente falla en silencio: los bucles de este artículo emparejan ejes y títulos mediante zip(), y zip() se detiene en la secuencia más corta sin lanzar ningún error. Si se proporcionan tres títulos para las cuatro subtramas de una cuadrícula de 2×2, el cuarto eje se queda con un título vacío —al leerlo con ax.get_title() se obtiene una cadena vacía— y nada te avisa. Cuando una subtrama aparece sin título, cuenta los títulos frente a los ejes antes de revisar las propias llamadas de título.