matplotlib.patches.Patch #

classe matplotlib.patches. Patch ( * , edgecolor = Nenhum , facecolor = Nenhum , color = Nenhum , linewidth = Nenhum , estilo de linha = Nenhum , antialiased = Nenhum , hachura = Nenhum , fill = True , capstyle = Nenhum , joinstyle = Nenhum , ** kwargs ) [fonte ]#

Bases:Artist

Um patch é um artista 2D com uma cor de rosto e uma cor de borda.

Se qualquer um dos edgecolor , facecolor , linewidth ou antialiased for None , eles serão padronizados para sua configuração de parâmetros rc.

As seguintes propriedades kwarg são suportadas

Propriedade	Descrição
`agg_filter`	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
`alpha`	desconhecido
`animated`	bool
`antialiased`ou aa	bool ou nenhum
`capstyle`	`CapStyle`ou {'bunda', 'projetando', 'redondo'}
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch ou (Caminho, Transformação) ou Nenhum
`color`	cor
`edgecolor`ou ec	cor ou nenhum
`facecolor`ou fc	cor ou nenhum
`figure`	`Figure`
`fill`	bool
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	`JoinStyle`ou {'esquadria', 'redondo', 'chanfrado'}
`label`	objeto
`linestyle`ou ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth`ou lw	flutuante ou nenhum
`mouseover`	bool
`path_effects`	`AbstractPathEffect`
`picker`	None ou bool ou float ou callable
`rasterized`	bool
`sketch_params`	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
`snap`	bool ou nenhum
`transform`	`Transform`
`url`	str
`visible`	bool
`zorder`	flutuador

contém ( mouseevent , radius = None ) [source] #

Teste se o evento do mouse ocorreu no patch.

Devoluções :

(bool, dict vazio)

contém_ponto ( ponto , raio = Nenhum ) [fonte] #

Retorna se o ponto dado está dentro do patch.

Parâmetros :

ponto (flutuar, flutuar): O ponto (x, y) a ser verificado, nas coordenadas alvo de self.get_transform(). Estas são coordenadas de exibição para patches que são adicionados a uma figura ou eixos.
flutuação do raio , opcional: Adicione uma margem adicional no patch nas coordenadas de destino de self.get_transform(). Consulte Path.contains_pointpara mais detalhes.

Devoluções :

bool

Notas

O uso adequado deste método depende da transformação do patch. Os patches isolados não têm uma transformação. Nesse caso, as coordenadas de criação do patch e as coordenadas do ponto correspondem. O exemplo a seguir verifica se o centro de um círculo está dentro do círculo

>>> center = 0, 0
>>> c = Circle(center, radius=1)
>>> c.contains_point(center)
True

A convenção de verificar o patch transformado decorre do fato de que esse método é predominantemente usado para verificar se as coordenadas de exibição (por exemplo, de eventos do mouse) estão dentro do patch. Se você deseja fazer a verificação acima com as coordenadas de dados, primeiro deve transformá-las adequadamente:

>>> center = 0, 0
>>> c = Circle(center, radius=1)
>>> plt.gca().add_patch(c)
>>> transformed_center = c.get_transform().transform(center)
>>> c.contains_point(transformed_center)
True

contém_pontos ( pontos , raio = Nenhum ) [fonte] #

Retorna se os pontos dados estão dentro do patch.

Parâmetros :

matriz de pontos (N, 2): Os pontos a verificar, nas coordenadas alvo de self.get_transform(). Estas são coordenadas de exibição para patches que são adicionados a uma figura ou eixos. As colunas contêm valores x e y.
flutuação do raio , opcional: Adicione uma margem adicional no patch nas coordenadas de destino de self.get_transform(). Consulte Path.contains_pointpara mais detalhes.

Devoluções :

array bool comprimento-N

Notas

O uso adequado deste método depende da transformação do patch. Veja as notas em Patch.contains_point.

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

Notas

Este método é substituído nas subclasses Artist.

preenchimento de propriedade #: Retorna se o patch está preenchido.

get_aa ( ) [fonte] #: Alias para get_antialiased.

get_antialiased ( ) [fonte] #: Retorna se o antialiasing é usado para desenhar.

get_capstyle ( ) [fonte] #: Devolva o estilo cap.

get_data_transform ( ) [fonte] #: Retorne as coordenadas dos Transformdados de mapeamento para as coordenadas físicas.

get_ec ( ) [fonte] #: Alias para get_edgecolor.

get_edgecolor ( ) [fonte] #: Retorna a cor da borda.

get_extents ( ) [fonte] #: Retorne as Patchextensões alinhadas ao eixo de como um arquivo Bbox.

get_facecolor ( ) [fonte] #: Retorna a cor do rosto.

get_fc ( ) [fonte] #: Alias para get_facecolor.

get_fill ( ) [fonte] #: Retorna se o patch está preenchido.

get_hatch ( ) [fonte] #: Retorne o padrão de hachura.

get_joinstyle ( ) [fonte] #: Retorne o estilo de junção.

get_linestyle ( ) [fonte] #: Retorne o estilo de linha.

get_linewidth ( ) [fonte] #: Retorna a largura da linha em pontos.

get_ls ( ) [fonte] #: Alias para get_linestyle.

get_lw ( ) [fonte] #: Alias para get_linewidth.

get_patch_transform ( ) [fonte] #

Retorne as Transformcoordenadas do patch de mapeamento de instância para as coordenadas de dados.

Por exemplo, pode-se definir um patch de um círculo que representa um raio de 5, fornecendo coordenadas para um círculo unitário e uma transformação que dimensiona as coordenadas (a coordenada do patch) em 5.

get_path ( ) [fonte] #: Retorne o caminho deste patch.

get_transform ( ) [fonte] #: Retorne o Transformaplicado ao Patch.

get_verts ( ) [fonte] #

Retorne uma cópia dos vértices usados neste patch.

Se o patch contiver curvas Bezier, as curvas serão interpoladas por segmentos de linha. Para acessar as curvas como curvas, use get_path.

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.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animado=<UNSET> , antialiased=<UNSET> , capstyle=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , fill=<UNSET> , gid=<UNSET> , hachura=<UNSET> , in_layout=<UNSET> , joinstyle=<UNSET> , label=<UNSET> ,estilo de linha=<UNSET> ,linewidth=<UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visível=<UNSET> , zorder=<UNSET> ) [source] #

Defina várias propriedades de uma só vez.

As propriedades suportadas são

Propriedade

Descrição

agg_filter

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

alpha

desconhecido

animated

bool

antialiased

bool ou nenhum

capstyle

CapStyleou {'bunda', 'projetando', 'redondo'}

clip_box

Bbox

clip_on

bool

clip_path

Patch ou (Caminho, Transformação) ou Nenhum

color

cor

edgecolor

cor ou nenhum

facecolor

cor ou nenhum

figure

Figure

fill

bool

gid

str

hatch

{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

in_layout

bool

joinstyle

JoinStyleou {'esquadria', 'redondo', 'chanfrado'}

label

objeto

linestyle

{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

linewidth

flutuante ou nenhum

mouseover

bool

path_effects

AbstractPathEffect

picker

None ou bool ou float ou callable

rasterized

bool

sketch_params

(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)

snap

bool ou nenhum

transform

Transform

url

str

visible

bool

zorder

flutuador

set_aa ( aa ) [fonte] #: Alias para set_antialiased.

set_alpha ( alpha ) [fonte] #

Defina o valor alfa usado para mesclagem - não suportado em todos os back-ends.

Parâmetros :

alfa escalar ou nenhum: alfa deve estar dentro do intervalo de 0-1, inclusive.

set_antialiased ( aa ) [fonte] #

Defina se deseja usar a renderização suavizada.

Parâmetros :

aa bool ou Nenhum

set_capstyle ( s ) [fonte] #

Defina o CapStyle.

O capstyle padrão é 'round' para FancyArrowPatche 'butt' para todos os outros patches.

Parâmetros :

s CapStyleou {'bunda', 'projetando', 'redondo'}

set_color ( c ) [fonte] #

Defina a cor da borda e a cor da face.

Parâmetros :

c cor

Veja também

Patch.set_facecolor,Patch.set_edgecolor: Para definir a cor da borda ou face individualmente.

set_ec ( cor ) [fonte] #: Alias para set_edgecolor.

set_edgecolor ( cor ) [fonte] #

Defina a cor da borda do patch.

Parâmetros :

cor cor ou nenhum

set_facecolor ( cor ) [fonte] #

Defina a cor da face do patch.

Parâmetros :

cor cor ou nenhum

set_fc ( cor ) [fonte] #: Alias para set_facecolor.

set_fill ( b ) [fonte] #

Defina se deseja preencher o patch.

Parâmetros :

b bool

set_hatch ( hatch ) [fonte] #

Defina o padrão de hachura.

a escotilha pode ser uma das seguintes:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

As letras podem ser combinadas, caso em que todas as hachuras especificadas são feitas. Se a mesma letra for repetida, aumenta a densidade de hachura desse padrão.

A hachura é suportada apenas nos back-ends PostScript, PDF, SVG e Agg.

Parâmetros :

hachura {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_joinstyle ( s ) [fonte] #

Defina o JoinStyle.

O estilo de união padrão é 'redondo' para FancyArrowPatche 'esquadria' para todos os outros patches.

Parâmetros :

s JoinStyleou {'esquadria', 'redondo', 'chanfrado'}

set_linestyle ( ls ) [fonte] #

Defina o estilo de linha do patch.

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