matplotlib.axes.Axes.scatter #

Achsen. scatter ( x , y , s = None , c = None , marker = None , cmap = None , norm = None , vmin = None , vmax = None , alpha = None , linewidths = None , * , edgecolors = None , plotnonfinite = Falsch ,data = None , ** kwargs ) [Quelle] #

Ein Streudiagramm von y vs. x mit unterschiedlicher Markierungsgröße und/oder -farbe.

Parameter :

x, y float oder arrayartig, shape (n, )

Die Datenpositionen.

s Float oder Array-artig, Form (n, ), optional

Die Markergröße in Punkten**2. Standard ist .rcParams['lines.markersize'] ** 2

c Array-ähnlich oder Liste von Farben oder Farbe, optional

Die Markierungsfarben. Mögliche Werte:

Ein Skalar oder eine Folge von n Zahlen, die mithilfe von cmap und norm auf Farben abgebildet werden sollen .
Ein 2D-Array, in dem die Zeilen RGB oder RGBA sind.
Eine Folge von Farben der Länge n.
Eine einfarbige Formatzeichenfolge.

Beachten Sie, dass c keine einzelne numerische RGB- oder RGBA-Sequenz sein sollte, da dies nicht von einem Array von Werten zu unterscheiden ist, die farblich abgebildet werden sollen. Wenn Sie für alle Punkte denselben RGB- oder RGBA-Wert angeben möchten, verwenden Sie ein 2D-Array mit einer einzelnen Zeile. Andernfalls hat der Wertabgleich bei einem Größenabgleich mit x und y Vorrang .

Wenn Sie für alle Punkte eine einzige Farbe angeben möchten, bevorzugen Sie das Argument für das Schlüsselwort color .

Standardmäßig auf None. In diesem Fall wird die Markerfarbe durch den Wert von color , facecolor oder facecolors bestimmt . Falls diese nicht angegeben sind oder None, wird die Markierungsfarbe durch die nächste Farbe des Axesaktuellen Farbzyklus "Form und Füllung" bestimmt. Dieser Zyklus ist standardmäßig rcParams["axes.prop_cycle"](Standard: ).cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])

Markierung MarkerStyle, Standard: rcParams["scatter.marker"](Standard: 'o')

Der Markerstil. Markierung kann entweder eine Instanz der Klasse oder die Textkurzschrift für eine bestimmte Markierung sein. Weitere matplotlib.markersInformationen zu Markierungsstilen finden Sie unter.

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.

Dieser Parameter wird ignoriert, wenn c RGB(A) ist.

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.

Dieser Parameter wird ignoriert, wenn c RGB(A) ist.

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

Dieser Parameter wird ignoriert, wenn c RGB(A) ist.

Alphafloat , Standard: Keine

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

Linienbreiten schwebend oder Array-artig, Standard: rcParams["lines.linewidth"](Standard: 1.5)

Die Linienbreite der Markerkanten. Hinweis: Die Standard - Kantenfarbe ist „Gesicht“. Vielleicht möchten Sie dies auch ändern.

edgecolors {'face', 'none', None } oder Farbe oder Farbfolge, default: rcParams["scatter.edgecolors"](default: 'face')

Die Kantenfarbe der Markierung. Mögliche Werte:

'Gesicht': Die Kantenfarbe ist immer gleich der Gesichtsfarbe.
'none': Es wird keine Patch-Grenze gezeichnet.
Eine Farbe oder Farbfolge.

Bei nicht gefüllten Markern wird edgecolors ignoriert. Stattdessen wird die Farbe wie bei 'face' bestimmt, also aus c , colors oder facecolors .

plotnonfinite bool, Standard: False

Ob Punkte mit nicht endlichem c (dh inf, -inf oder nan) gezeichnet werden sollen. Wenn Truedie Punkte mit der schlechten Colormap-Farbe gezeichnet werden (siehe Colormap.set_bad).

Rückgaben :

PathCollection

Andere Parameter :

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 , s , Linienbreiten , Kantenfarben , c , Flächenfarbe , Flächenfarben , Farbe

**kwargs- CollectionEigenschaften

Siehe auch

plot: Zum Zeichnen von Streudiagrammen, wenn Markierungen in Größe und Farbe identisch sind.

Anmerkungen

Die plotFunktion ist schneller für Streudiagramme, bei denen die Markierungen in Größe oder Farbe nicht variieren.
Einige oder alle von x , y , s und c können maskierte Arrays sein, wobei in diesem Fall alle Masken kombiniert werden und nur unmaskierte Punkte gezeichnet werden.
Grundsätzlich funktioniert Scatter mit 1D-Arrays; x , y , s und c können als ND-Arrays eingegeben werden, aber innerhalb von Scatter werden sie abgeflacht. Die Ausnahme ist c , das nur geglättet wird, wenn seine Größe mit der Größe von x und y übereinstimmt .