matplotlib.pyplot.eventplot

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

Tracez des lignes parallèles identiques aux positions données.

Ce type de tracé est couramment utilisé en neurosciences pour représenter des événements neuronaux, où il est généralement appelé raster de pointes, raster de points ou tracé raster.

Cependant, il est utile dans toutes les situations où vous souhaitez afficher le moment ou la position de plusieurs ensembles d'événements discrets, tels que les heures d'arrivée des personnes dans une entreprise chaque jour du mois ou la date des ouragans chaque année du dernier siècle.

Paramètres :

positions de type tableau ou liste de type tableau

Un type de tableau 1D définit les positions d'une séquence d'événements.

Plusieurs groupes d'événements peuvent être passés sous la forme d'une liste de tableaux similaires. Chaque groupe peut être stylisé indépendamment en transmettant des listes de valeurs à lineoffsets , linelengths , linewidths , colors et linestyles .

Notez que les positions peuvent être un tableau 2D, mais dans la pratique, différents groupes d'événements ont généralement des nombres différents, de sorte que l'on utilisera une liste de tableaux de différentes longueurs plutôt qu'un tableau 2D.

orientation {'horizontal', 'vertical'}, par défaut : 'horizontal'

La direction de la séquence d'événements :

• 'horizontal' : les événements sont disposés horizontalement. Les lignes indicatrices sont verticales.

• 'vertical' : les événements sont disposés verticalement. Les lignes indicatrices sont horizontales.

lineoffsets flottant ou semblable à un tableau, par défaut : 1

Décalage du centre des lignes par rapport à l'origine, dans la direction orthogonale à orientation .

Si positions est en 2D, il peut s'agir d'une séquence dont la longueur correspond à la longueur de positions .

longueurs de ligne flottantes ou de type tableau, par défaut : 1

La hauteur totale des lignes (c'est-à-dire que les lignes s'étendent de à ).lineoffset - linelength/2lineoffset + linelength/2

Si positions est en 2D, il peut s'agir d'une séquence dont la longueur correspond à la longueur de positions .

largeurs de ligne flottantes ou de type tableau, par défaut : rcParams["lines.linewidth"](par défaut : 1.5)

Largeur(s) de ligne des lignes d'événement, en points.

Si positions est en 2D, il peut s'agir d'une séquence dont la longueur correspond à la longueur de positions .

couleurs couleur ou liste de couleurs, par défaut : rcParams["lines.color"](par défaut : 'C0')

La ou les couleurs des lignes d'événement.

Si positions est en 2D, il peut s'agir d'une séquence dont la longueur correspond à la longueur de positions .

linestyles str ou tuple ou liste de ces valeurs, par défaut : 'solid'

La valeur par défaut est 'solide'. Les chaînes valides sont ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Les dash tuples doivent être de la forme :

(offset, onoffseq),

où onoffseq est un tuple de longueur paire d'encre allumée et éteinte en points.

Si positions est en 2D, il peut s'agir d'une séquence dont la longueur correspond à la longueur de positions .

objet de données indexable, facultatif

S'ils sont fournis, les paramètres suivants acceptent également une chaîne s, qui est interprétée comme data[s](sauf si cela déclenche une exception) :

positions , décalages de ligne , longueurs de ligne , largeurs de ligne , couleurs , styles de ligne

**kwargs

Les autres arguments de mots clés sont les propriétés de collection de lignes. Voir LineCollectionpour une liste des propriétés valides.

Retours :

liste deEventCollection

Les EventCollectionqui ont été ajoutés.

Remarques

Pour linelengths , linewidths , colors et linestyles , si une seule valeur est donnée, cette valeur est appliquée à toutes les lignes. Si un type de tableau est donné, il doit avoir la même longueur que positions , et chaque valeur sera appliquée à la ligne correspondante du tableau.

Exemples

( Code source , png )