Función plot() de Matplotlib
Documentación de referencia de Matplotlib
plot()Es la función más central de Matplotlib, utilizada para dibujar gráficos de líneas.
Crea líneas conectando los puntos de coordenadas x e y dados, y admite personalizar color, estilo de línea, marcadores y ancho de línea.
Definición de la función
Interfaz pyplot
matplotlib.pyplot.plot(*args, scalex=True, scaley=True, data=None, **kwargs)
Interfaz de Axes
Axes.plot(*args, scalex=True, scaley=True, data=None, **kwargs)
Descripción de parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| *args | Argumentos variables | Admite varias formas de llamada: plot(y), plot(x, y), plot(x, y, 'fmt'), plot(x1, y1, 'fmt1', x2, y2, 'fmt2', ...) |
| scalex / scaley | bool | Indica si se escalan automáticamente los ejes x/y para ajustarse a los datos; el valor predeterminado es True. |
| data | Objeto indexable | Si se proporciona, se pueden usar cadenas como argumentos para referenciar las columnas de datos. |
| color o c | color | Color de la línea, como 'red', '#ff0000', 'tab:blue' |
| linestyle o ls | str | Estilo de línea: '-' (sólida), '--' (discontinua), '-.' (punto y raya), ':' (punteada), '' (sin línea) |
| linewidth o lw | float | Ancho de línea, por defecto aproximadamente 1.5 |
| marker | str | Marcadores de puntos de datos: '.', 'o', 's', '^', '*', '+' (signo más), 'x', etc. |
| markersize o ms | float | Tamaño del marcador |
| label | str | Etiqueta de leyenda, usada junto con legend(). |
| alpha | float | Transparencia, de 0 (totalmente transparente) a 1 (totalmente opaco). |
| zorder | float | Orden de capa; cuanto mayor sea el valor, más arriba estará. |
La cadena de formato fmt consta de tres partes:
'[color][marcador][tipo de línea]', como'ro--'indica color rojo, marcador de punto y línea discontinua. El orden de las partes se puede disponer libremente.
Abreviaturas de colores comunes
| Carácter | Color | Carácter | Color |
|---|---|---|---|
| 'b' | Azul (blue) | 'r' | Rojo (red) |
| 'g' | Verde (green) | 'c' | Cian (cyan) |
| 'm' | Magenta (magenta) | 'y' | Amarillo (yellow) |
| 'k' | Negro (black) | 'w' | Blanco (white) |
Ejemplos de uso
Ejemplo 1: El gráfico de líneas más simple
Solo se pasan los valores de y; x usa automáticamente índices comenzando desde 0.
Ejemplo
import numpy as np
# Genera 50 puntos de datos entre 0 y 10
x = np.linspace(0, 10, 50)
y = np.sin(x) # Función seno
# La llamada más simple: x, y
plt.plot(x, y)
plt.title('Simple Line Plot')
plt.xlabel('x')
plt.ylabel('sin(x)')
plt.grid(True, alpha=0.3)
plt.show()
Ejemplo 2: Múltiples curvas + cadena de formato
Dibuja múltiples curvas en el mismo gráfico, usando diferentes colores, estilos de línea y marcadores.
Ejemplo
import numpy as np
x = np.linspace(0, 10, 50)
y1 = np.sin(x)
y2 = np.cos(x)
y3 = np.sin(x) * np.exp(-x / 3) # Seno amortiguado
# Múltiples curvas, cada una con un formato diferente
plt.plot(x, y1, 'b-o', label='sin(x)') # Línea sólida azul + puntos
plt.plot(x, y2, 'r--s', label='cos(x)') # Línea discontinua roja + cuadrados
plt.plot(x, y3, 'g-.^', label='damped sin(x)') # Línea de punto y raya verde + triángulos
plt.title('Multiple Lines with Different Styles')
plt.xlabel('x')
plt.ylabel('y')
plt.legend()
plt.grid(True, alpha=0.3)
plt.show()
Ejemplo 3: Personalizar estilos con argumentos de palabra clave
Usar argumentos de palabra clave controla con más precisión la apariencia de la línea.
Ejemplo
import numpy as np
x = np.linspace(0, 2 * np.pi, 100)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Usar argumentos de palabra clave en lugar de la cadena de formato, más legible
ax.plot(x, np.sin(x),
color='steelblue', # Nombre del color
linestyle='-', # Línea sólida
linewidth=2.5, # Ancho de línea
marker='o', # Marcador de punto
markersize=4, # Tamaño del marcador
markerfacecolor='red', # Color de relleno del marcador
markeredgecolor='black', # Color del borde del marcador
markeredgewidth=0.5, # Ancho del borde del marcador
alpha=0.8, # Transparencia general
label='sin(x)')
# Comparación: línea discontinua sin marcadores
ax.plot(x, np.cos(x),
color='#ff6600', # Color hexadecimal
linestyle='--',
linewidth=2,
label='cos(x)')
ax.set_title('Customized Line Styles', fontsize=14)
ax.set_xlabel('x (radians)')
ax.set_ylabel('Amplitude')
ax.legend(loc='upper right')
ax.grid(True, alpha=0.2)
plt.show()
print("ejemplo: customized plot displayed")
Ejemplo 4: Usar el parámetro data (compatible con DataFrame)
Cuando los datos son un dict o un DataFrame de pandas, se pueden usar nombres de columna como cadenas.
Ejemplo
import numpy as np
# Organizar los datos como diccionario
data = {
'time': np.arange(0, 10, 0.5),
'voltage': np.sin(np.arange(0, 10, 0.5)) * 5 + 10,
'current': np.cos(np.arange(0, 10, 0.5)) * 2 + 5,
}
fig, ax = plt.subplots(layout='constrained')
# Referenciar los datos mediante el parámetro data + nombres de columna como cadenas
ax.plot('time', 'voltage', 'b-', data=data, label='Voltage (V)')
ax.plot('time', 'current', 'r--', data=data, label='Current (A)')
ax.set_title('Using data Parameter with Column Names')
ax.set_xlabel('Time (s)')
ax.set_ylabel('Value')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Ejemplo 5: Llamar sobre el objeto Axes (método recomendado)
Usar la interfaz orientada a objetos de Axes es más claro en escenarios con múltiples subtramas.
Ejemplo
import numpy as np
x = np.linspace(0, 10, 100)
# Crear dos subtramas lado a lado
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
layout='constrained')
# Subtrama izquierda: función matemática
ax1.plot(x, np.sin(x), label='sin(x)')
ax1.plot(x, np.cos(x), label='cos(x)')
ax1.set_title('Math Functions')
ax1.legend()
ax1.grid(True, alpha=0.3)
# Subtrama derecha: tendencia de datos
data = np.random.randn(100).cumsum() # Caminata aleatoria
ax2.plot(data, color='teal', linewidth=1.5)
ax2.set_title('Random Walk (cumulative sum)')
ax2.set_xlabel('Step')
ax2.set_ylabel('Position')
ax2.grid(True, alpha=0.3)
plt.show()
Preguntas frecuentes
El orden de x e y en plot()
La llamada estándar esplot(x, y), x primero, y después.
Si solo se pasa un array, comoplot(y), entonces x toma automáticamenterange(0, len(y))。
¿Cómo dibujar segmentos de línea discontinuos?
Para datos que contienen NaN, plot() corta automáticamente el segmento en NaN, lo que se puede usar para dibujar líneas segmentadas.
¿Se pueden usar la cadena fmt y los argumentos de palabra clave a la vez?
Sí, los argumentos de palabra clave sobrescriben los ajustes correspondientes de la cadena fmt. Por ejemploplot(x, y, 'ro', color='blue')en, marker='o' proviene de fmt, pero color se sobrescribirá a blue.
Otras extensiones