matplotlib.pyplot.scatter #
- matplotlib.pyplot. 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 oderNone
, wird die Markierungsfarbe durch die nächste Farbe desAxes
aktuellen Farbzyklus "Form und Füllung" bestimmt. Dieser Zyklus ist standardmäßigrcParams["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.markers
Informationen 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
Normalize
oder 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 geeigneteNormalize
Unterklasse 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
odernan
) gezeichnet werden sollen. WennTrue
die Punkte mit der schlechten Colormap-Farbe gezeichnet werden (sieheColormap.set_bad
).
- Rückgaben :
- Andere Parameter :
- data indexierbares Objekt, optional
Falls angegeben, akzeptieren die folgenden Parameter auch einen String
s
, der interpretiert wird alsdata[s]
(es sei denn, dies löst eine Ausnahme aus):x , y , s , Linienbreiten , Kantenfarben , c , Flächenfarbe , Flächenfarben , Farbe
- **kwargs-
Collection
Eigenschaften
Siehe auch
plot
Zum Zeichnen von Streudiagrammen, wenn Markierungen in Größe und Farbe identisch sind.
Anmerkungen
Die
plot
Funktion 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 .