matplotlib.patches.Patch #

classe matplotlib.patches. Patch ( * , edgecolor = None , facecolor = None , color = None , linewidth = None , linestyle = None , antialiased = None , hatch = None , fill = True , capstyle = None , joinstyle = None , ** kwargs ) [fonte ]#

Basi:Artist

Una toppa è un artista 2D con un colore della faccia e un colore del bordo.

Se uno qualsiasi tra edgecolor , facecolor , linewidth o antialiased è None , l'impostazione predefinita è rc params .

Sono supportate le seguenti proprietà kwarg

Proprietà	Descrizione
`agg_filter`	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
`alpha`	sconosciuto
`animated`	bool
`antialiased`o aa	bool o Nessuno
`capstyle`	`CapStyle`o {'culo', 'sporgente', 'rotondo'}
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch o (Percorso, Trasforma) o Nessuno
`color`	colore
`edgecolor`o ecc	colore o Nessuno
`facecolor`o fc	colore o Nessuno
`figure`	`Figure`
`fill`	bool
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	`JoinStyle`o {'mitre', 'round', 'bevel'}
`label`	oggetto
`linestyle`o ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth`o lw	float o Nessuno
`mouseover`	bool
`path_effects`	`AbstractPathEffect`
`picker`	Nessuno o bool o float o richiamabile
`rasterized`	bool
`sketch_params`	(scala: float, lunghezza: float, casualità: float)
`snap`	bool o Nessuno
`transform`	`Transform`
`url`	str
`visible`	bool
`zorder`	galleggiante

contiene ( mouseevent , radius = None ) [fonte] #

Verifica se l'evento del mouse si è verificato nella patch.

Resi :

(bool, dict vuoto)

contiene_punto ( punto , raggio = Nessuno ) [fonte] #

Restituisce se il punto dato è all'interno della patch.

Parametri :

punto (float, float): Il punto (x, y) da controllare, nelle coordinate target di self.get_transform(). Queste sono le coordinate di visualizzazione per i patch che vengono aggiunti a una figura o ad assi.
raggio galleggiante, facoltativo: Aggiungi un ulteriore margine sulla patch nelle coordinate di destinazione di self.get_transform(). Vedere Path.contains_pointper ulteriori dettagli.

Resi :

bool

Appunti

L'uso corretto di questo metodo dipende dalla trasformazione della patch. Le patch isolate non hanno una trasformazione. In questo caso, le coordinate di creazione della patch e le coordinate del punto coincidono. L'esempio seguente verifica che il centro di un cerchio sia all'interno del cerchio

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

La convenzione del controllo rispetto alla patch trasformata deriva dal fatto che questo metodo è utilizzato principalmente per verificare se le coordinate di visualizzazione (ad esempio dagli eventi del mouse) sono all'interno della patch. Se vuoi fare il controllo sopra con le coordinate dei dati, devi prima trasformarle correttamente:

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

contiene_punti ( punti , raggio = Nessuno ) [fonte] #

Restituisce se i punti dati sono all'interno della patch.

Parametri :

matrice di punti (N, 2).: I punti da controllare, nelle coordinate target di self.get_transform(). Queste sono le coordinate di visualizzazione per i patch che vengono aggiunti a una figura o ad assi. Le colonne contengono valori x e y.
raggio galleggiante, facoltativo: Aggiungi un ulteriore margine sulla patch nelle coordinate di destinazione di self.get_transform(). Vedere Path.contains_pointper ulteriori dettagli.

Resi :

lunghezza-N matrice booleana

Appunti

L'uso corretto di questo metodo dipende dalla trasformazione della patch. Vedi le note su Patch.contains_point.

draw ( renderer ) [fonte] #

Disegna l'artista (e i suoi figli) usando il renderer dato.

Questo non ha effetto se l'artista non è visibile ( Artist.get_visible restituisce False).

Parametri :

sottoclasse del renderer .RendererBase

Appunti

Questo metodo è sovrascritto nelle sottoclassi Artist.

riempimento proprietà #: Restituisci se la patch è piena.

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

get_antialiased ( ) [fonte] #: Restituisce se l'antialiasing viene utilizzato per il disegno.

get_capstyle ( ) [fonte] #: Restituisci lo stile del cappuccio.

get_data_transform ( ) [fonte] #: Restituisce le Transformcoordinate dei dati di mappatura alle coordinate fisiche.

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

get_edgecolor ( ) [fonte] #: Restituisci il colore del bordo.

get_extents ( ) [fonte] #: Restituisce le Patchestensioni allineate all'asse di come file Bbox.

get_facecolor ( ) [fonte] #: Restituisci il colore del viso.

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

get_fill ( ) [fonte] #: Restituisci se la patch è piena.

get_hatch ( ) [fonte] #: Restituisci il modello di tratteggio.

get_joinstyle ( ) [fonte] #: Restituisci lo stile di join.

get_linestyle ( ) [fonte] #: Restituisci lo stile di linea.

get_linewidth ( ) [fonte] #: Restituisce la larghezza della linea in punti.

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

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

get_patch_transform ( ) [fonte] #

Restituisce le Transformcoordinate della patch di mappatura dell'istanza alle coordinate dei dati.

Ad esempio, si può definire una patch di un cerchio che rappresenta un raggio di 5 fornendo le coordinate per un cerchio unitario e una trasformazione che ridimensiona le coordinate (la coordinata della patch) di 5.

get_path ( ) [fonte] #: Restituisce il percorso di questa patch.

get_transform ( ) [fonte] #: Restituisci l' Transformapplicazione al file Patch.

get_verts ( ) [fonte] #

Restituisce una copia dei vertici utilizzati in questa patch.

Se la patch contiene curve di Bezier, le curve verranno interpolate da segmenti di linea. Per accedere alle curve come curve, utilizzare get_path.

get_window_extent ( renderer = None ) [fonte] #

Ottieni il riquadro di delimitazione dell'artista nello spazio espositivo.

La larghezza e l'altezza del riquadro di delimitazione non sono negative.

Le sottoclassi dovrebbero sovrascrivere per l'inclusione nel calcolo "stretto" del riquadro di delimitazione. L'impostazione predefinita è restituire un riquadro di delimitazione vuoto a 0, 0.

Fai attenzione quando usi questa funzione, i risultati non si aggiorneranno se l'estensione della finestra dell'artista cambia. L'estensione può cambiare a causa di eventuali modifiche nello stack di trasformazione, come la modifica dei limiti degli assi, la dimensione della figura o la tela utilizzata (come avviene quando si salva una figura). Questo può portare a comportamenti imprevisti in cui le figure interattive appariranno bene sullo schermo, ma verranno salvate in modo errato.

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> , etichetta=<UNSET> ,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> ) [fonte] #

Imposta più proprietà contemporaneamente.

Le proprietà supportate sono

Proprietà

Descrizione

agg_filter

una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine

alpha

sconosciuto

animated

bool

antialiased

bool o Nessuno

capstyle

CapStyleo {'culo', 'sporgente', 'rotondo'}

clip_box

Bbox

clip_on

bool

clip_path

Patch o (Percorso, Trasforma) o Nessuno

color

colore

edgecolor

colore o Nessuno

facecolor

colore o Nessuno

figure

Figure

fill

bool

gid

str

hatch

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

in_layout

bool

joinstyle

JoinStyleo {'mitre', 'round', 'bevel'}

label

oggetto

linestyle

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

linewidth

float o Nessuno

mouseover

bool

path_effects

AbstractPathEffect

picker

Nessuno o bool o float o richiamabile

rasterized

bool

sketch_params

(scala: float, lunghezza: float, casualità: float)

snap

bool o Nessuno

transform

Transform

url

str

visible

bool

zorder

galleggiante

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

set_alpha ( alpha ) [fonte] #

Imposta il valore alfa utilizzato per la fusione - non supportato su tutti i backend.

Parametri :

alfa scalare o Nessuno: alfa deve essere compreso nell'intervallo 0-1 incluso.

set_antialiased ( aa ) [fonte] #

Imposta se utilizzare il rendering con antialias.

Parametri :

aa bool o Nessuno

set_capstyle ( s ) [fonte] #

Imposta il file CapStyle.

Il capstyle predefinito è 'round' per FancyArrowPatche 'butt' per tutte le altre patch.

Parametri :

s CapStyleo {'culo', 'sporgente', 'rotondo'}

imposta_colore ( c ) [fonte] #

Imposta sia l'edgecolor che il facecolor.

Parametri :

c colore

Guarda anche

Patch.set_facecolor,Patch.set_edgecolor: Per impostare individualmente il colore del bordo o della faccia.

set_ec ( colore ) [fonte] #: Alias per set_edgecolor.

set_edgecolor ( colore ) [fonte] #

Imposta il colore del bordo della toppa.

Parametri :

colore colore o Nessuno

set_facecolor ( colore ) [fonte] #

Imposta il colore della faccia della toppa.

Parametri :

colore colore o Nessuno

set_fc ( colore ) [fonte] #: Alias per set_facecolor.

set_fill ( b ) [fonte] #

Imposta se riempire la patch.

Parametri :

b bool

set_hatch ( tratteggio ) [fonte] #

Imposta il modello di tratteggio.

tratteggio può essere uno di:

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

Le lettere possono essere combinate, nel qual caso vengono eseguiti tutti i tratteggi specificati. Se la stessa lettera si ripete, aumenta la densità del tratteggio di quel motivo.

Il tratteggio è supportato solo nei backend PostScript, PDF, SVG e Agg.

Parametri :

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

set_joinstyle ( s ) [fonte] #

Imposta il file JoinStyle.

Lo stile di join predefinito è 'round' per FancyArrowPatche 'mitre' per tutte le altre patch.

Parametri :

s JoinStyleo {'mitre', 'round', 'bevel'}

set_linestyle ( ls ) [fonte] #

Imposta lo stile di linea della patch.

stile di linea	descrizione
`'-'`o`'solid'`	linea continua
`'--'`o`'dashed'`	linea tratteggiata
`'-.'`o`'dashdot'`	linea tratteggiata
`':'`o`'dotted'`	linea tratteggiata
`'none'`, `'None'`, , o`' '''`	disegnare niente