matplotlib.pyplot.tricontourf

matplotlib.pyplot. tricontourf ( * args , ** kwargs )

Disegna regioni di contorno su una griglia triangolare non strutturata.

Firme di chiamata:

tricontourf(triangulation, Z, [levels], ...)
tricontourf(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)

La griglia triangolare può essere specificata passando un Triangulation oggetto come primo parametro o passando i punti x , y e facoltativamente i triangoli e una maschera . Vedere Triangulationper una spiegazione di questi parametri. Se non viene fornita né la triangolazione né i triangoli , la triangolazione viene calcolata al volo.

È possibile far passare i triangoli in posizione, ad es . Tuttavia, questo è scoraggiato. Per maggiore chiarezza, passa i triangoli tramite l'argomento della parola chiave.tricontourf(x, y, triangles, Z, ...)

Parametri :

triangolazione Triangulation, opzionale

Una griglia triangolare già creata.

x, y, triangoli, maschera

Parametri che definiscono la griglia triangolare. Vedi Triangulation. Questo si esclude a vicenda specificando la triangolazione .

Simile a un array Z

I valori di altezza su cui viene disegnato il contorno. La mappatura dei colori è controllata da cmap , norm , vmin e vmax .

livelli int o simile a un array, facoltativo

Determina il numero e le posizioni delle linee di contorno/aree.

Se un int n , usa MaxNLocator, che tenta di scegliere automaticamente non più di n+1 livelli di contorno "buoni" tra vmin e vmax .

Se simile a una matrice, disegna linee di contorno ai livelli specificati. I valori devono essere in ordine crescente.

Resi :

TriContourSet

Altri parametri :

colors stringa di colori o sequenza di colori, facoltativo

I colori dei livelli, cioè le regioni di contorno.

La sequenza viene ciclata per i livelli in ordine crescente. Se la sequenza è più breve del numero di livelli, viene ripetuta.

Come scorciatoia, si possono usare stringhe di un solo colore al posto di elenchi di un elemento, cioè 'red'invece di ['red']colorare tutti i livelli con lo stesso colore. Questa scorciatoia funziona solo per le stringhe di colore, non per altri modi di specificare i colori.

Per impostazione predefinita (valore None ), verrà utilizzata la mappa colori specificata da cmap .

alfa float, predefinito: 1

Il valore di fusione alfa, compreso tra 0 (trasparente) e 1 (opaco).

cmap str o Colormap, predefinito: rcParams["image.cmap"](predefinito: 'viridis')

L'istanza Colormap o il nome registrato della mappa colori utilizzato per mappare i dati scalari ai colori.

Questo parametro viene ignorato se i colori sono impostati.

norm str o Normalize, facoltativo

Il metodo di normalizzazione utilizzato per ridimensionare i dati scalari nell'intervallo [0, 1] prima della mappatura ai colori utilizzando cmap . Per impostazione predefinita, viene utilizzato un ridimensionamento lineare, mappando il valore più basso su 0 e il più alto su 1.

Se indicato, può essere uno dei seguenti:

• Un'istanza di Normalizeo una delle sue sottoclassi (vedere Normalizzazione della mappa dei colori ).

• Un nome di scala, ad esempio "linear", "log", "symlog", "logit", ecc. Per un elenco delle scale disponibili, chiamare matplotlib.scale.get_scale_names(). NormalizeIn tal caso, una sottoclasse adatta viene generata dinamicamente e istanziata.

Questo parametro viene ignorato se i colori sono impostati.

vmin, vmax float, facoltativo

Quando si utilizzano dati scalari e nessuna norma esplicita , vmin e vmax definiscono l'intervallo di dati coperto dalla mappa dei colori. Per impostazione predefinita, la mappa dei colori copre l'intero intervallo di valori dei dati forniti. È un errore utilizzare vmin / vmax quando viene fornita un'istanza di norma (ma l'utilizzo di un nome di norma insieme a vmin / vmax è accettabile).str

Se vmin o vmax non sono specificati, il ridimensionamento del colore predefinito è basato su livelli .

Questo parametro viene ignorato se i colori sono impostati.

origin { Nessuno , 'superiore', 'inferiore', 'immagine'}, predefinito: Nessuno

Determina l'orientamento e la posizione esatta di Z specificando la posizione di . Questo è rilevante solo se X , Y non sono dati.Z[0, 0]

• Nessuno : è in X=0, Y=0 nell'angolo in basso a sinistra.Z[0, 0]

• 'inferiore': è in X=0.5, Y=0.5 nell'angolo in basso a sinistra.Z[0, 0]

• 'superiore': è in X=N+0.5, Y=0.5 nell'angolo in alto a sinistra.Z[0, 0]

• 'image': utilizza il valore da rcParams["image.origin"](predefinito: 'upper').

estensione (x0, x1, y0, y1), opzionale

Se origin non è None , extent viene interpretato come in imshow: fornisce i limiti dei pixel esterni. In questo caso, la posizione di Z[0, 0] è il centro del pixel, non un angolo. Se origin è None , allora ( x0 , y0 ) è la posizione di Z[0, 0] e ( x1 , y1 ) è la posizione di Z[-1, -1].

Questo argomento viene ignorato se X e Y sono specificati nella chiamata a contour.

locator ticker.Locator sottoclasse, facoltativo

Il localizzatore viene utilizzato per determinare i livelli di contorno se non vengono forniti esplicitamente tramite i livelli . Il valore predefinito è MaxNLocator.

extend {'nessuno', 'entrambi', 'min', 'max'}, default: 'nessuno'

Determina la tricontourfcolorazione dei valori che non rientrano nell'intervallo dei livelli .

Se "nessuno dei due", i valori al di fuori dell'intervallo dei livelli non sono colorati. Se 'min', 'max' o 'entrambi', colora i valori sotto, sopra o sotto e sopra l' intervallo dei livelli .

I valori al di sotto min(levels)e al di sopra max(levels)sono mappati ai valori under/over di Colormap. Si noti che la maggior parte delle mappe di colori non ha colori dedicati per questi per impostazione predefinita, in modo che i valori sopra e sotto siano i valori del bordo della mappa di colori. Potresti voler impostare questi valori in modo esplicito usando Colormap.set_undere Colormap.set_over.

Nota

Un esistente TriContourSetnon viene avvisato se le proprietà della sua mappa dei colori vengono modificate. Pertanto, è necessaria una chiamata esplicita a ContourSet.changed()dopo aver modificato la mappa dei colori. La chiamata esplicita può essere tralasciata, se una barra dei colori è assegnata a TriContourSetperché chiama internamente ContourSet.changed().

xunits, yunits unità registrate, facoltativo

Sostituisci le unità dell'asse specificando un'istanza di un file matplotlib.units.ConversionInterface.

bool antialiased , facoltativo

Abilita l'antialiasing, sovrascrivendo le impostazioni predefinite. Per i contorni riempiti, l'impostazione predefinita è True . Per i contorni delle linee, viene preso da rcParams["lines.antialiased"](predefinito: True).

lista dei tratteggi [str], facoltativo

Un elenco di modelli di tratteggio incrociato da utilizzare sulle aree riempite. Se Nessuno, non verrà aggiunto alcun tratteggio al contorno. Il tratteggio è supportato solo nei backend PostScript, PDF, SVG e Agg.

Appunti

tricontourfriempie gli intervalli chiusi in alto; ovvero, per i limiti z1 e z2 , l'area piena è:

z1 < Z <= z2

ad eccezione dell'intervallo più basso, che è chiuso su entrambi i lati (cioè include il valore più basso).