Función Matplotlib text() / annotate()


Matplotlib 参考文档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ámetroDescripción
x, yCoordenadas de posición del texto
sCadena de texto a mostrar
fontsizeTamaño de fuente
colorColor del texto
ha / horizontalalignmentAlineación horizontal: 'center', 'right', 'left'
va / verticalalignmentAlineación vertical: 'center', 'top', 'bottom', 'baseline'
rotationÁngulo de rotación (en grados)
fontweightPeso de la fuente: 'normal', 'bold', 'light'
bboxPropiedades del cuadro de fondo del texto, como dict(facecolor='yellow', alpha=0.5)

Parámetros específicos de annotate()

ParámetroDescripción
textContenido del texto de anotación
xyCoordenadas del punto objetivo señalado (x, y) (punta de la flecha)
xytextCoordenadas de la posición donde se coloca el texto. Por defecto None (el texto se coloca en la posición xy)
xycoords / textcoordsSistema de coordenadas de xy / xytext: 'data', 'axes fraction', 'figure fraction', 'offset points', etc.
arrowpropsDiccionario 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

EstiloEfecto
'->'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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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='-&gt;',
                            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 matplotlib.pyplot as plt
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.


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

Otras extensiones