matplotlib.patheffects

Define classes para efeitos de caminho. Os efeitos de caminho são suportados em Text, Line2De Patch.

Veja também

Guia de efeitos de caminho

classe matplotlib.patheffects. AbstractPathEffect ( offset = (0.0, 0.0) )

Bases:object

Uma classe base para efeitos de caminho.

As subclasses devem substituir o draw_pathmétodo para adicionar funcionalidade de efeito.

Parâmetros :

deslocamento (flutuante, flutuante), padrão: (0, 0)

O deslocamento (x, y) a ser aplicado ao caminho, medido em pontos.

draw_path ( renderer , gc , tpath , affine , rgbFace = None )

Derived deve substituir esse método. Os argumentos são os mesmos, matplotlib.backend_bases.RendererBase.draw_path() exceto que o primeiro argumento é um renderizador.

classe matplotlib.patheffects. Normal ( offset = (0.0, 0.0) )

Bases:AbstractPathEffect

O PathEffect de "identidade".

O único propósito do Normal PathEffect é desenhar o artista original sem nenhum efeito de caminho especial.

Parâmetros :

deslocamento (flutuante, flutuante), padrão: (0, 0)

O deslocamento (x, y) a ser aplicado ao caminho, medido em pontos.

classe matplotlib.patheffects. PathEffectRenderer ( path_effects , renderer )

Bases:RendererBase

Implementa um Renderer que contém outro renderizador.

Esse proxy então intercepta chamadas de desenho, chamando o AbstractPathEffectmétodo de desenho apropriado.

Observação

Nem todos os métodos foram substituídos nesta subclasse RendererBase. Pode ser necessário adicionar outros métodos para estender ainda mais os recursos do PathEffects.

Parâmetros :

path_effects iterável deAbstractPathEffect

Os efeitos de caminho que este renderizador representa.

subclasse do renderizadormatplotlib.backend_bases.RendererBase

copy_with_path_effect ( path_effects )

draw_markers ( gc , marcador_caminho , marcador_trans , caminho , * args , ** kwargs )

Desenhe um marcador em cada um dos vértices do caminho (excluindo os pontos de controle).

A implementação base (fallback) faz várias chamadas para draw_path. Os back-ends podem querer substituir esse método para desenhar o marcador apenas uma vez e reutilizá-lo várias vezes.

Parâmetros :

gcGraphicsContextBase

O contexto gráfico.

marcador_transmatplotlib.transforms.Transform

Uma transformação afim aplicada ao marcador.

transmatplotlib.transforms.Transform

Uma transformação afim aplicada ao caminho.

draw_path ( gc , tpath , affine , rgbFace = None )

Desenhe uma Pathinstância usando a transformação afim fornecida.

draw_path_collection ( gc , master_transform , paths , * args , ** kwargs )

Desenhe uma coleção de caminhos .

Cada caminho é primeiro transformado pela entrada correspondente em all_transforms (uma lista de (3, 3) matrizes) e depois por master_transform . Eles são então convertidos pela entrada correspondente em offsets , que foi primeiro transformada por offset_trans .

facecolors , edgecolors , linewidths , linestyles e antialiased são listas que definem as propriedades correspondentes.

offset_position não é usado agora, mas o argumento é mantido para compatibilidade com versões anteriores.

A implementação base (fallback) faz várias chamadas para draw_path. Os back-ends podem querer substituir isso para renderizar cada conjunto de dados de caminho apenas uma vez e, em seguida, referenciar esse caminho várias vezes com diferentes deslocamentos, cores, estilos, etc. Os métodos do gerador _iter_collection_raw_pathse _iter_collectionsão fornecidos para ajudar (e padronizar) a implementação através de back-ends. É altamente recomendável usar esses geradores, para que as alterações no comportamento de draw_path_collectionpossam ser feitas globalmente.

classe matplotlib.patheffects. PathPatchEffect ( offset = (0, 0) , ** kwargs )

Bases:AbstractPathEffect

Desenha uma PathPatchinstância cujo Path vem do artista PathEffect original.

Parâmetros :

deslocamento (flutuante, flutuante), padrão: (0, 0)

O deslocamento (x, y) a ser aplicado ao caminho, em pontos.

** kwargs

Todos os argumentos de palavra-chave são passados ​​para o PathPatchconstrutor. As propriedades que não podem ser substituídas são "path", "clip_box" "transform" e "clip_path".

draw_path ( renderizador , gc , tpath , affine , rgbFace )

Derived deve substituir esse método. Os argumentos são os mesmos, matplotlib.backend_bases.RendererBase.draw_path() exceto que o primeiro argumento é um renderizador.

classe matplotlib.patheffects. SimpleLineShadow ( offset = (2, -2) , shadow_color = 'k' , alpha = 0.3 , rho = 0.3 , ** kwargs )

Bases:AbstractPathEffect

Uma simples sombra através de uma linha.

Parâmetros :

deslocamento (flutuante, flutuante), padrão: (2, -2)

O deslocamento (x, y) a ser aplicado ao caminho, em pontos.

cor shadow_color , padrão: 'preto'

A cor da sombra. Um valor de Nonepega a cor do artista original com um fator de escala de rho .

flutuação alfa , padrão: 0,3

A transparência alfa do patch de sombra criado.

rho flutuante, padrão: 0,3

Um fator de escala a ser aplicado à cor rgbFace se shadow_color for None.

** kwargs

Palavras-chave extras são armazenadas e passadas para AbstractPathEffect._update_gc().

draw_path ( renderizador , gc , tpath , affine , rgbFace )

Substitui o draw_path padrão para adicionar o deslocamento da sombra e as mudanças de cor necessárias para a sombra.

classe matplotlib.patheffects. SimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = None , alpha = None , rho = 0.3 , ** kwargs )

Bases:AbstractPathEffect

Uma sombra simples através de um patch preenchido.

Parâmetros :

deslocamento (flutuante, flutuante), padrão: (2, -2)

O deslocamento (x, y) da sombra em pontos.

shadow_rgbCor do rosto

A cor da sombra.

flutuação alfa , padrão: 0,3

A transparência alfa do patch de sombra criado.

rho flutuante, padrão: 0,3

Um fator de escala a ser aplicado à cor rgbFace se shadow_rgbFace não for especificado.

** kwargs

Palavras-chave extras são armazenadas e passadas para AbstractPathEffect._update_gc().

draw_path ( renderizador , gc , tpath , affine , rgbFace )

Substitui o draw_path padrão para adicionar o deslocamento da sombra e as mudanças de cor necessárias para a sombra.

classe matplotlib.patheffects. Stroke ( offset = (0, 0) , ** kwargs )

Bases:AbstractPathEffect

Um PathEffect baseado em linha que redesenha um traçado.

O caminho será traçado com seu gc atualizado com os argumentos de palavra-chave fornecidos, ou seja, os argumentos de palavra-chave devem ser valores de parâmetro gc válidos.

draw_path ( renderizador , gc , tpath , affine , rgbFace )

Desenhe o caminho com gc atualizado.

classe matplotlib.patheffects. TickedStroke ( offset = (0, 0) , espaçamento = 10,0 , ângulo = 45,0 , comprimento = 1,4142135623730951 , ** kwargs )

Bases:AbstractPathEffect

Um PathEffect baseado em linha que desenha um caminho com um estilo marcado.

Esse estilo de linha é freqüentemente usado para representar restrições na otimização. As marcações podem ser usadas para indicar que um lado da linha é inválido ou para representar um limite fechado de um domínio (ou seja, uma parede ou a borda de um cano).

O espaçamento, comprimento e ângulo dos carrapatos podem ser controlados.

Às vezes, esse estilo de linha é chamado de linha hachurada.

Veja também o exemplo de demonstração do contorno .

Veja também os contornos no exemplo de otimização .

Parâmetros :

deslocamento (flutuante, flutuante), padrão: (0, 0)

O deslocamento (x, y) a ser aplicado ao caminho, em pontos.

flutuação de espaçamento , padrão: 10,0

O espaçamento entre os carrapatos em pontos.

flutuação angular , padrão: 45,0

O ângulo entre o caminho e o tick em graus. O ângulo é medido como se você fosse uma formiga caminhando ao longo da curva, com zero graus apontando diretamente à frente, 90 à sua esquerda, -90 à sua direita e 180 atrás de você.

flutuação de comprimento , padrão: 1,414

O comprimento do tique em relação ao espaçamento. Comprimento recomendado = 1,414 (quadrado(2)) quando ângulo=45, comprimento=1,0 quando ângulo=90 e comprimento=2,0 quando ângulo=60.

** kwargs

Palavras-chave extras são armazenadas e passadas para AbstractPathEffect._update_gc().

Exemplos

Consulte o efeito de caminho TickedStroke .

draw_path ( renderizador , gc , tpath , affine , rgbFace )

Desenhe o caminho com gc atualizado.

classe matplotlib.patheffects. withSimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = None , alpha = None , rho = 0.3 , ** kwargs )

Bases:SimplePatchShadow

Um PathEffect de atalho para aplicar SimplePatchShadowe, em seguida, desenhar o Artista original.

Com esta classe você pode usar

artist.set_path_effects([path_effects.withSimplePatchShadow()])

como um atalho para

artist.set_path_effects([path_effects.SimplePatchShadow(),
                         path_effects.Normal()])

Parâmetros :

deslocamento (flutuante, flutuante), padrão: (2, -2)

O deslocamento (x, y) da sombra em pontos.

shadow_rgbCor do rosto

A cor da sombra.

flutuação alfa , padrão: 0,3

A transparência alfa do patch de sombra criado.

rho flutuante, padrão: 0,3

Um fator de escala a ser aplicado à cor rgbFace se shadow_rgbFace não for especificado.

** kwargs

Palavras-chave extras são armazenadas e passadas para AbstractPathEffect._update_gc().

draw_path ( renderizador , gc , tpath , affine , rgbFace )

Substitui o draw_path padrão para adicionar o deslocamento da sombra e as mudanças de cor necessárias para a sombra.

classe matplotlib.patheffects. withStroke ( offset = (0, 0) , ** kwargs )

Bases:Stroke

Um PathEffect de atalho para aplicar Strokee, em seguida, desenhar o Artista original.

Com esta classe você pode usar

artist.set_path_effects([path_effects.withStroke()])

como um atalho para

artist.set_path_effects([path_effects.Stroke(),
                         path_effects.Normal()])

O caminho será traçado com seu gc atualizado com os argumentos de palavra-chave fornecidos, ou seja, os argumentos de palavra-chave devem ser valores de parâmetro gc válidos.

draw_path ( renderizador , gc , tpath , affine , rgbFace )

Desenhe o caminho com gc atualizado.

classe matplotlib.patheffects. withTickedStroke ( offset = (0, 0) , espaçamento = 10,0 , ângulo = 45,0 , comprimento = 1,4142135623730951 , ** kwargs )

Bases:TickedStroke

Um PathEffect de atalho para aplicar TickedStrokee, em seguida, desenhar o Artista original.

Com esta classe você pode usar

artist.set_path_effects([path_effects.withTickedStroke()])

como um atalho para

artist.set_path_effects([path_effects.TickedStroke(),
                         path_effects.Normal()])

Parâmetros :

deslocamento (flutuante, flutuante), padrão: (0, 0)

O deslocamento (x, y) a ser aplicado ao caminho, em pontos.

flutuação de espaçamento , padrão: 10,0

O espaçamento entre os carrapatos em pontos.

flutuação angular , padrão: 45,0

O ângulo entre o caminho e o tick em graus. O ângulo é medido como se você fosse uma formiga caminhando ao longo da curva, com zero graus apontando diretamente à frente, 90 à sua esquerda, -90 à sua direita e 180 atrás de você.

flutuação de comprimento , padrão: 1,414

O comprimento do tique em relação ao espaçamento. Comprimento recomendado = 1,414 (quadrado(2)) quando ângulo=45, comprimento=1,0 quando ângulo=90 e comprimento=2,0 quando ângulo=60.

** kwargs

Palavras-chave extras são armazenadas e passadas para AbstractPathEffect._update_gc().

Exemplos

Consulte o efeito de caminho TickedStroke .

draw_path ( renderizador , gc , tpath , affine , rgbFace )

Desenhe o caminho com gc atualizado.