Función Matplotlib text() / annotate()
Documentación de referencia de Matplotlib
text()Agrega texto en las coordenadas especificadas del gráfico,annotate()agrega anotaciones con flechas que pueden apuntar con precisión a puntos de datos.
Definición de la función
text()
matplotlib.pyplot.text(x, y, s, fontdict=None, **kwargs) Axes.text(x, y, s, fontdict=None, **kwargs)
annotate()
matplotlib.pyplot.annotate(text, xy, xytext=None, xycoords='data',
textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)
Axes.annotate(text, xy, xytext=None, xycoords='data',
textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)
Descripción de parámetros
Parámetros de text()
| Parámetro | Descripción |
|---|---|
| x, y | Coordenadas de posición del texto |
| s | Cadena de texto a mostrar |
| fontsize | Tamaño de fuente |
| color | Color del texto |
| ha / horizontalalignment | Alineación horizontal: 'center', 'right', 'left' |
| va / verticalalignment | Alineación vertical: 'center', 'top', 'bottom', 'baseline' |
| rotation | Ángulo de rotación (en grados) |
| fontweight | Peso de la fuente: 'normal', 'bold', 'light' |
| bbox | Propiedades del cuadro de fondo del texto, como dict(facecolor='yellow', alpha=0.5) |
Parámetros específicos de annotate()
| Parámetro | Descripción |
|---|---|
| text | Contenido del texto de anotación |
| xy | Coordenadas del punto objetivo señalado (x, y) (punta de la flecha) |
| xytext | Coordenadas de la posición donde se coloca el texto. Por defecto None (el texto se coloca en la posición xy) |
| xycoords / textcoords | Sistema de coordenadas de xy / xytext: 'data', 'axes fraction', 'figure fraction', 'offset points', etc. |
| arrowprops | Diccionario de propiedades de la flecha, como dict(arrowstyle='->', color='gray', lw=1.5) |
El valor principal de annotate es que xy y xytext pueden especificar por separado el punto de coordenadas y la posición del texto, y conectar ambos con una flecha, algo que text() no puede hacer.
Estilos de flecha comunes de arrowprops
| Estilo | Efecto |
|---|---|
| '->' | Flecha triangular sólida |
| '-' | Sin línea |
| '<->' | Flecha bidireccional |
| '-[widthB=...,lengthB=...]' | Flecha rectangular personalizada |
| 'fancy' | Flecha curva elegante |
| 'simple' | Flecha recta simple |
Ejemplos de uso
Ejemplo 1: Adición de texto básico (text)
Ejemplo
import numpy as np
x = np.linspace(0, 10, 100)
y = np.sin(x)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
ax.plot(x, y, 'steelblue', linewidth=2)
# Agrega una marca de texto en el pico
peak_idx = np.argmax(y)
ax.text(x[peak_idx], y[peak_idx] + 0.1,
f'Peak: ({x[peak_idx]:.2f}, {y[peak_idx]:.2f})',
fontsize=10, color='red',
ha='center', va='bottom',
fontweight='bold')
# Agrega texto + cuadro de fondo en el valle
valley_idx = np.argmin(y)
ax.text(x[valley_idx], y[valley_idx] - 0.15,
f'Valley: ({x[valley_idx]:.2f}, {y[valley_idx]:.2f})',
fontsize=10, ha='center', va='top',
bbox=dict(boxstyle='round,pad=0.3',
facecolor='yellow', alpha=0.7))
ax.set_title('text() - Adding Text at Specific Coordinates')
ax.set_xlabel('x')
ax.set_ylabel('sin(x)')
ax.grid(True, alpha=0.3)
plt.show()
Ejemplo 2: Anotación con flecha (annotate)
Ejemplo
import numpy as np
x = np.linspace(0, 10, 50)
y = np.exp(-x/3) * np.sin(2 * x) # Oscilación amortiguada
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
ax.plot(x, y, 'steelblue', linewidth=2, marker='o', markersize=4)
# Anota el primer pico (la flecha apunta del texto al punto de datos)
peak1_idx = np.argmax(y)
ax.annotate('1st Peak',
xy=(x[peak1_idx], y[peak1_idx]), # El punto al que apunta la flecha
xytext=(x[peak1_idx] + 1.5, y[peak1_idx] + 0.2), # Posición del texto
arrowprops=dict(arrowstyle='->',
color='red', lw=1.5),
fontsize=11, color='red', fontweight='bold')
# Anota la región de amortiguamiento
ax.annotate('Decay region',
xy=(.7, .3), xycoords='axes fraction', # Usa coordenadas de axes
xytext=(0.5, 0.8), textcoords='axes fraction',
arrowprops=dict(arrowstyle='fancy',
color='green',
connectionstyle='arc3,rad=0.3'),
fontsize=11, color='green',
bbox=dict(boxstyle='round', facecolor='wheat', alpha=0.5))
ax.set_title('annotate() - Annotations with Arrows')
ax.set_xlabel('Time (s)')
ax.set_ylabel('Amplitude')
ax.grid(True, alpha=0.3)
plt.show()
Ejemplo 3: Anotación de fórmulas y sistema de coordenadas
Ejemplo
import numpy as np
x = np.linspace(0, 4*np.pi, 200)
y1 = np.sin(x)
y2 = np.cos(x)
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
ax.plot(x, y1, 'blue', label='sin(x)')
ax.plot(x, y2, 'red', label='cos(x)')
# Anota con una fórmula matemática en una posición fija del gráfico
ax.text(0.02, 0.95,
r'$f(x) = sin(x)$',
transform=ax.transAxes, # Usa coordenadas relativas de Axes (0-1)
fontsize=14, color='blue',
verticalalignment='top',
bbox=dict(boxstyle='round', facecolor='lightblue', alpha=0.5))
ax.text(0.02, 0.82,
r'$g(x) = cos(x)$',
transform=ax.transAxes,
fontsize=14, color='red',
verticalalignment='top',
bbox=dict(boxstyle='round', facecolor='lightcoral', alpha=0.5))
ax.set_title(r'Math Formula with LaTeX: $sum_{i=1}^{n} x_i$')
ax.set_xlabel('x (radians)')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
print("ejemplo: math annotation displayed")
Preguntas frecuentes
¿Cuál es la diferencia entre text y annotate?
text()Solo coloca texto en las coordenadas especificadas, adecuado para añadir etiquetas o descripciones.
annotate()Puede añadir flechas que conectan el texto con los puntos de datos, adecuado para anotar con precisión posiciones clave.
¿Cómo usar fórmulas matemáticas en el texto?
Usa la sintaxis de LaTeX:r'$alpha + beta$'El prefijo r indica una cadena sin procesar (raw string), y el contenido dentro de $...$ se renderiza como una fórmula matemática.
Se requiere tener LaTeX instalado en el sistema o usar el motor de renderizado mathtext integrado de Matplotlib.
Otras extensiones