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:
Artist
Uma 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
Line2D
instância com dados x e y em sequências de xdata , ydata .Argumentos de palavras-chave adicionais são
Line2D
propriedades: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
antialiased
ou aabool
bool
Patch ou (Caminho, Transformação) ou Nenhum
color
ou ccor
CapStyle
ou {'bunda', 'projetando', 'redondo'}JoinStyle
ou {'esquadria', 'redondo', 'chanfrado'}sequência de flutuações (on/off ink em pontos) ou (None, None)
(2, N) array ou dois arrays 1D
drawstyle
ou ds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
{'completo', 'esquerda', 'direita', 'inferior', 'superior', 'nenhum'}
cor ou nenhum
str
bool
objeto
linestyle
ou ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth
ou lwflutuador
string de estilo de marcador,
Path
ouMarkerStyle
markeredgecolor
ou meccor
markeredgewidth
ou miarflutuador
markerfacecolor
ou mfccor
markerfacecoloralt
ou mfcaltcor
markersize
ou 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
CapStyle
ou {'bunda', 'projetando', 'redondo'}JoinStyle
ou {'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_pickradius
ouset_pickradius
para 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_visible
retorna 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
CapStyle
linhas tracejadas.Veja também
set_dash_capstyle
.
- get_dash_joinstyle ( ) [fonte] #
Retorna as
JoinStyle
linhas 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
contains
para mais detalhes.
- get_solid_capstyle ( ) [fonte] #
Retorne
CapStyle
para linhas sólidas.Veja também
set_solid_capstyle
.
- get_solid_joinstyle ( ) [fonte] #
Retorne
JoinStyle
para 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
onoffseq
diretamente.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
contains
para 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
CapStyle
ou {'bunda', 'projetando', 'redondo'}JoinStyle
ou {'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,
Path
ouMarkerStyle
cor
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
CapStyle
ou {'bunda', 'projetando', 'redondo'}JoinStyle
ou {'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
CapStyle
ou {'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
JoinStyle
ou {'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
Path
MarkerStyle
Veja
markers
a 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.1
mas 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
contains
para 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
CapStyle
ou {'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
JoinStyle
ou {'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