matplotlib.pyplot.hexbin

matplotlib.pyplot. hexbin ( x , y , C=Nessuno , gridsize=100 , bins=Nessuno , xscale='linear' , yscale='linear' , extent=Nessuno , cmap=Nessuno , norm=Nessuno , vmin=Nessuno , vmax=Nessuno , alpha=None , linewidths =Nessuno , edgecolors='face' , reduce_C_function=<funzione media> , mincnt=None , marginals=False , * , data=Nessuno ,**kwargs )

Crea un grafico binning esagonale 2D dei punti x , y .

Se C è None , il valore dell'esagono è determinato dal numero di punti nell'esagono. Altrimenti, C specifica i valori alla coordinata (x[i], y[i]). Per ogni esagono, questi valori vengono ridotti utilizzando reduce_C_function .

Parametri :

x, y simile a un array

Le posizioni dei dati. x e y devono essere della stessa lunghezza.

Simile a un array C , facoltativo

Se forniti, questi valori vengono accumulati nei bin. In caso contrario, ogni punto ha valore 1. Deve avere la stessa lunghezza di x e y .

gridsize int o (int, int), predefinito: 100

Se un singolo int, il numero di esagoni nella direzione x . Il numero di esagoni nella direzione y è scelto in modo tale che gli esagoni siano approssimativamente regolari.

In alternativa, se è una tupla ( nx , ny ), il numero di esagoni nella direzione x e nella direzione y .

bins 'log' o int o sequenza, default: Nessuno

Discretizzazione dei valori dell'esagono.

• Se None , non viene applicato alcun binning; il colore di ciascun esagono corrisponde direttamente al suo valore di conteggio.

• Se 'log', usa una scala logaritmica per la mappa dei colori. Internamente,\(log_{10}(i+1)\)viene utilizzato per determinare il colore dell'esagono. Questo è equivalente a norm=LogNorm().

• Se un numero intero, dividi i conteggi nel numero specificato di contenitori e colora gli esagoni di conseguenza.

• Se una sequenza di valori, i valori del limite inferiore dei bin da utilizzare.

xscale {'lineare', 'log'}, predefinito: 'lineare'

Utilizzare una scala lineare o log10 sull'asse orizzontale.

yscale {'linear', 'log'}, default: 'linear'

Utilizzare una scala lineare o log10 sull'asse verticale.

mincnt int > 0, predefinito: Nessuno

Se non è None , visualizza solo le celle con più di mincnt numero di punti nella cella.

marginals bool, default: False

Se marginals è True , tracciare la densità marginale come rettangoli mappati a colori lungo la parte inferiore dell'asse x e a sinistra dell'asse y.

extent 4 tuple di float, default: Nessuno

I limiti dei bin (xmin, xmax, ymin, ymax). L'impostazione predefinita assegna i limiti in base a gridsize , x , y , xscale e yscale .

Se xscale o yscale è impostato su 'log', i limiti dovrebbero essere l'esponente per una potenza di 10. Ad esempio, per limiti x di 1 e 50 in scala 'lineare' e limiti y di 10 e 1000 in 'log ' scala, inserisci (1, 50, 1, 3).

Resi :

PolyCollection

A PolyCollectionche definisce i contenitori esagonali.

• PolyCollection.get_offsetscontiene un array Mx2 contenente le posizioni x, y dei centri esagonali M.

• PolyCollection.get_arraycontiene i valori degli esagoni M.

Se marginals è True , la barra orizzontale e la barra verticale (entrambe PolyCollections) verranno associate alla raccolta restituita come attributi hbar e vbar .

Altri parametri :

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.

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.

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

alpha float tra 0 e 1, facoltativo

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

linewidths float, default: Nessuno

Se None , il valore predefinito è 1.0.

edgecolors {'face', 'none', None } o colore, default: 'face'

Il colore dei bordi esagonali. I valori possibili sono:

• 'faccia': disegna i bordi con lo stesso colore del colore di riempimento.

• 'none': non vengono disegnati bordi. Questo a volte può portare a antiestetici pixel non verniciati tra gli esagoni.

• Nessuno : traccia i contorni nel colore predefinito.

• Un colore esplicito.

reduce_C_function richiamabile, predefinito:numpy.mean

La funzione per aggregare C all'interno dei bin. Viene ignorato se C non è dato. Questo deve avere la firma:

def reduce_C_function(C: array) -> float

Le funzioni comunemente utilizzate sono:

• numpy.mean: media dei punti

• numpy.sum: integrale dei valori puntuali

• numpy.amax: valore preso dal punto più grande

oggetto indicizzabile dei dati , facoltativo

Se forniti, i seguenti parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione):

x , y , C

** proprietà kwargsPolyCollection

Tutti gli altri argomenti delle parole chiave vengono passati a PolyCollection:

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	tipo array o scalare o None
animated	bool
antialiasedo aa o antialias	bool o elenco di bool
array	tipo array o Nessuno
capstyle	CapStyleo {'culo', 'sporgente', 'rotondo'}
clim	(vmin: float, vmax: float)
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
cmap	Colormapo str o Nessuno
color	colore o elenco di tuple rgba
edgecoloro ec o edgecolors	colore o elenco di colori o 'volto'
facecoloro facecolors o fc	colore o elenco di colori
figure	Figure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleo {'mitre', 'round', 'bevel'}
label	oggetto
linestyleo trattini o stili di linea o ls	str o tuple o loro elenchi
linewidtho linewidths o lw	float o lista di float
mouseover	bool
norm	Normalizeo str o Nessuno
offset_transformo transOffset	sconosciuto
offsets	(N, 2) o (2,) simile a un array
path_effects	AbstractPathEffect
paths	elenco di tipo array
picker	Nessuno o bool o float o richiamabile
pickradius	sconosciuto
rasterized	bool
sizes	ndarray o Nessuno
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
transform	Transform
url	str
urls	elenco di str o Nessuno
verts	elenco di tipo array
verts_and_codes	sconosciuto
visible	bool
zorder	galleggiante

Guarda anche

hist2d

Bidoni rettangolari istogramma 2D