matplotlib.pyplot.stem

matplotlib.pyplot. stem ( *args , linefmt=None , markerfmt=None , basefmt=None , bottom=0 , label=None , use_line_collection=<veralteter Parameter> , orientation='vertical' , data=None )

Erstellen Sie einen Stammplot.

Ein Stammdiagramm zeichnet Linien senkrecht zu einer Grundlinie an jeder Stelle von der Grundlinie bis zu den Köpfen und platziert dort eine Markierung. Bei vertikalen Stieldiagrammen (Standardeinstellung) sind die Locs x- Positionen und die Heads y - Werte . Bei horizontalen Stammdiagrammen sind die Locs y - Positionen und die Köpfe x - Werte .

Rufsignatur:

stem([locs,] heads, linefmt=None, markerfmt=None, basefmt=None)

Die locs -Positionen sind optional. Die Formate können entweder als Positions- oder als Schlüsselwort-Argumente angegeben werden. Das positionsbezogene Übergeben von markerfmt und basefmt ist seit Matplotlib 3.5 veraltet.

Parameter :

locs -Array-ähnlich, Standard: (0, 1, ..., len(heads) - 1)

Bei vertikalen Stieldiagrammen die x-Positionen der Stiele. Bei horizontalen Stammdiagrammen die y-Positionen der Stämme.

Köpfe Array-artig

Bei vertikalen Stieldiagrammen die y-Werte der Stielköpfe. Bei horizontalen Stammdiagrammen die x-Werte der Stammköpfe.

linefmt str, optional

Ein String, der die Farbe und/oder den Linienstil der vertikalen Linien definiert:

Charakter	Linienstil
'-'	durchgezogene Linie
'--'	gestrichelte Linie
'-.'	Strichpunktlinie
':'	gepunktete Linie

Default: 'C0-', dh durchgezogene Linie mit der ersten Farbe des Farbkreises.

Hinweis: Durch diesen Parameter angegebene Markierungen (z. B. 'x') werden stillschweigend ignoriert (es sei denn, Sie verwenden use_line_collection=False). Stattdessen sollten Markierungen mit markerfmt angegeben werden .

markerfmt str, optional

Eine Zeichenfolge, die die Farbe und/oder Form der Markierungen an den Stammköpfen definiert. Wenn die Markierung nicht angegeben ist, verwenden Sie die Markierung 'o', dh gefüllte Kreise. Wenn die Farbe nicht angegeben ist, verwenden Sie die Farbe aus linefmt .

basefmt str, Standard: 'C3-' ('C2-' im klassischen Modus)

Eine Formatzeichenfolge, die die Eigenschaften der Baseline definiert.

Ausrichtungsstr , Standard: 'vertikal'

Wenn 'vertikal', wird ein Diagramm mit vertikal ausgerichteten Stielen erzeugt, andernfalls werden die Stiele horizontal ausgerichtet.

unterer Float, Standard: 0

Die y/x-Position der Grundlinie (abhängig von der Ausrichtung).

label str, Standard: Keine

Die Beschriftung, die für die Stiele in Legenden verwendet werden soll.

use_line_collection bool, Standard: True

Veraltet seit 3.6

Speichern und plotten TrueSie die Stammlinien als LineCollectionanstelle von einzelnen Linien, was die Leistung erheblich steigert. Wenn False, wird standardmäßig das alte Verhalten verwendet, bei dem eine Liste von Line2DObjekten verwendet wird.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

Rückgaben :

StemContainer

Der Container kann wie ein Tupel behandelt werden ( markerline , stemlines , baseline )

Anmerkungen

Siehe auch

Der MATLAB-Funktionsstamm , der diese Methode inspiriert hat .

Beispiele mit matplotlib.pyplot.stem

Stammplot

Stammplot