matplotlib.pyplot.eventplot

matplotlib.pyplot.eventplot(positions, *, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, alpha=None, linestyles='solid', data=None, **kwargs)

Plottet identische parallele Linien an den angegebenen Positionen.

Diese Art von Diagramm wird häufig in der Neurowissenschaft zur Darstellung neuronaler Ereignisse verwendet, wo sie üblicherweise als Spike-Raster, Dot-Raster oder Raster-Plot bezeichnet wird.

Sie ist jedoch in jeder Situation nützlich, in der Sie die Zeitpunkte oder Positionen mehrerer Sätze diskreter Ereignisse darstellen möchten, z. B. die Ankunftszeiten von Personen in einem Geschäft an jedem Tag des Monats oder das Datum von Hurrikanen in jedem Jahr des letzten Jahrhunderts.

Parameter:

positionsarray-ähnlich oder Liste von array-ähnlichen

Ein 1D-Array-ähnliches Objekt definiert die Positionen einer Ereignissequenz.

Mehrere Ereignisgruppen können als Liste von array-ähnlichen Objekten übergeben werden. Jede Gruppe kann unabhängig gestylt werden, indem Listen von Werten an lineoffsets, linelengths, linewidths, colors und linestyles übergeben werden.

Beachten Sie, dass positions ein 2D-Array sein kann, aber in der Praxis haben unterschiedliche Ereignisgruppen normalerweise unterschiedliche Anzahlen, sodass man eine Liste von Arrays unterschiedlicher Länge anstelle eines 2D-Arrays verwenden wird.

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-ähnlich, Standard: 1

Der Offset des Zentrums der Linien vom Ursprung in Richtung orthogonal zu orientation.

Wenn positions 2D ist, kann dies eine Sequenz mit einer Länge sein, die der Länge von positions entspricht.

linelengthsfloat oder array-ähnlich, Standard: 1

Die Gesamthöhe der Linien (d. h. die Linien erstrecken sich von lineoffset - linelength/2 bis lineoffset + linelength/2).

Wenn positions 2D 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 2D 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 2D ist, kann dies eine Sequenz mit einer Länge sein, die der Länge von positions entspricht.

alphafloat oder array-ähnlich, Standard: 1

Der Alpha-Mischwert (oder die Werte), zwischen 0 (transparent) und 1 (opak).

Wenn positions 2D 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 Zeichenketten sind ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Dash-Tupel sollten die Form haben

(offset, onoffseq),

wobei onoffseq ein Tupel mit gerader Länge von Ein- und Ausschaltstrichen in Punkten ist.

Wenn positions 2D 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 als data[s] interpretiert wird, wenn s ein Schlüssel in data ist

positions, lineoffsets, linelengths, linewidths, colors, linestyles

**kwargs

Andere Schlüsselwortargumente sind Eigenschaften der Linienkollektion. Siehe LineCollection für eine Liste der gültigen Eigenschaften.

Gibt zurück:

Liste von EventCollection

Die EventCollection, die hinzugefügt wurden.

Anmerkungen

Hinweis

Dies ist der pyplot-Wrapper für axes.Axes.eventplot.

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-ähnliches Objekt übergeben wird, muss es dieselbe Länge wie positions haben, und jeder Wert wird auf die entsprechende Zeile des Arrays angewendet.

Beispiele

(Quellcode, 2x.png, png)