matplotlib.axes.Axes.tricontourf #
- Assi. tricontourf ( * args , ** kwargs ) [fonte] #
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
Triangulationoggetto come primo parametro o passando i punti x , y e facoltativamente i triangoli e una maschera . VedereTriangulationper 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.
- triangolazione
- Resi :
- 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).
strSe 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 sopramax(levels)sono mappati ai valori under/over diColormap. 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 usandoColormap.set_undereColormap.set_over.Nota
Un esistente
TriContourSetnon viene avvisato se le proprietà della sua mappa dei colori vengono modificate. Pertanto, è necessaria una chiamata esplicita aContourSet.changed()dopo aver modificato la mappa dei colori. La chiamata esplicita può essere tralasciata, se una barra dei colori è assegnata aTriContourSetperché chiama internamenteContourSet.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).
