matplotlib.axes.Axes.eventplot#
- Axes.eventplot(positions, *, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, alpha=None, linestyles='solid', data=None, **kwargs)[Quelle]#
Plottet identische parallele Linien an den angegebenen Positionen.
Diese Art von Plot wird häufig in der Neurowissenschaft zur Darstellung neuronaler Ereignisse verwendet, wo sie üblicherweise als Spike-Raster, Punkt-Raster oder Raster-Plot bezeichnet wird.
Sie ist jedoch in jeder Situation nützlich, in der Sie das Timing oder die Position mehrerer Sätze diskreter Ereignisse darstellen möchten, wie z. B. die Ankunftszeiten von Personen an einem Geschäftstag des Monats oder das Datum von Hurrikanen in jedem Jahr des letzten Jahrhunderts.
- Parameter:
- positionsarray-artig oder Liste von array-artigen
Ein eindimensionales Array stellt die Positionen einer Ereignissequenz dar.
Mehrere Ereignisgruppen können als Liste von Arrays übergeben werden. Jede Gruppe kann unabhängig gestylt werden, indem Listen von Werten für lineoffsets, linelengths, linewidths, colors und linestyles übergeben werden.
Beachten Sie, dass positions ein zweidimensionales Array sein kann, aber in der Praxis haben verschiedene Ereignisgruppen normalerweise unterschiedliche Anzahlen, sodass man eher eine Liste von Arrays unterschiedlicher Länge als ein zweidimensionales Array verwendet.
- orientation{'horizontal', 'vertical'}, Standard: 'horizontal'
Die Richtung der Ereignissequenz
'horizontal': Die Ereignisse sind horizontal angeordnet. Die Indikatorlinien sind vertikal.
'vertical': Die Ereignisse sind vertikal angeordnet. Die Indikatorlinien sind horizontal.
- lineoffsetsfloat oder array-artig, Standard: 1
Der Versatz der Mitte der Linien vom Ursprung, in der Richtung orthogonal zu orientation.
Wenn positions zweidimensional ist, kann dies eine Sequenz mit einer Länge sein, die der Länge von positions entspricht.
- linelengthsfloat oder array-artig, Standard: 1
Die Gesamthöhe der Linien (d. h. die Linien erstrecken sich von
lineoffset - linelength/2bislineoffset + linelength/2).Wenn positions zweidimensional ist, kann dies eine Sequenz mit einer Länge sein, die der Länge von positions entspricht.
- linewidthsfloat oder Array-ähnlich, Standard:
rcParams["lines.linewidth"](Standard:1.5) Die Linienbreite(n) der Ereignislinien, in Punkten.
Wenn positions zweidimensional ist, kann dies eine Sequenz mit einer Länge sein, die der Länge von positions entspricht.
- colorsFarbe oder Liste von Farben, Standard:
rcParams["lines.color"](Standard:'C0') Die Farbe(n) der Ereignislinien.
Wenn positions zweidimensional ist, kann dies eine Sequenz mit einer Länge sein, die der Länge von positions entspricht.
- alphafloat oder array-artig, Standard: 1
Der Alpha-Blending-Wert (die Werte), zwischen 0 (transparent) und 1 (opak).
Wenn positions zweidimensional ist, kann dies eine Sequenz mit einer Länge sein, die der Länge von positions entspricht.
- linestylesstr oder Tupel oder Liste solcher Werte, Standard: 'solid'
Standard ist 'solid'. Gültige Strings sind ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Bindestrich-Tupel sollten die Form haben
(offset, onoffseq),
wobei onoffseq ein Tupel mit gerader Länge von Ein- und Ausschaltstrichen in Punkten ist.
Wenn positions zweidimensional ist, kann dies eine Sequenz mit einer Länge sein, die der Länge von positions entspricht.
- dataindizierbares Objekt, optional
Wenn angegeben, akzeptieren die folgenden Parameter auch einen String
s, der alsdata[s]interpretiert wird, wennsein Schlüssel indataistpositions, lineoffsets, linelengths, linewidths, colors, linestyles
- **kwargs
Andere Schlüsselwortargumente sind Eigenschaften der Liniensammlung. Siehe
LineCollectionfür eine Liste der gültigen Eigenschaften.
- Gibt zurück:
- Liste von
EventCollection Die hinzugefügten
EventCollection.
- Liste von
Anmerkungen
Für linelengths, linewidths, colors, alpha und linestyles gilt: Wenn nur ein einzelner Wert angegeben wird, wird dieser Wert auf alle Linien angewendet. Wenn ein array-artiges Objekt angegeben wird, muss es die gleiche Länge wie positions haben, und jeder Wert wird auf die entsprechende Zeile des Arrays angewendet.
Beispiele
