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ámetroTipoDescripción
*argsArgumentos variablesAdmite varias formas de llamada: plot(y), plot(x, y), plot(x, y, 'fmt'), plot(x1, y1, 'fmt1', x2, y2, 'fmt2', ...)
scalex / scaleyboolIndica si se escalan automáticamente los ejes x/y para ajustarse a los datos; el valor predeterminado es True.
dataObjeto indexableSi se proporciona, se pueden usar cadenas como argumentos para referenciar las columnas de datos.
color o ccolorColor de la línea, como 'red', '#ff0000', 'tab:blue'
linestyle o lsstrEstilo de línea: '-' (sólida), '--' (discontinua), '-.' (punto y raya), ':' (punteada), '' (sin línea)
linewidth o lwfloatAncho de línea, por defecto aproximadamente 1.5
markerstrMarcadores de puntos de datos: '.', 'o', 's', '^', '*', '+' (signo más), 'x', etc.
markersize o msfloatTamaño del marcador
labelstrEtiqueta de leyenda, usada junto con legend().
alphafloatTransparencia, de 0 (totalmente transparente) a 1 (totalmente opaco).
zorderfloatOrden 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ácterColorCarácterColor
'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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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.


Documentación de referencia de Matplotlib

Otras extensiones