matplotlib.parches.Patch #

clase matplotlib.parches. Parche ( * , color de borde = Ninguno , color de cara = Ninguno , color = Ninguno , ancho de línea = Ninguno , estilo de línea = Ninguno , suavizado = Ninguno , sombreado = Ninguno , relleno = Verdadero , capstyle = Ninguno , estilo de unión = Ninguno , ** kwargs ) [ fuente ]#

Bases:Artist

Un parche es un artista 2D con un color de cara y un color de borde.

Si cualquiera de edgecolor , facecolor , linewidth o antialiased es None , se establecerán de forma predeterminada en su configuración rc params.

Se admiten las siguientes propiedades de kwarg

Propiedad	Descripción
`agg_filter`	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
`alpha`	desconocido
`animated`	bool
`antialiased`o uno	booleano o ninguno
`capstyle`	`CapStyle`o {'trasero', 'proyectando', 'redondo'}
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Parchear o (Ruta, Transformar) o Ninguno
`color`	color
`edgecolor`o ce	color o ninguno
`facecolor`o FC	color o ninguno
`figure`	`Figure`
`fill`	bool
`gid`	calle
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	`JoinStyle`o {'inglete', 'redondo', 'bisel'}
`label`	objeto
`linestyle`o ls	{'-', '--', '-.', ':', '', (desplazamiento, on-off-seq), ...}
`linewidth`o bajo	flotante o Ninguno
`mouseover`	bool
`path_effects`	`AbstractPathEffect`
`picker`	Ninguno o bool o flotante o invocable
`rasterized`	bool
`sketch_params`	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
`snap`	booleano o ninguno
`transform`	`Transform`
`url`	calle
`visible`	bool
`zorder`	flotar

contiene ( mouseevent , radio = Ninguno ) [fuente] #

Pruebe si el evento del mouse ocurrió en el parche.

Devoluciones :

(bool, dictado vacío)

contains_point ( punto , radio = Ninguno ) [fuente] #

Devuelve si el punto dado está dentro del parche.

Parámetros :

punto (flotante, flotante): El punto (x, y) a verificar, en las coordenadas de destino de self.get_transform(). Estas son coordenadas de visualización para parches que se agregan a una figura o ejes.
flotador de radio , opcional: Agregue un margen adicional en el parche en las coordenadas de destino de self.get_transform(). Ver Path.contains_pointpara más detalles.

Devoluciones :

bool

notas

El uso adecuado de este método depende de la transformación del parche. Los parches aislados no tienen una transformación. En este caso, las coordenadas de creación del parche y las coordenadas del punto coinciden. El siguiente ejemplo comprueba que el centro de un círculo está dentro del círculo.

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

La convención de verificar contra el parche transformado surge del hecho de que este método se usa principalmente para verificar si las coordenadas de visualización (por ejemplo, de los eventos del mouse) están dentro del parche. Si desea hacer la verificación anterior con coordenadas de datos, primero debe transformarlas correctamente:

>>> 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

contains_points ( puntos , radio = Ninguno ) [fuente] #

Devuelve si los puntos dados están dentro del parche.

Parámetros :

matriz de puntos (N, 2): Los puntos a comprobar, en coordenadas de destino de self.get_transform(). Estas son coordenadas de visualización para parches que se agregan a una figura o ejes. Las columnas contienen valores de x e y.
flotador de radio , opcional: Agregue un margen adicional en el parche en las coordenadas de destino de self.get_transform(). Ver Path.contains_pointpara más detalles.

Devoluciones :

matriz bool longitud-N

notas

El uso adecuado de este método depende de la transformación del parche. Ver las notas en Patch.contains_point.

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

notas

Este método se anula en las subclases de artista.

relleno de propiedad #: Devuelve si el parche está lleno.

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

get_antialiased ( ) [fuente] #: Devuelve si se usa antialiasing para dibujar.

get_capstyle ( ) [fuente] #: Devuelve el capstyle.

get_data_transform ( ) [fuente] #: Devuelva las Transformcoordenadas de los datos de mapeo a las coordenadas físicas.

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

get_edgecolor ( ) [fuente] #: Devuelve el color del borde.

get_extents ( ) [fuente] #: Devuelve las Patchextensiones alineadas con el eje como un Bbox.

get_facecolor ( ) [fuente] #: Devuelve el color de la cara.

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

get_fill ( ) [fuente] #: Devuelve si el parche está lleno.

get_hatch ( ) [fuente] #: Devuelve el patrón de sombreado.

get_joinstyle ( ) [fuente] #: Devuelve el estilo de unión.

get_linestyle ( ) [fuente] #: Devuelve el estilo de línea.

get_linewidth ( ) [fuente] #: Devuelve el ancho de línea en puntos.

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

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

get_patch_transform ( ) [fuente] #

Devuelva las Transformcoordenadas del parche de mapeo de la instancia a las coordenadas de los datos.

Por ejemplo, uno puede definir un parche de un círculo que representa un radio de 5 al proporcionar coordenadas para un círculo unitario y una transformación que escala las coordenadas (la coordenada del parche) en 5.

get_path ( ) [fuente] #: Devuelve la ruta de este parche.

get_transform ( ) [fuente] #: Devuelve el Transformaplicado al Patch.

get_verts ( ) [fuente] #

Devuelve una copia de los vértices utilizados en este parche.

Si el parche contiene curvas Bezier, las curvas se interpolarán por segmentos de línea. Para acceder a las curvas como curvas, utilice get_path.

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.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation =<UNSET> , antialiased=<UNSET> , capstyle=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , fill=<UNSET> , gid=<UNSET> , hatch=<UNSET> , in_layout=<UNSET> , joinstyle=<UNSET> , etiqueta=<DESCONFIGURADO> ,linestyle=<UNSET> ,linewidth=<UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visible=<UNSET> , zorder=<UNSET> ) [fuente] #

Establece varias propiedades a la vez.

Las propiedades admitidas son

Propiedad

Descripción

agg_filter

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

alpha

desconocido

animated

bool

antialiased

booleano o ninguno

capstyle

CapStyleo {'trasero', 'proyectando', 'redondo'}

clip_box

Bbox

clip_on

bool

clip_path

Parchear o (Ruta, Transformar) o Ninguno

color

color

edgecolor

color o ninguno

facecolor

color o ninguno

figure

Figure

fill

bool

gid

calle

hatch

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

in_layout

bool

joinstyle

JoinStyleo {'inglete', 'redondo', 'bisel'}

label

objeto

linestyle

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

linewidth

flotante o Ninguno

mouseover

bool

path_effects

AbstractPathEffect

picker

Ninguno o bool o flotante o invocable

rasterized

bool

sketch_params

(escala: flotante, longitud: flotante, aleatoriedad: flotante)

snap

booleano o ninguno

transform

Transform

url

calle

visible

bool

zorder

flotar

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

set_alpha ( alfa ) [fuente] #

Establezca el valor alfa utilizado para la combinación; no se admite en todos los backends.

Parámetros :

escalar alfa o ninguno: alfa debe estar dentro del rango 0-1, inclusive.

set_antialiased ( aa ) [fuente] #

Establezca si desea utilizar el renderizado suavizado.

Parámetros :

aa bool o Ninguno

set_capstyle ( s ) [fuente] #

Establezca el CapStyle.

El capstyle predeterminado es 'redondo' FancyArrowPatchy 'a tope' para todos los demás parches.

Parámetros :

s CapStyleo {'trasero', 'proyectando', 'redondo'}

set_color ( c ) [fuente] #

Establezca tanto el color del borde como el color de la cara.

Parámetros :

c color

Ver también

Patch.set_facecolor,Patch.set_edgecolor: Para configurar el borde o el color de la cara individualmente.

set_ec ( color ) [fuente] #: Alias para set_edgecolor.

set_edgecolor ( color ) [fuente] #

Establezca el color del borde del parche.

Parámetros :

color color o Ninguno

set_facecolor ( color ) [fuente] #

Establezca el color de la cara del parche.

Parámetros :

color color o Ninguno

set_fc ( color ) [fuente] #: Alias para set_facecolor.

set_fill ( b ) [fuente] #

Establezca si desea llenar el parche.

Parámetros :

b bool

set_hatch ( escotilla ) [fuente] #

Establezca el patrón de sombreado.

la escotilla puede ser una de:

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

Las letras se pueden combinar, en cuyo caso se realizan todos los sombreados especificados. Si se repite la misma letra, aumenta la densidad de eclosión de ese patrón.

La eclosión solo se admite en los backends PostScript, PDF, SVG y Agg.

Parámetros :

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

set_joinstyle ( s ) [fuente] #

Establezca el JoinStyle.

El estilo de unión predeterminado es 'redondo' FancyArrowPatche 'ingleteado' para todos los demás parches.

Parámetros :

s JoinStyleo {'inglete', 'redondo', 'bisel'}

set_linestyle ( ls ) [fuente] #

Establezca el estilo de línea del parche.

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