matplotlib.lines.Line2D #
- classe matplotlib.lines. Line2D ( xdata , ydata , * , linewidth = Nenhum , estilo de linha = Nenhum , color = Nenhum , gapcolor = Nenhum , marcador = Nenhum , markersize = Nenhum , marcadoredgewidth = Nenhum , marcadoredgecolor = Nenhum , marcadorfacecolor = Nenhum , marcadorfacecoloralt ='none' , fillstyle = Nenhum , antialiased = Nenhum , dash_capstyle = Nenhum , solid_capstyle = Nenhum , dash_joinstyle = Nenhum , solid_joinstyle = Nenhum , pickradius = 5 , drawstyle = Nenhum , markevery = Nenhum , ** kwargs ) [source] #
Bases:
ArtistUma linha - a linha pode ter um estilo de linha sólido conectando todos os vértices e um marcador em cada vértice. Além disso, o desenho da linha sólida é influenciado pelo estilo de desenho, por exemplo, pode-se criar linhas "escalonadas" em vários estilos.
Crie uma
Line2Dinstância com dados x e y em sequências de xdata , ydata .Argumentos de palavras-chave adicionais são
Line2Dpropriedades:Propriedade
Descrição
uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
escalar ou nenhum
bool
antialiasedou aabool
bool
Patch ou (Caminho, Transformação) ou Nenhum
colorou ccor
CapStyleou {'bunda', 'projetando', 'redondo'}JoinStyleou {'esquadria', 'redondo', 'chanfrado'}sequência de flutuações (on/off ink em pontos) ou (None, None)
(2, N) array ou dois arrays 1D
drawstyleou ds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
{'completo', 'esquerda', 'direita', 'inferior', 'superior', 'nenhum'}
cor ou nenhum
str
bool
objeto
linestyleou ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidthou lwflutuador
string de estilo de marcador,
PathouMarkerStylemarkeredgecolorou meccor
markeredgewidthou miarflutuador
markerfacecolorou mfccor
markerfacecoloraltou mfcaltcor
markersizeou senhoraflutuador
None ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
bool
float ou callable[[Artist, Event], tuple[bool, dict]]
desconhecido
bool
(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
bool ou nenhum
CapStyleou {'bunda', 'projetando', 'redondo'}JoinStyleou {'esquadria', 'redondo', 'chanfrado'}desconhecido
str
bool
matriz 1D
matriz 1D
flutuador
Consulte
set_linestyle()para obter uma descrição dos estilos de linha,set_marker()para obter uma descrição dos marcadores eset_drawstyle()para obter uma descrição dos estilos de desenho.- contém ( evento do mouse ) [fonte] #
Teste se mouseevent ocorreu na linha.
Considera-se que um evento ocorreu "na" linha se estiver a menos de
self.pickradius(padrão: 5 pontos) dela. Useget_pickradiusouset_pickradiuspara obter ou definir o raio de seleção.- Parâmetros :
- evento do mouse
matplotlib.backend_bases.MouseEvent
- evento do mouse
- Devoluções :
- contém bool
Se algum valor está dentro do raio.
- detalhes do ditado
Um dicionário , onde pointlist é uma lista de pontos da linha que estão dentro do pickradius em torno da posição do evento.
{'ind': pointlist}TODO: classificar índices retornados por distância
- desenhar ( renderizador ) [fonte] #
Desenhe o Artista (e seus filhos) usando o renderizador fornecido.
Isso não tem efeito se o artista não estiver visível (
Artist.get_visibleretorna False).- Parâmetros :
- subclasse do renderizador .
RendererBase
- subclasse do renderizador .
Notas
Este método é substituído nas subclasses Artist.
- drawStyleKeys = ['default', 'steps-mid', 'steps-pre', 'steps-post', 'steps'] #
- drawStyles = {'default': '_draw_lines', 'steps': '_draw_steps_pre', 'steps-mid': '_draw_steps_mid', 'steps-post': '_draw_steps_post', 'steps-pre': '_draw_steps_pre'} #
- fillStyles = ('completo', 'esquerda', 'direita', 'inferior', 'superior', 'nenhum') #
- marcadores_preenchidos = ('o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D' , 'd', 'P', 'X') #
- get_aa ( ) [fonte] #
Alias para
get_antialiased.
- get_dash_capstyle ( ) [fonte] #
Retorna as
CapStylelinhas tracejadas.Veja também
set_dash_capstyle.
- get_dash_joinstyle ( ) [fonte] #
Retorna as
JoinStylelinhas tracejadas.Veja também
set_dash_joinstyle.
- get_data ( origem = True ) [fonte] #
Retorne os dados da linha como um par.
(xdata, ydata)Se orig for True , retorne os dados originais.
- get_drawstyle ( ) [fonte] #
Retorne o estilo de desenho.
Veja também
set_drawstyle.
- get_ds ( ) [fonte] #
Alias para
get_drawstyle.
- get_fillstyle ( ) [fonte] #
Retorne o estilo de preenchimento do marcador.
Veja também
set_fillstyle.
- get_gapcolor ( ) [fonte] #
Retorna a linha gapcolor.
Veja também
set_gapcolor.
- get_linestyle ( ) [fonte] #
Retorne o estilo de linha.
Veja também
set_linestyle.
- get_linewidth ( ) [fonte] #
Retorna a largura da linha em pontos.
Veja também
set_linewidth.
- get_ls ( ) [fonte] #
Alias para
get_linestyle.
- get_lw ( ) [fonte] #
Alias para
get_linewidth.
- get_marker ( ) [fonte] #
Retorne o marcador de linha.
Veja também
set_marker.
- get_markeredgecolor ( ) [fonte] #
Retorne a cor da borda do marcador.
Veja também
set_markeredgecolor.
- get_markeredgewidth ( ) [fonte] #
Retorna a largura da borda do marcador em pontos.
Veja também
set_markeredgewidth.
- get_markerfacecolor ( ) [fonte] #
Retorne a cor da face do marcador.
Veja também
set_markerfacecolor.
- get_markerfacecoloralt ( ) [fonte] #
Retorna a cor alternativa da face do marcador.
Veja também
set_markerfacecoloralt.
- get_markersize ( ) [fonte] #
Retorna o tamanho do marcador em pontos.
Veja também
set_markersize.
- get_markevery ( ) [fonte] #
Retorna a configuração markevery para a subamostragem do marcador.
Veja também
set_markevery.
- get_mec ( ) [fonte] #
Alias para
get_markeredgecolor.
- get_mew ( ) [fonte] #
Alias para
get_markeredgewidth.
- get_mfc ( ) [fonte] #
Alias para
get_markerfacecolor.
- get_mfcalt ( ) [fonte] #
Alias para
get_markerfacecoloralt.
- get_ms ( ) [fonte] #
Alias para
get_markersize.
- get_pickradius ( ) [fonte] #
Retorne o raio de coleta usado para testes de contenção.
Consulte
containspara mais detalhes.
- get_solid_capstyle ( ) [fonte] #
Retorne
CapStylepara linhas sólidas.Veja também
set_solid_capstyle.
- get_solid_joinstyle ( ) [fonte] #
Retorne
JoinStylepara linhas sólidas.Veja também
set_solid_joinstyle.
- get_window_extent ( renderizador = Nenhum ) [fonte] #
Obtenha a caixa delimitadora do artista no espaço de exibição.
A largura e a altura da caixa delimitadora não são negativas.
As subclasses devem substituir a inclusão no cálculo "apertado" da caixa delimitadora. O padrão é retornar uma caixa delimitadora vazia em 0, 0.
Tenha cuidado ao usar esta função, os resultados não serão atualizados se a extensão da janela do artista for alterada. A extensão pode mudar devido a quaisquer alterações na pilha de transformação, como alterar os limites dos eixos, o tamanho da figura ou a tela usada (como é feito ao salvar uma figura). Isso pode levar a um comportamento inesperado em que as figuras interativas ficarão bem na tela, mas serão salvas incorretamente.
- get_xdata ( origem = True ) [fonte] #
Retorne o xdata.
Se orig for True , retorne os dados originais, senão os dados processados.
- get_ydata ( origem = True ) [fonte] #
Retorne os ydata.
Se orig for True , retorne os dados originais, senão os dados processados.
- is_dashed ( ) [fonte] #
Retorna se a linha tem um estilo de linha tracejada.
Supõe-se que um estilo de linha personalizado seja tracejado, não o inspecionamos
onoffseqdiretamente.Veja também
set_linestyle.
- lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted' , 'Nenhum': '_draw_nothing'} #
- marcadores = {'.': 'point', ',': 'pixel', 'o': 'circle', 'v': 'triangle_down', '^': 'triangle_up', '<': 'triangle_left' , '>': 'triangle_right', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', ' s': 'quadrado', 'p': 'pentágono', '*': 'estrela','h': 'hexágono1', 'H': 'hexágono2', '+': 'mais', '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: 'caretupbase', 11: 'caretdownbase', 'Nenhum': 'nada', 'nenhum': 'nada', ' ': 'nada', '': 'nada'} #
- propriedade pickradius #
Retorne o raio de coleta usado para testes de contenção.
Consulte
containspara mais detalhes.
- set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animado=<UNSET> , antialiased=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET > , dash_capstyle=<UNSET> , dash_joinstyle=<UNSET> , dashes=<UNSET> , data=<UNSET> , drawstyle=<UNSET> , fillstyle=<UNSET> , gapcolor=<UNSET> , gid=<UNSET> , in_layout=<UNSET> ,label=<UNSET> ,linestyle=<UNSET> , linewidth=<UNSET> , marcador=<UNSET > , marcadoredgecolor=< UNSET > , marcadoredgewidth=< UNSET > , marcadorfacecolor=< UNSET > , marcadorfacecoloralt=< UNSET > , marcadorsize =<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> ) [source] #
Defina várias propriedades de uma só vez.
As propriedades suportadas são
Propriedade
Descrição
uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
escalar ou nenhum
bool
bool
bool
Patch ou (Caminho, Transformação) ou Nenhum
cor
CapStyleou {'bunda', 'projetando', 'redondo'}JoinStyleou {'esquadria', 'redondo', 'chanfrado'}sequência de flutuações (on/off ink em pontos) ou (None, None)
(2, N) array ou dois arrays 1D
{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
{'completo', 'esquerda', 'direita', 'inferior', 'superior', 'nenhum'}
cor ou nenhum
str
bool
objeto
{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
flutuador
string de estilo de marcador,
PathouMarkerStylecor
flutuador
cor
cor
flutuador
None ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
bool
float ou callable[[Artist, Event], tuple[bool, dict]]
desconhecido
bool
(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
bool ou nenhum
CapStyleou {'bunda', 'projetando', 'redondo'}JoinStyleou {'esquadria', 'redondo', 'chanfrado'}desconhecido
str
bool
matriz 1D
matriz 1D
flutuador
- set_aa ( b ) [fonte] #
Alias para
set_antialiased.
- set_dash_capstyle ( s ) [fonte] #
Como desenhar as extremidades se a linha for
is_dashed.O capstyle padrão é
rcParams["lines.dash_capstyle"](padrão: ).<CapStyle.butt: 'butt'>- Parâmetros :
- s
CapStyleou {'bunda', 'projetando', 'redondo'}
- s
- set_dash_joinstyle ( s ) [fonte] #
Como unir segmentos da linha se for
is_dashed.O joinstyle padrão é
rcParams["lines.dash_joinstyle"](padrão: ).<JoinStyle.round: 'round'>- Parâmetros :
- s
JoinStyleou {'esquadria', 'redondo', 'chanfrado'}
- s
- set_dashes ( seq ) [fonte] #
Defina a sequência de traços.
A sequência de traços é uma sequência de flutuadores de comprimento uniforme descrevendo o comprimento de traços e espaços em pontos.
Por exemplo, (5, 2, 1, 2) descreve uma sequência de travessões de 5 pontos e 1 ponto separados por espaços de 2 pontos.
Veja também
set_gapcolor, que permite que esses espaços sejam preenchidos com uma cor.- Parâmetros :
- sequência seq de floats (on/off ink em pontos) ou (None, None)
Se seq estiver vazio ou , o estilo de linha será definido como sólido.
(None, None)
- set_data ( * args ) [fonte] #
Defina os dados x e y.
- Parâmetros :
- *args (2, N) array ou dois arrays 1D
- set_drawstyle ( estilo de desenho ) [fonte] #
Defina o estilo de desenho do gráfico.
O estilo de desenho determina como os pontos são conectados.
- Parâmetros :
- drawstyle {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
Para 'padrão', os pontos são conectados com linhas retas.
As variantes de degraus conectam os pontos com linhas semelhantes a degraus, ou seja, linhas horizontais com degraus verticais. Eles diferem na localização da etapa:
'steps-pre': O passo está no início do segmento de linha, ou seja, a linha estará no valor y do ponto à direita.
'steps-mid': O passo está a meio caminho entre os pontos.
'steps-post: O passo está no final do segmento de linha, ou seja, a linha estará no valor y do ponto à esquerda.
'steps' é igual a 'steps-pre' e é mantido para compatibilidade com versões anteriores.
Para obter exemplos, consulte Step Demo .
- set_ds ( estilo de desenho ) [fonte] #
Alias para
set_drawstyle.
- set_fillstyle ( fs ) [fonte] #
Defina o estilo de preenchimento do marcador.
- Parâmetros :
- fs {'completo', 'esquerda', 'direita', 'inferior', 'superior', 'nenhum'}
Valores possíveis:
'full': Preencha todo o marcador com o marcadorfacecolor .
'left', 'right', 'bottom', 'top': Preencha a metade do marcador no lado dado com o marcadorfacecolor . A outra metade do marcador é preenchida com markerfacecoloralt .
'nenhum': Sem preenchimento.
Para obter exemplos, consulte Estilos de preenchimento de marcador .
- set_gapcolor ( gapcolor ) [fonte] #
Defina uma cor para preencher as lacunas no estilo de linha tracejada.
Observação
Linhas listradas são criadas desenhando duas linhas tracejadas intercaladas. Pode haver sobreposições entre esses dois, o que pode resultar em artefatos ao usar a transparência.
Esta funcionalidade é experimental e pode mudar.
- Parâmetros :
- cor gapcolor ou Nenhuma
A cor com a qual preencher as lacunas. Se Nenhum, as lacunas não serão preenchidas.
- set_linestyle ( ls ) [fonte] #
Defina o estilo de linha da linha.
- Parâmetros :
- ls {'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
Valores possíveis:
Uma linha:
estilo de linha
Descrição
'-'ou'solid'linha sólida
'--'ou'dashed'linha tracejada
'-.'ou'dashdot'linha pontilhada
':'ou'dotted'linha pontilhada
'none','None', ou' '''não desenha nada
Como alternativa, uma tupla com traço da seguinte forma pode ser fornecida:
(offset, onoffseq)
onde
onoffseqé uma tupla de comprimento uniforme de on e off ink em pontos. Veja tambémset_dashes().
Para obter exemplos, consulte Estilos de linha .
- set_linewidth ( w ) [fonte] #
Defina a largura da linha em pontos.
- Parâmetros :
- w flutuar
Largura da linha, em pontos.
- set_ls ( ls ) [fonte] #
Alias para
set_linestyle.
- set_lw ( w ) [fonte] #
Alias para
set_linewidth.
- set_marker ( marcador ) [fonte] #
Defina o marcador de linha.
- Parâmetros :
- string de estilo de marcador de marcador, ou
PathMarkerStyle Veja
markersa descrição completa dos possíveis argumentos.
- string de estilo de marcador de marcador, ou
- set_markeredgewidth ( ew ) [fonte] #
Defina a largura da borda do marcador em pontos.
- Parâmetros :
- eca flutuar
Largura da borda do marcador, em pontos.
- set_markerfacecoloralt ( fc ) [fonte] #
Defina a cor alternativa da face do marcador.
- Parâmetros :
- fc cor
- set_markersize ( sz ) [fonte] #
Defina o tamanho do marcador em pontos.
- Parâmetros :
- sz float
Tamanho do marcador, em pontos.
- set_markevery ( todos ) [fonte] #
Defina a propriedade markevery para subamostrar o gráfico ao usar marcadores.
por exemplo, se
every=5, cada 5º marcador será plotado.- Parâmetros :
- every None ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
Quais marcadores plotar.
every=None: cada ponto será plotado.every=N: cada N-ésimo marcador será plotado começando com o marcador 0.every=(start, N): cada N-ésimo marcador, começando no início do índice , será plotado.every=slice(start, end, N): cada N-ésimo marcador, começando no início do índice , até, mas não incluindo o fim do índice , será plotado.every=[i, j, m, ...]: apenas os marcadores nos índices fornecidos serão plotados.every=[True, False, True, ...]: apenas as posições True serão plotadas. A lista deve ter o mesmo comprimento que os pontos de dados.every=0.1, (ou seja, um flutuador): os marcadores serão espaçados em distâncias visuais aproximadamente iguais ao longo da linha; a distância ao longo da linha entre os marcadores é determinada pela multiplicação da distância da coordenada de exibição da diagonal da caixa delimitadora dos eixos pelo valor de cada .every=(0.5, 0.1)(isto é, uma tupla de float de comprimento 2): semelhante a,every=0.1mas o primeiro marcador será deslocado ao longo da linha por 0,5 multiplicado pela distância diagonal da coordenada de exibição ao longo da linha.
Para obter exemplos, consulte Markevery Demo .
Notas
Definir markevery ainda desenhará apenas marcadores em pontos de dados reais. Embora a forma do argumento float vise um espaçamento visual uniforme, ela precisa coagir do espaçamento ideal até o ponto de dados disponível mais próximo. Dependendo do número e da distribuição dos pontos de dados, o resultado pode não parecer uniformemente espaçado.
Ao usar um deslocamento inicial para especificar o primeiro marcador, o deslocamento será do primeiro ponto de dados, que pode ser diferente do primeiro ponto de dados visível se o gráfico for ampliado.
Se aumentar o zoom em um gráfico ao usar argumentos flutuantes, os pontos de dados reais que possuem marcadores serão alterados porque a distância entre os marcadores é sempre determinada a partir da diagonal da caixa delimitadora dos eixos das coordenadas de exibição, independentemente dos limites de dados dos eixos reais.
- set_mec ( ec ) [fonte] #
Alias para
set_markeredgecolor.
- set_mew ( ew ) [fonte] #
Alias para
set_markeredgewidth.
- set_mfc ( fc ) [fonte] #
Alias para
set_markerfacecolor.
- set_mfcalt ( fc ) [fonte] #
Alias para
set_markerfacecoloralt.
- set_ms ( sz ) [fonte] #
Alias para
set_markersize.
- set_picker ( p ) [fonte] #
Defina os detalhes do seletor de eventos para a linha.
- Parâmetros :
- p float ou callable[[Artist, Event], tuple[bool, dict]]
Se flutuante, é usado como o raio de seleção em pontos.
- set_pickradius ( pickradius ) [fonte] #
Defina o raio de seleção usado para testes de contenção.
Consulte
containspara mais detalhes.- Parâmetros :
- pickradius float
Escolha o raio, em pontos.
- set_solid_capstyle ( s ) [fonte] #
Como desenhar as tampas se a linha for sólida (não
is_dashed)O capstyle padrão é
rcParams["lines.solid_capstyle"](padrão: ).<CapStyle.projecting: 'projecting'>- Parâmetros :
- s
CapStyleou {'bunda', 'projetando', 'redondo'}
- s
- set_solid_joinstyle ( s ) [fonte] #
Como unir segmentos se a linha for sólida (não
is_dashed).O joinstyle padrão é
rcParams["lines.solid_joinstyle"](padrão: ).<JoinStyle.round: 'round'>- Parâmetros :
- s
JoinStyleou {'esquadria', 'redondo', 'chanfrado'}
- s
- zorder = 2 #
Exemplos usando matplotlib.lines.Line2D#
Rótulos de figuras: suptitle, supxlabel, supylabel
Diagrama SkewT-logP: usando transformações e projeções personalizadas
Formatador de marca personalizado para séries temporais
Ajustando controles deslizantes para valores discretos