matplotlib.pyplot.plot #
- matplotlib.pyplot. plot ( * args , scalex = True , scaley = True , data = None , ** kwargs ) [fuente] #
Trace y contra x como líneas y/o marcadores.
Firmas de llamada:
plot([x], y, [fmt], *, data=None, **kwargs) plot([x], y, [fmt], [x2], y2, [fmt2], ..., **kwargs)
Las coordenadas de los puntos o nodos de línea están dadas por x , y .
El parámetro opcional fmt es una forma conveniente de definir formatos básicos como color, marcador y estilo de línea. Es una notación de cadena de método abreviado que se describe en la sección Notas a continuación.
>>> plot(x, y) # plot x and y using default line style and color >>> plot(x, y, 'bo') # plot x and y using blue circle markers >>> plot(y) # plot y using x as index array 0..N-1 >>> plot(y, 'r+') # ditto, but with red plusses
Puede usar
Line2D
propiedades como argumentos de palabras clave para tener más control sobre la apariencia. Las propiedades de línea y fmt se pueden mezclar. Las dos llamadas siguientes producen resultados idénticos:>>> plot(x, y, 'go--', linewidth=2, markersize=12) >>> plot(x, y, color='green', marker='o', linestyle='dashed', ... linewidth=2, markersize=12)
Cuando entra en conflicto con fmt , los argumentos de palabras clave tienen prioridad.
Trazado de datos etiquetados
Hay una forma conveniente de trazar objetos con datos etiquetados (es decir, datos a los que se puede acceder mediante index
obj['y']
). En lugar de dar los datos en x e y , puede proporcionar el objeto en el parámetro de datos y simplemente dar las etiquetas para x e y :>>> plot('xlabel', 'ylabel', data=obj)
Todos los objetos indexables son compatibles. Esto podría ser, por ejemplo, un
dict
, unpandas.DataFrame
o una matriz numpy estructurada.Trazado de varios conjuntos de datos
Hay varias formas de trazar múltiples conjuntos de datos.
La forma más sencilla es simplemente llamar
plot
varias veces. Ejemplo:>>> plot(x1, y1, 'bo') >>> plot(x2, y2, 'go')
Si x y/ oy son matrices 2D, se dibujará un conjunto de datos separado para cada columna. Si tanto x como y son 2D, deben tener la misma forma. Si solo uno de ellos es 2D con forma (N, m), el otro debe tener una longitud N y se utilizará para cada conjunto de datos m.
Ejemplo:
>>> x = [1, 2, 3] >>> y = np.array([[1, 2], [3, 4], [5, 6]]) >>> plot(x, y)
es equivalente a:
>>> for col in range(y.shape[1]): ... plot(x, y[:, col])
La tercera forma es especificar múltiples conjuntos de grupos [x] , y , [fmt] :
>>> plot(x1, y1, 'g^', x2, y2, 'g-')
En este caso, cualquier argumento de palabra clave adicional se aplica a todos los conjuntos de datos. Además, esta sintaxis no se puede combinar con el parámetro de datos .
Por defecto, a cada línea se le asigna un estilo diferente especificado por un 'ciclo de estilo'. Los parámetros de propiedad fmt y line solo son necesarios si desea desviaciones explícitas de estos valores predeterminados. Alternativamente, también puede cambiar el ciclo de estilo usando
rcParams["axes.prop_cycle"]
(predeterminado: ).cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])
- Parámetros :
- x, y en forma de matriz o escalar
Las coordenadas horizontales/verticales de los puntos de datos. Los valores x
range(len(y))
son opcionales y predeterminados a .Comúnmente, estos parámetros son matrices 1D.
También pueden ser escalares o bidimensionales (en ese caso, las columnas representan conjuntos de datos separados).
Estos argumentos no se pueden pasar como palabras clave.
- fmt str, opcional
Una cadena de formato, por ejemplo, 'ro' para círculos rojos. Consulte la sección Notas para obtener una descripción completa de las cadenas de formato.
Las cadenas de formato son solo una abreviatura para establecer rápidamente las propiedades de línea básicas. Todos estos y más también se pueden controlar mediante argumentos de palabras clave.
Este argumento no se puede pasar como palabra clave.
- objeto indexable de datos , opcional
Un objeto con datos etiquetados. Si se proporciona, proporcione los nombres de las etiquetas para trazar en x e y .
Nota
Técnicamente, existe una ligera ambigüedad en las llamadas en las que la segunda etiqueta es un fmt válido . podría ser o . En tales casos, se elige la primera interpretación, pero se emite una advertencia. Puede suprimir la advertencia agregando una cadena de formato vacía .
plot('n', 'o', data=obj)
plt(x, y)
plt(y, fmt)
plot('n', 'o', '', data=obj)
- Devoluciones :
- lista de
Line2D
Una lista de líneas que representan los datos graficados.
- lista de
- Otros parámetros :
- scalex, scaley bool, por defecto: Verdadero
Estos parámetros determinan si los límites de visualización se adaptan a los límites de datos. Los valores se pasan a
autoscale_view
.- **propiedades de kwargs
Line2D
, opcional kwargs se utilizan para especificar propiedades como una etiqueta de línea (para leyendas automáticas), ancho de línea, antialiasing, color de cara de marcador. Ejemplo:
>>> plot([1, 2, 3], [1, 2, 3], 'go-', label='line 1', linewidth=2) >>> plot([1, 2, 3], [1, 4, 9], 'rs', label='line 2')
Si especifica varias líneas con una llamada de trama, los kwargs se aplican a todas esas líneas. En caso de que el objeto de etiqueta sea iterable, cada elemento se usa como etiquetas para cada conjunto de datos.
Aquí hay una lista de
Line2D
propiedades disponibles:Propiedad
Descripción
una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
escalar o ninguno
bool
antialiased
o unobool
bool
Parchear o (Ruta, Transformar) o Ninguno
color
o ccolor
CapStyle
o {'trasero', 'proyectando', 'redondo'}JoinStyle
o {'inglete', 'redondo', 'bisel'}secuencia de flotadores (tinta de encendido/apagado en puntos) o (Ninguno, Ninguno)
(2, N) matriz o dos matrices 1D
drawstyle
o ds{'predeterminado', 'pasos', 'pasos-pre', 'pasos-medio', 'pasos-post'}, predeterminado: 'predeterminado'
{'completo', 'izquierda', 'derecha', 'abajo', 'arriba', 'ninguno'}
color o ninguno
calle
bool
objeto
linestyle
o ls{'-', '--', '-.', ':', '', (desplazamiento, on-off-seq), ...}
linewidth
o bajoflotar
cadena de estilo de marcador,
Path
oMarkerStyle
markeredgecolor
o meccolor
markeredgewidth
o maullarflotar
markerfacecolor
o mfccolor
markerfacecoloralt
o mfcaltcolor
markersize
o másflotar
Ninguno o int o (int, int) o rebanada o list[int] o float o (float, float) o list[bool]
bool
float o invocable[[Artista, Evento], tupla[bool, dict]]
desconocido
bool
(escala: flotante, longitud: flotante, aleatoriedad: flotante)
booleano o ninguno
CapStyle
o {'trasero', 'proyectando', 'redondo'}JoinStyle
o {'inglete', 'redondo', 'bisel'}desconocido
calle
bool
matriz 1D
matriz 1D
flotar
Ver también
scatter
Gráfico de dispersión XY con marcadores de diferentes tamaños y/o colores (a veces también llamado gráfico de burbujas).
notas
Cadenas de formato
Una cadena de formato consta de una parte para el color, el marcador y la línea:
fmt = '[marker][line][color]'
Cada uno de ellos es opcional. Si no se proporciona, se utiliza el valor del ciclo de estilo. Excepción: si
line
se da, pero nomarker
, los datos serán una línea sin marcadores.También se admiten otras combinaciones
[color][marker][line]
, pero tenga en cuenta que su análisis puede ser ambiguo.marcadores
personaje
descripción
'.'
marcador de puntos
','
marcador de píxeles
'o'
marcador circular
'v'
marcador de triángulo_abajo
'^'
marcador de triángulo_arriba
'<'
marcador triángulo_izquierda
'>'
marcador triángulo_derecha
'1'
marcador tri_down
'2'
marcador tri_up
'3'
marcador tri_left
'4'
marcador tri_right
'8'
marcador de octágono
's'
marcador cuadrado
'p'
marcador del pentágono
'P'
marcador más (relleno)
'*'
marcador de estrella
'h'
marcador hexagonal1
'H'
marcador hexagonal2
'+'
más marcador
'x'
x marcador
'X'
marcador x (relleno)
'D'
marcador de diamantes
'd'
marcador de diamante delgado
'|'
marcador de línea v
'_'
marcador de línea h
Estilos de línea
personaje
descripción
'-'
estilo de línea sólida
'--'
estilo de línea discontinua
'-.'
estilo de línea de puntos y guiones
':'
estilo de línea punteada
Cadenas de formato de ejemplo:
'b' # blue markers with default shape 'or' # red circles '-g' # green solid line '--' # dashed line with default color '^k:' # black triangle_up markers connected by a dotted line
Colores
Las abreviaturas de color admitidas son los códigos de una sola letra
personaje
color
'b'
azul
'g'
verde
'r'
rojo
'c'
cian
'm'
magenta
'y'
amarillo
'k'
negro
'w'
blanco
y los
'CN'
colores que se indexan en el ciclo de propiedades predeterminado.Si el color es la única parte de la cadena de formato, también puede usar cualquier
matplotlib.colors
especificación, por ejemplo, nombres completos ('green'
) o cadenas hexadecimales ('#008000'
).
Ejemplos usando matplotlib.pyplot.plot
#
Trazado de valores enmascarados y NaN
Subclases de figuras personalizadas
Administrar múltiples figuras en pyplot
Controlando el estilo de texto y etiquetas usando un diccionario
Hoja de estilo de luz solarizada
Establecer y obtener propiedades
Colocación de marcas de fecha usando reglas de recurrencia
Rotación de etiquetas de marca personalizadas
Personalización de Matplotlib con hojas de estilo y rcParams