matplotlib.contour

Classi per supportare il tracciamento dei contorni e l'etichettatura per la classe Axes.

classe matplotlib.contour. ClabelText ( x = 0 , y = 0 , text = '' , * , color = None , verticalalignment = 'baseline' , horizontalalignment = 'left' , multialignment = None , fontproperties = None , rotation = None , linespacing = None , rotation_mode = Nessuno, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs )

Basi:Text

A differenza del testo ordinario, get_rotation restituisce un angolo aggiornato nella coordinata dei pixel assumendo che la rotazione di input sia un angolo nella coordinata dei dati (o qualsiasi altro set di trasformazione).

Crea Textun'istanza in x , y con testo stringa .

Il testo è allineato rispetto al punto di ancoraggio ( x , y ) secondo horizontalalignment(default: 'left') e verticalalignment (default: 'bottom'). Vedere anche Allineamento del testo .

Sebbene Text accetti l'argomento della parola chiave 'label', per impostazione predefinita non viene aggiunto agli handle di una legenda.

Gli argomenti delle parole chiave valide 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	scalare o Nessuno
animated	bool
backgroundcolor	colore
bbox	dict con proprietà perpatches.FancyBboxPatch
clip_box	sconosciuto
clip_on	sconosciuto
clip_path	sconosciuto
coloro c	colore
figure	Figure
fontfamilyo famiglia	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertieso font o font_properties	font_manager.FontPropertieso stropathlib.Path
fontsizeo dimensione	float o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretcho allungare	{un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra-espanso ', 'ultra-espanso'}
fontstyleo stile	{'normale', 'corsivo', 'obliquo'}
fontvarianto variante	{'normale', 'maiuscoletto'}
fontweighto peso	{un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'grassetto', 'pesante', 'extra grassetto', 'nero'}
gid	str
horizontalalignmento ah	{'sinistra', 'centro', 'destra'}
in_layout	bool
label	oggetto
linespacing	float (multiplo della dimensione del carattere)
math_fontfamily	str
mouseover	bool
multialignmento mamma	{'sinistra', 'destra', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
position	(galleggiare, galleggiare)
rasterized	bool
rotation	float o {'verticale', 'orizzontale'}
rotation_mode	{Nessuno, 'predefinito', 'ancora'}
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
text	oggetto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool o Nessuno
verticalalignmento Va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	galleggiante
y	galleggiante
zorder	galleggiante

get_rotazione ( )

Restituisce l'angolo del testo in gradi compreso tra 0 e 360.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<DISINSERITO>, horizontalalignment=<UNSET>, in_layout=<UNSET> , label=<UNSET> , linespaing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math=<UNSET> , path_effects=<UNSET> , picker =<UNSET> , position=<UNSET> , rasterized=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text=<UNSET> , transform=< DISINSERITO> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> )

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	scalare o Nessuno
animated	bool
backgroundcolor	colore
bbox	dict con proprietà perpatches.FancyBboxPatch
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
coloro c	colore
figure	Figure
fontfamilyo famiglia	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertieso font o font_properties	font_manager.FontPropertieso stropathlib.Path
fontsizeo dimensione	float o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretcho allungare	{un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra-espanso ', 'ultra-espanso'}
fontstyleo stile	{'normale', 'corsivo', 'obliquo'}
fontvarianto variante	{'normale', 'maiuscoletto'}
fontweighto peso	{un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'grassetto', 'pesante', 'extra grassetto', 'nero'}
gid	str
horizontalalignmento ah	{'sinistra', 'centro', 'destra'}
in_layout	bool
label	oggetto
linespacing	float (multiplo della dimensione del carattere)
math_fontfamily	str
mouseover	bool
multialignmento mamma	{'sinistra', 'destra', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
position	(galleggiare, galleggiare)
rasterized	bool
rotation	float o {'verticale', 'orizzontale'}
rotation_mode	{Nessuno, 'predefinito', 'ancora'}
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
text	oggetto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool o Nessuno
verticalalignmento Va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	galleggiante
y	galleggiante
zorder	galleggiante

classe matplotlib.contour. ContourLabeler

Basi:object

Mixin per fornire funzionalità di etichettatura a ContourSet.

add_label ( x , y , rotazione , lev , cvalue )

Aggiungi l'etichetta del contorno usando Textla classe.

add_label_clabeltext ( x , y , rotazione , lev , cvalue )

Aggiungi l'etichetta del contorno usando ClabelTextla classe.

add_label_near ( x , y , inline = True , inline_spacing = 5 , transform = None )

Aggiungi un'etichetta vicino al punto .(x, y)

Parametri :

x, y fluttuano

La posizione approssimativa dell'etichetta.

inline bool, predefinito: vero

Se True rimuove il segmento del contorno sotto l'etichetta.

inline_spacing int, predefinito: 5

Spazio in pixel da lasciare su ogni lato dell'etichetta quando si inserisce in linea. Questa spaziatura sarà esatta per le etichette nei punti in cui il contorno è diritto, meno per le etichette sui contorni curvi.

transform Transformo False, predefinito:self.axes.transData

Una trasformazione applicata prima dell'etichettatura. L'impostazione predefinita fa sì che venga interpretata come coordinate dei dati. è sinonimo di ; vale a dire dovrebbe essere interpretato come coordinate di visualizzazione.(x, y)(x, y)FalseIdentityTransform(x, y)

calc_label_rot_and_inline ( slc , ind , lw , lc = None , spaziatura = 5 )

Calcolare la rotazione appropriata dell'etichetta date le coordinate della linea di contorno in unità dello schermo, l'indice della posizione dell'etichetta e la larghezza dell'etichetta.

Se lc non è None o è vuoto, interrompi anche i contorni e calcola l'inline.

la spaziatura è lo spazio vuoto da lasciare intorno all'etichetta, in pixel.

Entrambe le attività vengono eseguite insieme per evitare di calcolare più volte le lunghezze del percorso, il che è relativamente costoso.

Il metodo qui utilizzato comporta il calcolo della lunghezza del percorso lungo il contorno in coordinate pixel e quindi l'osservazione approssimativa (larghezza etichetta / 2) lontano dal punto centrale per determinare la rotazione e quindi interrompere il contorno se lo si desidera.

clabel ( levels = None , * , fontsize = None , inline = True , inline_spacing = 5 , fmt = None , colors = None , use_clabeltext = False , manual = False , rightside_up = True , zorder = None )

Etichetta un grafico di contorno.

Aggiunge etichette ai contorni delle linee in this ContourSet(che eredita da questa classe mixin).

Parametri :

livelli tipo array, facoltativo

Un elenco di valori di livello, che dovrebbero essere etichettati. L'elenco deve essere un sottoinsieme di cs.levels. Se non indicato, tutti i livelli sono etichettati.

fontsize str o float, predefinito: rcParams["font.size"](predefinito: 10.0)

Dimensione in punti o dimensione relativa, ad es. "minore", "x-grande". Vedere Text.set_sizeper i valori di stringa accettati.

colori colore o colori o Nessuno, impostazione predefinita: Nessuno

I colori dell'etichetta:

• Se None , il colore di ciascuna etichetta corrisponde al colore del contorno corrispondente.

• Se un colore di stringa, ad esempio, colors = 'r' o colors = 'red', tutte le etichette verranno tracciate in questo colore.

• Se una tupla di colori (stringa, float, rgb, ecc.), etichette diverse verranno tracciate in colori diversi nell'ordine specificato.

inline bool, predefinito: vero

Se Trueil contorno sottostante viene rimosso nel punto in cui è posizionata l'etichetta.

inline_spacing float, predefinito: 5

Spazio in pixel da lasciare su ogni lato dell'etichetta quando si inserisce in linea.

Questa spaziatura sarà esatta per le etichette nei punti in cui il contorno è diritto, meno per le etichette sui contorni curvi.

fmt Formattero str o callable o dict, facoltativo

Come sono formattati i livelli:

• Se a Formatter, viene utilizzato per formattare tutti i livelli contemporaneamente, utilizzando il suo Formatter.format_ticksmetodo.

• Se str, viene interpretato come una stringa di formato in stile %.

• Se un callable, viene chiamato con un livello alla volta e dovrebbe restituire l'etichetta corrispondente.

• Se un dict, dovrebbe mappare direttamente i livelli alle etichette.

L'impostazione predefinita prevede l'utilizzo di un file ScalarFormatter.

manual bool o iterabile, default: False

Se True, le etichette dei contorni verranno posizionate manualmente utilizzando i clic del mouse. Fare clic sul primo pulsante vicino a un contorno per aggiungere un'etichetta, fare clic sul secondo pulsante (o potenzialmente su entrambi i pulsanti del mouse contemporaneamente) per completare l'aggiunta delle etichette. Il terzo pulsante può essere utilizzato per rimuovere l'ultima etichetta aggiunta, ma solo se le etichette non sono in linea. In alternativa, la tastiera può essere utilizzata per selezionare le posizioni dell'etichetta (invio per terminare il posizionamento dell'etichetta, cancella o backspace agiscono come il terzo pulsante del mouse e qualsiasi altro tasto selezionerà una posizione dell'etichetta).

manual può anche essere un oggetto iterabile di tuple (x, y). Le etichette di contorno verranno create come se si fa clic con il mouse in ciascuna posizione (x, y).

rightside_up bool, predefinito: vero

Se True, le rotazioni delle etichette saranno sempre di più o meno 90 gradi rispetto al livello.

use_clabeltext bool, predefinito: falso

If True, ClabelTextclass (invece di Text) viene utilizzato per creare etichette. ClabelTextricalcola gli angoli di rotazione dei testi durante il tempo di disegno, quindi può essere utilizzato se l'aspetto degli assi cambia.

zorder float o Nessuno, predefinito:(2 + contour.get_zorder())

zorder delle etichette di contorno.

Resi :

etichette

Un elenco di Textistanze per le etichette.

get_label_width ( lev , fmt , fsize )

[ Deprecato ] Restituisce la larghezza dell'etichetta in punti.

Appunti

Deprecato dalla versione 3.5.

get_text ( lev , fmt )

Ottenere il testo dell'etichetta.

etichette ( inline , inline_spacing )

locate_label ( linecontour , labelwidth )

Trova un buon posto per disegnare un'etichetta (parte relativamente piatta del contorno).

etichetta_pop ( indice = -1 )

L'impostazione predefinita è la rimozione dell'ultima etichetta, ma è possibile fornire qualsiasi indice

print_label ( linecontour , labelwidth )

Restituisce se un contorno è abbastanza lungo da contenere un'etichetta.

set_label_props ( etichetta , testo , colore )

Imposta le proprietà dell'etichetta: colore, dimensione carattere, testo.

too_close ( x , y , lw )

Indica se un'etichetta è già vicino a questa posizione.

classe matplotlib.contour. ContourSet ( ax , * args , layers = None , filled = False , linewidths = None , linestyles = None , tratteggi = (Nessuno,) , alpha = None , origin = None , extent = None , cmap = None , colors = None , norma =None , vmin = None , vmax = None , extend = 'neither' , antialiased = None , nchunk = 0 , locator = None , transform = None , negative_linestyles = None , ** kwargs )

Basi: ScalarMappable,ContourLabeler

Memorizza una serie di linee di contorno o campiture.

Metodo richiamabile dall'utente:clabel

Parametri :

asciaAxes

livelli [livello0, livello1, ..., livellon]

Un elenco di numeri in virgola mobile che indicano i livelli di contorno.

allsegs [level0segs, level1segs, ...]

Elenco di tutti i segmenti poligonali per tutti i livelli . Per linee di contorno e per aree di contorno riempite . Le liste dovrebbero assomigliarelen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds Noneo [level0kinds, level1kinds, ...]

Elenco facoltativo di tutti i tipi di vertice del poligono (tipi di codice), come descritto e utilizzato in Path. Viene utilizzato per consentire percorsi a connessione multipla come fori all'interno di poligoni riempiti. In caso contrario None, . Le liste dovrebbero assomigliarelen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Se allkinds non lo è None, di solito tutti i poligoni per un particolare livello di contorno vengono raggruppati insieme in modo che e .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Gli argomenti delle parole chiave sono descritti nella docstring di contour.

Attributi :

asciaAxes

L'oggetto Axes in cui vengono disegnati i contorni.

collezioni silent_listdi PathCollections

La Artists che rappresenta il contorno. Questo è un elenco di PathCollections sia per linee che per contorni riempiti.

matrice di livelli

I valori dei livelli di contorno.

matrice di strati

Uguale ai livelli per i contorni delle linee; a metà strada tra i livelli per i contorni riempiti. Vedi ContourSet._process_colors.

Disegna linee di contorno o campiture, a seconda che la parola chiave arg filled sia False(predefinita) o True.

Firma chiamata:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Parametri :

asciaAxes

L' Axesoggetto su cui disegnare.

livelli [livello0, livello1, ..., livellon]

Un elenco di numeri in virgola mobile che indicano i livelli di contorno.

allsegs [level0segs, level1segs, ...]

Elenco di tutti i segmenti poligonali per tutti i livelli . Per linee di contorno e per aree di contorno riempite . Le liste dovrebbero assomigliarelen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds [level0kinds, level1kinds, ...], facoltativo

Elenco facoltativo di tutti i tipi di vertice del poligono (tipi di codice), come descritto e utilizzato in Path. Viene utilizzato per consentire percorsi a connessione multipla come fori all'interno di poligoni riempiti. In caso contrario None, . Le liste dovrebbero assomigliarelen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Se allkinds non lo è None, di solito tutti i poligoni per un particolare livello di contorno vengono raggruppati insieme in modo che e .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Gli argomenti delle parole chiave sono descritti nella docstring di contour.

modificato ( )

Chiamalo ogni volta che il mappabile viene modificato per notificare a tutti gli ascoltatori di callbackSM il segnale "modificato".

find_nearest_contour ( x , y , indici = Nessuno , pixel = True )

Trova il punto nel grafico del contorno più vicino a .(x, y)

Questo metodo non supporta i contorni riempiti.

Parametri :

x, y fluttuano

Il punto di riferimento.

lista di indici di int o None, default: None

Indici dei livelli di contorno da considerare. Se Nessuno (impostazione predefinita), vengono considerati tutti i livelli.

pixel bool, predefinito: vero

Se True , misura la distanza in pixel (schermo), utile per l'etichettatura manuale dei contorni; altrimenti, misura la distanza nello spazio degli assi.

Resi :

contornoCollection

Il contorno più vicino a .(x, y)

segmento int

L'indice del contornoPath in più vicino a .(x, y)

indice int

L'indice del segmento del percorso nel segmento più vicino a .(x, y)

xmin, ymin float

Il punto nel grafico di contorno più vicino a .(x, y)

galleggiante d2

La distanza al quadrato da a .(xmin, ymin)(x, y)

get_alpha ( )

Restituisce l'alfa da applicare a tutti gli artisti ContourSet.

get_transform ( )

Restituisce l' Transformistanza utilizzata da questo ContourSet.

legend_elements ( variable_name='x' , str_format=<class 'str'> )

Restituisce un elenco di artisti ed etichette adatte al passaggio a legendcui rappresentano questo ContourSet.

Le etichette hanno la forma "0 < x <= 1" che indica gli intervalli di dati rappresentati dagli artisti.

Parametri :

nome_variabile str

La stringa utilizzata all'interno della disuguaglianza utilizzata sulle etichette.

funzione str_format : float -> str

Funzione utilizzata per formattare i numeri nelle etichette.

Resi :

elenco artisti [ Artist]

Un elenco degli artisti.

elenco etichette [str]

Un elenco delle etichette.

set_alpha ( alpha )

Impostare il valore di fusione alfa per tutti gli artisti ContourSet. alfa deve essere compreso tra 0 (trasparente) e 1 (opaco).

classe matplotlib.contour. QuadContourSet ( ax , * args , livelli = Nessuno , riempito = Falso , linewidths = Nessuno , linestyles = Nessuno , tratteggi = (Nessuno,) , alpha = Nessuno , origine = Nessuno , extent = Nessuno , cmap = Nessuno , colors = Nessuno , norma =None , vmin = None , vmax = None , extend = 'neither' , antialiased = None , nchunk = 0 , locator = None , transform = None , negative_linestyles = None , ** kwargs )

Basi:ContourSet

Creare e memorizzare una serie di linee di contorno o campiture.

Questa classe in genere non viene istanziata direttamente dall'utente ma da contoure contourf.

Attributi :

asciaAxes

L'oggetto Axes in cui vengono disegnati i contorni.

collezioni silent_listdi PathCollections

La Artists che rappresenta il contorno. Questo è un elenco di PathCollections sia per linee che per contorni riempiti.

matrice di livelli

I valori dei livelli di contorno.

matrice di strati

Uguale ai livelli per i contorni delle linee; a metà strada tra i livelli per i contorni riempiti. Vedi ContourSet._process_colors.

Disegna linee di contorno o campiture, a seconda che la parola chiave arg filled sia False(predefinita) o True.

Firma chiamata:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Parametri :

asciaAxes

L' Axesoggetto su cui disegnare.

livelli [livello0, livello1, ..., livellon]

Un elenco di numeri in virgola mobile che indicano i livelli di contorno.

allsegs [level0segs, level1segs, ...]

Elenco di tutti i segmenti poligonali per tutti i livelli . Per linee di contorno e per aree di contorno riempite . Le liste dovrebbero assomigliarelen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds [level0kinds, level1kinds, ...], facoltativo

Elenco facoltativo di tutti i tipi di vertice del poligono (tipi di codice), come descritto e utilizzato in Path. Viene utilizzato per consentire percorsi a connessione multipla come fori all'interno di poligoni riempiti. In caso contrario None, . Le liste dovrebbero assomigliarelen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Se allkinds non lo è None, di solito tutti i poligoni per un particolare livello di contorno vengono raggruppati insieme in modo che e .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Gli argomenti delle parole chiave sono descritti nella docstring di contour.