matplotlib.lines.Line2D #
- clase matplotlib.lines. Line2D ( xdata , ydata , * , ancho de línea = Ninguno , estilo de línea = Ninguno , color = Ninguno , gapcolor = Ninguno , marcador = Ninguno , tamaño de marcador = Ninguno , ancho de borde de marcador = Ninguno , color de borde de marcador = Ninguno , color de cara de marcador = Ninguno , color de cara de marcador = Ninguno'ninguno' , estilo de relleno = Ninguno , suavizado = Ninguno , dash_capstyle = Ninguno , solid_capstyle = Ninguno , dash_joinstyle = Ninguno , solid_joinstyle = Ninguno , pickradius = 5 , drawstyle = Ninguno , markevery = Ninguno , ** kwargs ) [fuente] #
Bases:
Artist
Una línea: la línea puede tener un estilo de línea sólido que conecta todos los vértices y un marcador en cada vértice. Además, el dibujo de la línea sólida está influenciado por el estilo de dibujo, por ejemplo, se pueden crear líneas "escalonadas" en varios estilos.
Cree una
Line2D
instancia con datos x e y en secuencias de xdata , ydata .Los argumentos de palabras clave adicionales son
Line2D
propiedades: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
Consulte
set_linestyle()
para obtener una descripción de los estilos de línea,set_marker()
una descripción de los marcadores yset_drawstyle()
una descripción de los estilos de dibujo.- contiene ( mouseevent ) [fuente] #
Pruebe si ocurrió un evento de ratón en la línea.
Se considera que un evento ha ocurrido "en" la línea si está a menos de
self.pickradius
(predeterminado: 5 puntos) de distancia de ella. Utiliceget_pickradius
oset_pickradius
para obtener o establecer el radio de selección.- Parámetros :
- evento del ratón
matplotlib.backend_bases.MouseEvent
- evento del ratón
- Devoluciones :
- contiene bool
Si hay valores dentro del radio.
- dictado de detalles
Un diccionario , donde listapuntos es una lista de puntos de la línea que están dentro del radio de selección alrededor de la posición del evento.
{'ind': pointlist}
TODO: ordenar los índices devueltos por distancia
- dibujar ( procesador ) [fuente] #
Dibuja al Artista (y sus hijos) usando el renderizador dado.
Esto no tiene efecto si el artista no está visible (
Artist.get_visible
devuelve Falso).- Parámetros :
- subclase de renderizador .
RendererBase
- subclase de renderizador .
notas
Este método se anula en las subclases de artista.
- drawStyleKeys = ['predeterminado', 'pasos-medio', 'pasos-pre', 'pasos-post', 'pasos'] #
- drawStyles = {'predeterminado': '_draw_lines', 'steps': '_draw_steps_pre', 'steps-mid': '_draw_steps_mid', 'steps-post': '_draw_steps_post', 'steps-pre': '_draw_steps_pre'} #
- fillStyles = ('completo', 'izquierda', 'derecha', 'abajo', 'arriba', 'ninguno') #
- marcadores_llenos = ('o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D' , 'd', 'P', 'X') #
- get_aa ( ) [fuente] #
Alias para
get_antialiased
.
- get_dash_capstyle ( ) [fuente] #
Devuelve el
CapStyle
para las líneas discontinuas.Ver
set_dash_capstyle
también
- get_dash_joinstyle ( ) [fuente] #
Devuelve el
JoinStyle
para las líneas discontinuas.Ver
set_dash_joinstyle
también
- get_data ( origen = Verdadero ) [fuente] #
Devuelve los datos de la línea como un par.
(xdata, ydata)
Si orig es True , devuelve los datos originales.
- get_drawstyle ( ) [fuente] #
Devuelve el estilo de dibujo.
Ver
set_drawstyle
también
- get_ds ( ) [fuente] #
Alias para
get_drawstyle
.
- get_fillstyle ( ) [fuente] #
Devuelve el estilo de relleno del marcador.
Ver
set_fillstyle
también
- get_gapcolor ( ) [fuente] #
Devuelve la línea gapcolor.
Ver
set_gapcolor
también
- get_linestyle ( ) [fuente] #
Devuelve el estilo de línea.
Ver
set_linestyle
también
- get_linewidth ( ) [fuente] #
Devuelve el ancho de línea en puntos.
Ver
set_linewidth
también
- get_ls ( ) [fuente] #
Alias para
get_linestyle
.
- get_lw ( ) [fuente] #
Alias para
get_linewidth
.
- get_marker ( ) [fuente] #
Devuelve el marcador de línea.
Ver
set_marker
también
- get_markeredgecolor ( ) [fuente] #
Devuelve el color del borde del marcador.
Ver
set_markeredgecolor
también
- get_markeredgewidth ( ) [fuente] #
Devuelve el ancho del borde del marcador en puntos.
Ver
set_markeredgewidth
también
- get_markerfacecolor ( ) [fuente] #
Devuelve el color de la cara del marcador.
Ver
set_markerfacecolor
también
- get_markerfacecoloralt ( ) [fuente] #
Devuelve el color de la cara del marcador alternativo.
Ver
set_markerfacecoloralt
también
- get_markersize ( ) [fuente] #
Devuelve el tamaño del marcador en puntos.
Ver
set_markersize
también
- get_markevery ( ) [fuente] #
Devuelve la configuración de markevery para el submuestreo de marcadores.
Ver
set_markevery
también
- get_mec ( ) [fuente] #
Alias para
get_markeredgecolor
.
- get_mew ( ) [fuente] #
Alias para
get_markeredgewidth
.
- get_mfc ( ) [fuente] #
Alias para
get_markerfacecolor
.
- get_mfcalt ( ) [fuente] #
Alias para
get_markerfacecoloralt
.
- get_ms ( ) [fuente] #
Alias para
get_markersize
.
- get_pickradius ( ) [fuente] #
Devuelve el radio de selección utilizado para las pruebas de contención.
Ver
contains
para más detalles.
- get_solid_capstyle ( ) [fuente] #
Devuelve el
CapStyle
para líneas continuas.Ver
set_solid_capstyle
también
- get_solid_joinstyle ( ) [fuente] #
Devuelve el
JoinStyle
para líneas continuas.Ver
set_solid_joinstyle
también
- get_window_extent ( procesador = Ninguno ) [fuente] #
Obtenga el cuadro delimitador del artista en el espacio de visualización.
El ancho y la altura del cuadro delimitador no son negativos.
Las subclases deben anularse para su inclusión en el cálculo "ajustado" del cuadro delimitador. El valor predeterminado es devolver un cuadro delimitador vacío en 0, 0.
Tenga cuidado al usar esta función, los resultados no se actualizarán si cambia la extensión de la ventana del artista. La extensión puede cambiar debido a cualquier cambio en la pila de transformación, como cambiar los límites de los ejes, el tamaño de la figura o el lienzo utilizado (como se hace al guardar una figura). Esto puede provocar un comportamiento inesperado en el que las figuras interactivas se verán bien en la pantalla, pero se guardarán incorrectamente.
- get_xdata ( origen = Verdadero ) [fuente] #
Devuelve los datos x.
Si orig es True , devuelve los datos originales, de lo contrario, los datos procesados.
- get_ydata ( origen = Verdadero ) [fuente] #
Devuelve los datos y.
Si orig es True , devuelve los datos originales, de lo contrario, los datos procesados.
- es_discontinua ( ) [fuente] #
Devuelve si la línea tiene un estilo de línea discontinua.
Se supone que un estilo de línea personalizado tiene guiones, no lo inspeccionamos
onoffseq
directamente.Ver
set_linestyle
también
- lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted' , 'Ninguno': '_dibujar_nada'} #
- marcadores = {'.': 'punto', ',': 'píxel', 'o': 'círculo', 'v': 'triángulo_abajo', '^': 'triángulo_arriba', '<': 'triángulo_izquierda' , '>': 'triángulo_derecha', '1': 'tri_abajo', '2': 'tri_arriba', '3': 'tri_izquierda', '4': 'tri_derecha', '8': 'octágono', ' s': 'cuadrado', 'p': 'pentágono', '*': 'estrella','h': 'hexágono1', 'H': 'hexágono2', '+': 'más', 'x': 'x', 'D': 'diamante', 'd': 'thin_diamond', '|': 'vline', '_': 'hline', 'P': 'plus_filled', 'X': 'x_filled', 0: 'tickleft', 1: 'tickright ', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase', 10: 'base de atención', 11: 'base de atención', 'Ninguno': 'nada', 'ninguno': 'nada', '' ': 'nada', '': 'nada'} #
- propiedad pickradius #
Devuelve el radio de selección utilizado para las pruebas de contención.
Ver
contains
para más detalles.
- set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation =<UNSET> , antialiased=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET > , dash_capstyle=<UNSET> , dash_joinstyle=<UNSET> , guiones=<UNSET> , data=<UNSET> , drawstyle=<UNSET> , fillstyle=<UNSET> , gapcolor=<UNSET> , gid=<UNSET> , in_layout=<DESCONFIGURAR> ,etiqueta=<DESCONFIGURADO> ,linestyle=<UNSET> , linewidth=<UNSET> , marker=<UNSET> , markeredgecolor=<UNSET> , markeredgewidth=<UNSET> , markerfacecolor=<UNSET> , markerfacecoloralt=<UNSET> , markersize=<UNSET> , markevery= <UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , pickradius=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , solid_capstyle=<UNSET > ,solid_joinstyle=<UNSET> ,transform=<UNSET> , url=<UNSET> , visible=<UNSET> , xdata=<UNSET> , ydata=<UNSET> , zorder=<UNSET> ) [fuente] #
Establece varias propiedades a la vez.
Las propiedades admitidas son
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
bool
bool
Parchear o (Ruta, Transformar) o Ninguno
color
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
{'predeterminado', 'pasos', 'pasos-pre', 'pasos-medio', 'pasos-post'}, predeterminado: 'predeterminado'
{'completo', 'izquierda', 'derecha', 'abajo', 'arriba', 'ninguno'}
color o ninguno
calle
bool
objeto
{'-', '--', '-.', ':', '', (desplazamiento, on-off-seq), ...}
flotar
cadena de estilo de marcador,
Path
oMarkerStyle
color
flotar
color
color
flotar
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
- set_aa ( b ) [fuente] #
Alias para
set_antialiased
.
- set_antialiased ( b ) [fuente] #
Establezca si desea utilizar el renderizado suavizado.
- Parámetros :
- b bool
- set_dash_capstyle ( s ) [fuente] #
Cómo dibujar las tapas de los extremos si la línea es
is_dashed
.El capstyle predeterminado es
rcParams["lines.dash_capstyle"]
(predeterminado: ).<CapStyle.butt: 'butt'>
- Parámetros :
- s
CapStyle
o {'trasero', 'proyectando', 'redondo'}
- s
- set_dash_joinstyle ( s ) [fuente] #
Cómo unir segmentos de la línea si
is_dashed
.El estilo de combinación predeterminado es
rcParams["lines.dash_joinstyle"]
(predeterminado: ).<JoinStyle.round: 'round'>
- Parámetros :
- s
JoinStyle
o {'inglete', 'redondo', 'bisel'}
- s
- set_dashes ( siguiente ) [fuente] #
Establezca la secuencia de guiones.
La secuencia de guiones es una secuencia de flotantes de longitud uniforme que describe la longitud de guiones y espacios en puntos.
Por ejemplo, (5, 2, 1, 2) describe una secuencia de guiones de 5 puntos y 1 punto separados por espacios de 2 puntos.
Consulte también
set_gapcolor
, que permite rellenar esos espacios con un color.- Parámetros :
- Secuencia secuencial de flotadores (tinta de encendido/apagado en puntos) o (Ninguno, Ninguno)
Si seq está vacío o , el estilo de línea se establecerá en sólido.
(None, None)
- set_data ( * argumentos ) [fuente] #
Establezca los datos x e y.
- Parámetros :
- matriz *args (2, N) o dos matrices 1D
- set_drawstyle ( estilo de dibujo ) [fuente] #
Establezca el estilo de dibujo de la trama.
El estilo de dibujo determina cómo se conectan los puntos.
- Parámetros :
- estilo de dibujo {'predeterminado', 'pasos', 'pasos-pre', 'pasos-medio', 'pasos-post'}, predeterminado: 'predeterminado'
Para 'predeterminado', los puntos están conectados con líneas rectas.
Las variantes de escalones conectan los puntos con líneas escalonadas, es decir, líneas horizontales con escalones verticales. Se diferencian en la ubicación del paso:
'steps-pre': El paso está al comienzo del segmento de línea, es decir, la línea estará en el valor y del punto a la derecha.
'steps-mid': El paso está a mitad de camino entre los puntos.
'steps-post: El paso está al final del segmento de línea, es decir, la línea estará en el valor y del punto a la izquierda.
'steps' es igual a 'steps-pre' y se mantiene por compatibilidad con versiones anteriores.
Para ver ejemplos, consulte la demostración de pasos .
- set_ds ( estilo de dibujo ) [fuente] #
Alias para
set_drawstyle
.
- set_fillstyle ( fs ) [fuente] #
Establezca el estilo de relleno del marcador.
- Parámetros :
- fs {'completo', 'izquierda', 'derecha', 'abajo', 'arriba', 'ninguno'}
Valores posibles:
'full': llena todo el marcador con el color de la cara del marcador .
'izquierda', 'derecha', 'abajo', 'arriba': Rellene la mitad del marcador en el lado dado con el color de la cara del marcador . La otra mitad del marcador se rellena con markerfacecoloralt .
'ninguno': Sin relleno.
Para ver ejemplos, consulte Estilos de relleno de marcador .
- set_gapcolor ( gapcolor ) [fuente] #
Establezca un color para llenar los espacios en el estilo de línea discontinua.
Nota
Las líneas rayadas se crean dibujando dos líneas discontinuas intercaladas. Puede haber superposiciones entre esos dos, lo que puede resultar en artefactos al usar transparencia.
Esta funcionalidad es experimental y puede cambiar.
- Parámetros :
- color gapcolor o ninguno
El color con el que rellenar los huecos. Si es Ninguno, los espacios no se llenan.
- set_linestyle ( ls ) [fuente] #
Establezca el estilo de línea de la línea.
- Parámetros :
- ls {'-', '--', '-.', ':', '', (desplazamiento, on-off-seq), ...}
Valores posibles:
Una cuerda:
estilo de línea
descripción
'-'
o'solid'
línea sólida
'--'
o'dashed'
Linea discontinua
'-.'
o'dashdot'
línea punteada
':'
o'dotted'
linea punteada
'none'
,'None'
, o' '
''
dibujar nada
Alternativamente, se puede proporcionar una tupla de guiones de la siguiente forma:
(offset, onoffseq)
donde
onoffseq
es una tupla de longitud uniforme de entrada y salida de tinta en puntos. Verset_dashes()
también
Para ver ejemplos, consulte Estilos de línea .
- set_linewidth ( w ) [fuente] #
Establezca el ancho de línea en puntos.
- Parámetros :
- flotar _
Ancho de línea, en puntos.
- set_ls ( ls ) [fuente] #
Alias para
set_linestyle
.
- set_lw ( w ) [fuente] #
Alias para
set_linewidth
.
- set_marker ( marcador ) [fuente] #
Establecer el marcador de línea.
- Parámetros :
- cadena de estilo de marcador de marcador, o
Path
MarkerStyle
Consulte
markers
la descripción completa de los posibles argumentos.
- cadena de estilo de marcador de marcador, o
- set_markeredgecolor ( ec ) [fuente] #
Establezca el color del borde del marcador.
- Parámetros :
- color ce
- set_markeredgewidth ( nuevo ) [fuente] #
Establezca el ancho del borde del marcador en puntos.
- Parámetros :
- nuevo flotador
Ancho del borde del marcador, en puntos.
- set_markerfacecolor ( fc ) [fuente] #
Establezca el color de la cara del marcador.
- Parámetros :
- color f.c.
- set_markerfacecoloralt ( fc ) [fuente] #
Establezca el color de la cara del marcador alternativo.
- Parámetros :
- color f.c.
- set_markersize ( sz ) [fuente] #
Establezca el tamaño del marcador en puntos.
- Parámetros :
- tamaño flotante
Tamaño del marcador, en puntos.
- set_markevery ( cada ) [fuente] #
Establezca la propiedad markevery para submuestrear el gráfico cuando use marcadores.
por ejemplo, si
every=5
, se trazará cada 5-th marcador.- Parámetros :
- cada Ninguno o int o (int, int) o rebanada o list[int] o float o (float, float) o list[bool]
Qué marcadores trazar.
every=None
: cada punto será trazado.every=N
: cada N-ésimo marcador se trazará comenzando con el marcador 0.every=(start, N)
: se trazará cada N-ésimo marcador, comenzando por index start .every=slice(start, end, N)
: se trazará cada N-ésimo marcador, desde el inicio del índice hasta el final del índice, pero sin incluirlo .every=[i, j, m, ...]
: solo se trazarán los marcadores en los índices dados.every=[True, False, True, ...]
: solo se trazarán las posiciones que sean verdaderas. La lista debe tener la misma longitud que los puntos de datos.every=0.1
, (es decir, un flotador): los marcadores estarán espaciados a distancias visuales aproximadamente iguales a lo largo de la línea; la distancia a lo largo de la línea entre los marcadores se determina multiplicando la distancia de las coordenadas de visualización de la diagonal del cuadro delimitador de los ejes por el valor de cada .every=(0.5, 0.1)
(es decir, una tupla de flotador de longitud 2): similar aevery=0.1
pero el primer marcador se desplazará a lo largo de la línea por 0,5 multiplicado por la distancia diagonal de las coordenadas de visualización a lo largo de la línea.
Para ver ejemplos, consulte la demostración de Markevery .
notas
La configuración de markevery solo dibujará marcadores en los puntos de datos reales. Si bien la forma de argumento flotante apunta a un espaciado visual uniforme, tiene que forzar desde el espaciado ideal hasta el punto de datos disponible más cercano. Según el número y la distribución de los puntos de datos, es posible que el resultado aún no se vea espaciado uniformemente.
Cuando se utiliza un desplazamiento de inicio para especificar el primer marcador, el desplazamiento será desde el primer punto de datos que puede ser diferente del primer punto de datos visible si se amplía la gráfica.
Si hace zoom en una gráfica cuando usa argumentos flotantes, los puntos de datos reales que tienen marcadores cambiarán porque la distancia entre los marcadores siempre se determina a partir de las coordenadas de visualización, ejes, delimitación, cuadro, diagonal, independientemente de los límites de datos de los ejes reales.
- set_mec ( ec ) [fuente] #
Alias para
set_markeredgecolor
.
- set_mew ( nuevo ) [fuente] #
Alias para
set_markeredgewidth
.
- set_mfc ( fc ) [fuente] #
Alias para
set_markerfacecolor
.
- set_mfcalt ( fc ) [fuente] #
Alias para
set_markerfacecoloralt
.
- set_ms ( tamaño ) [fuente] #
Alias para
set_markersize
.
- set_picker ( p ) [fuente] #
Configure los detalles del selector de eventos para la línea.
- Parámetros :
- p float o invocable[[Artista, Evento], tupla[bool, dict]]
Si es flotante, se utiliza como radio de selección en puntos.
- set_pickradius ( pickradius ) [fuente] #
Establezca el radio de selección utilizado para las pruebas de contención.
Ver
contains
para más detalles.- Parámetros :
- flotador de radio de pico
Pick radio, en puntos.
- set_solid_capstyle ( s ) [fuente] #
Cómo dibujar las tapas de los extremos si la línea es sólida (no
is_dashed
)El capstyle predeterminado es
rcParams["lines.solid_capstyle"]
(predeterminado: ).<CapStyle.projecting: 'projecting'>
- Parámetros :
- s
CapStyle
o {'trasero', 'proyectando', 'redondo'}
- s
- set_solid_joinstyle ( s ) [fuente] #
Cómo unir segmentos si la línea es continua (no
is_dashed
).El estilo de combinación predeterminado es
rcParams["lines.solid_joinstyle"]
(predeterminado: ).<JoinStyle.round: 'round'>
- Parámetros :
- s
JoinStyle
o {'inglete', 'redondo', 'bisel'}
- s
- orden = 2 #
Ejemplos usando matplotlib.lines.Line2D
#
Personalización de estilos de línea discontinua
Etiquetas de figuras: suptitle, supxlabel, supylabel
Etiqueta de ángulo invariable de escala
Componer leyendas personalizadas
Referencia de estilo de flecha de anotación
Demostración de la leyenda de la figura
Referencia para artistas de Matplotlib
Precios de las acciones durante 32 años
Elija una demostración de evento
Establecer y obtener propiedades
Diagrama SkewT-logP: uso de transformaciones y proyecciones personalizadas
Formateador de ticks personalizado para series temporales
Umbral de una imagen con RangeSlider
Ajuste de controles deslizantes a valores discretos
Renderizado más rápido usando blitting