matplotlib.pyplot.hexbin

matplotlib.pyplot. hexbin ( x , y , C=None , gridsize=100 , bins=None , xscale='linear' , yscale='linear' , extend= None , cmap=None , norm=None , vmin=None , vmax=None , alpha=None , linewidths =None , edgecolors='face' , Reduce_C_function=<function mean> , mincnt=None , margins =False , * , data=None ,** kwargs )

Erstellen Sie ein sechseckiges 2D-Binning-Diagramm der Punkte x , y .

Wenn C None ist , wird der Wert des Sechsecks durch die Anzahl der Punkte im Sechseck bestimmt. Andernfalls gibt C Werte an der Koordinate (x[i], y[i]) an. Für jedes Sechseck werden diese Werte mithilfe von Reduce_C_function reduziert .

Parameter :

x, y -Array-ähnlich

Die Datenpositionen. x und y müssen gleich lang sein.

C -Array-ähnlich, optional

Falls angegeben, werden diese Werte in den Bins akkumuliert. Andernfalls hat jeder Punkt den Wert 1. Muss die gleiche Länge haben wie x und y .

gridsize int oder (int, int), Standard: 100

Bei einem einzelnen Ganzzahlwert die Anzahl der Sechsecke in x -Richtung. Die Anzahl der Sechsecke in y -Richtung ist so gewählt, dass die Sechsecke annähernd regelmäßig sind.

Alternativ, falls ein Tupel ( nx , ny ), die Anzahl der Sechsecke in x -Richtung und y -Richtung.

bins 'log' oder int oder sequence, Standard: Keine

Diskretisierung der Sechseckwerte.

• Bei None wird kein Binning angewendet; die Farbe jedes Sechsecks entspricht direkt seinem Zählwert.

• Wenn „log“, verwenden Sie eine logarithmische Skala für die Farbtabelle. Im Inneren,\(log_{10}(i+1)\)wird verwendet, um die Sechseckfarbe zu bestimmen. Dies entspricht norm=LogNorm().

• Wenn es sich um eine Ganzzahl handelt, teilen Sie die Zählungen in die angegebene Anzahl von Bins und färben Sie die Sechsecke entsprechend ein.

• Bei einer Folge von Werten die Werte der unteren Grenze der zu verwendenden Bins.

xscale {'linear', 'log'}, Standard: 'linear'

Verwenden Sie eine lineare oder log10-Skala auf der horizontalen Achse.

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

Verwenden Sie eine lineare oder log10-Skala auf der vertikalen Achse.

mincnt int > 0, Standard: Keine

Wenn nicht None , werden nur Zellen mit mehr als mincnt Anzahl von Punkten in der Zelle angezeigt.

marginals bool, Standard: False

Wenn marginals True ist , zeichnen Sie die Randdichte als farblich zugeordnete Rechtecke am unteren Rand der x-Achse und links von der y-Achse.

Extent 4-Tupel von Float, Standard: Keine

Die Grenzen der Bins (xmin, xmax, ymin, ymax). Die Standardeinstellung weist die Grenzen basierend auf Gridsize , x , y , xscale und yscale zu .

Wenn xscale oder yscale auf 'log' gesetzt ist, wird erwartet, dass die Grenzen der Exponent für eine Potenz von 10 sind. ZB für x-Grenzen von 1 und 50 in 'linearer' Skala und y-Grenzen von 10 und 1000 in 'log ' Skala, geben Sie (1, 50, 1, 3) ein.

Rückgaben :

PolyCollection

A PolyCollection, das die sechseckigen Behälter definiert.

• PolyCollection.get_offsetsenthält ein Mx2-Array, das die x-, y-Positionen der M Hexagon-Zentren enthält.

• PolyCollection.get_arrayenthält die Werte der M Sechsecke.

Wenn marginals True ist , werden horizontaler Balken und vertikaler Balken (beides PolyCollections) als Attribute hbar und vbar an die Rückgabesammlung angehängt .

Andere Parameter :

cmap str oder Colormap, Standard: rcParams["image.cmap"](Standard: 'viridis')

Die Colormap-Instanz oder der registrierte Colormap-Name, der zum Zuordnen von Skalardaten zu Farben verwendet wird.

norm str oder Normalize, optional

Die Normalisierungsmethode, die verwendet wird, um skalare Daten auf den Bereich [0, 1] zu skalieren, bevor sie mithilfe von cmap auf Farben abgebildet werden . Standardmäßig wird eine lineare Skalierung verwendet, die den niedrigsten Wert auf 0 und den höchsten auf 1 abbildet.

Falls angegeben, kann dies einer der folgenden sein:

• Eine Instanz Normalizeoder eine ihrer Unterklassen (siehe Colormap-Normalisierung ).

• Ein Skalenname, z. B. „linear“, „log“, „symlog“, „logit“ usw. Rufen Sie für eine Liste der verfügbaren Skalen auf matplotlib.scale.get_scale_names(). In diesem Fall wird eine geeignete NormalizeUnterklasse dynamisch generiert und instanziiert.

vmin, vmax Float, optional

Wenn skalare Daten und keine explizite Norm verwendet werden, definieren vmin und vmax den Datenbereich, den die Farbtabelle abdeckt. Standardmäßig deckt die Colormap den kompletten Wertebereich der gelieferten Daten ab. Es ist ein Fehler, vmin / vmax zu verwenden, wenn eine Norminstanz angegeben ist (aber die Verwendung eines Normnamens zusammen mit vmin / vmax ist akzeptabel).str

Alphafloat zwischen 0 und 1, optional

Der Alpha-Blending-Wert zwischen 0 (transparent) und 1 (deckend).

Linienbreiten schweben, Standard: Keine

Wenn None , wird standardmäßig 1,0 verwendet.

edgecolors {'face', 'none', None } oder color, default: 'face'

Die Farbe der Sechskantkanten. Mögliche Werte sind:

• 'face': Zeichnen Sie die Kanten in der gleichen Farbe wie die Füllfarbe.

• 'none': Es werden keine Kanten gezeichnet. Dies kann manchmal zu unansehnlichen unbemalten Pixeln zwischen den Sechsecken führen.

• Keine : Umrisse in der Standardfarbe zeichnen.

• Eine eindeutige Farbe.

Reduce_C_function aufrufbar, Standard:numpy.mean

Die Funktion zum Aggregieren von C innerhalb der Bins. Es wird ignoriert, wenn C nicht angegeben ist. Diese muss die Signatur haben:

def reduce_C_function(C: array) -> float

Häufig verwendete Funktionen sind:

• numpy.mean: Durchschnitt der Punkte

• numpy.sum: Integral der Punktwerte

• numpy.amax: Wert vom größten Punkt genommen

data indexierbares Objekt, optional

Falls angegeben, akzeptieren die folgenden Parameter auch einen String s, der interpretiert wird als data[s](es sei denn, dies löst eine Ausnahme aus):

x , y , c

**kwargs- PolyCollectionEigenschaften

Alle anderen Schlüsselwortargumente werden weitergegeben an PolyCollection:

Eigentum	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Array-ähnlich oder Skalar oder None
animated	bool
antialiasedoder aa oder Antialiasing	bool oder Liste von bools
array	Array-ähnlich oder None
capstyle	CapStyleoder {'hinter', 'vorstehend', 'rund'}
clim	(vmin: Float, vmax: Float)
clip_box	Bbox
clip_on	bool
clip_path	Patch oder (Pfad, Transform) oder None
cmap	Colormapoder str oder Keine
color	Farbe oder Liste von RGBA-Tupeln
edgecoloroder ec oder edgecolors	Farbe oder Liste von Farben oder 'Gesicht'
facecoloroder facecolors oder fc	Farbe oder Farbliste
figure	Figure
gid	Str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleoder {'Gehrung', 'rund', 'Fase'}
label	Objekt
linestyleoder Bindestriche oder Linienstile oder ls	str oder Tupel oder Liste davon
linewidthoder Linienbreiten oder lw	Float oder Liste von Floats
mouseover	bool
norm	Normalizeoder str oder Keine
offset_transformoder transOffset	Unbekannt
offsets	(N, 2) oder (2,) Array-artig
path_effects	AbstractPathEffect
paths	Liste von Array-ähnlichen
picker	None oder bool oder float oder aufrufbar
pickradius	Unbekannt
rasterized	bool
sizes	ndarray oder None
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
transform	Transform
url	Str
urls	Liste von str oder None
verts	Liste von Array-ähnlichen
verts_and_codes	Unbekannt
visible	bool
zorder	schweben

Siehe auch

hist2d

Rechteckige 2D-Histogramm-Bins