matplotlib.pyplot.eventplot

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

Zeichnen Sie identische parallele Linien an den angegebenen Positionen.

Diese Art von Diagramm wird häufig in der Neurowissenschaft zur Darstellung neuronaler Ereignisse verwendet, wo es normalerweise als Spike-Raster, Punkt-Raster oder Raster-Plot bezeichnet wird.

Es ist jedoch in jeder Situation nützlich, in der Sie den Zeitpunkt oder die Position mehrerer Sätze diskreter Ereignisse anzeigen möchten, z. B. die Ankunftszeiten von Personen in einem Unternehmen an jedem Tag des Monats oder das Datum von Hurrikanen jedes Jahres des letzten Jahrhundert.

Parameter :

Positionen Array-ähnlich oder Liste von Array-ähnlich

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

Mehrere Gruppen von Ereignissen können als Liste von Array-ähnlichen übergeben werden. Jede Gruppe kann unabhängig gestylt werden, indem Listen von Werten an Linienoffsets , Linienlängen , Linienbreiten , Farben und Linienstile übergeben werden .

Beachten Sie, dass Positionen ein 2D-Array sein können, aber in der Praxis haben verschiedene Ereignisgruppen normalerweise unterschiedliche Zählwerte, so dass man eher eine Liste von Arrays unterschiedlicher Länge als ein 2D-Array verwendet.

Ausrichtung {'horizontal', 'vertikal'}, Standard: 'horizontal'

Die Richtung des Ereignisablaufs:

• 'horizontal': Die Ereignisse werden horizontal angeordnet. Die Anzeigelinien sind vertikal.

• 'vertikal': Die Events sind vertikal angeordnet. Die Indikatorlinien sind horizontal.

lineoffsets Float oder Array-artig, Standard: 1

Der Versatz des Mittelpunkts der Linien vom Ursprung in der Richtung orthogonal zur Ausrichtung .

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

linelengths float oder array-like, default: 1

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

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

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

Die Linienbreite(n) der Ereignislinien in Punkten.

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

Farben Farbe oder Farbliste, Standard: rcParams["lines.color"](Standard: 'C0')

Die Farbe(n) der Ereigniszeilen.

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

linestyles str oder Tupel oder Liste solcher Werte, Standard: 'solid'

Die Voreinstellung ist „fest“. Gültige Zeichenketten sind ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Dash-Tupel sollten folgende Form haben:

(offset, onoffseq),

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

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

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):

Positionen , Linienversätze , Linienlängen , Linienbreiten , Farben , Linienstile

**Kwarg

Andere Schlüsselwortargumente sind Liniensammlungseigenschaften. Siehe LineCollectionfür eine Liste der gültigen Eigenschaften.

Rückgaben :

Liste vonEventCollection

Die EventCollectionwurden hinzugefügt.

Anmerkungen

Wenn für linelengths , linewidths , colors und linestyles nur ein einziger Wert angegeben wird, wird dieser Wert auf alle Linien angewendet. Wenn ein Array-like angegeben wird, muss es die gleiche Länge haben wie positions , und jeder Wert wird auf die entsprechende Zeile des Arrays angewendet.

Beispiele

( Quellcode , png )