matplotlib.pyplot.eventplot

matplotlib.pyplot. eventplot ( posições , orientação = 'horizontal' , deslocamentos de linha = 1 , comprimentos de linha = 1 , larguras de linha = Nenhum , cores = Nenhum , estilos de linha = 'sólido' , * , dados = Nenhum , ** kwargs )

Traçar linhas paralelas idênticas nas posições dadas.

Esse tipo de plotagem é comumente usado em neurociência para representar eventos neurais, onde geralmente é chamado de spike raster, dot raster ou raster plot.

No entanto, é útil em qualquer situação em que você deseja mostrar o tempo ou a posição de vários conjuntos de eventos discretos, como os horários de chegada de pessoas a uma empresa em cada dia do mês ou a data dos furacões a cada ano do último século.

Parâmetros :

posições como array ou lista de arrays

Uma matriz 1D define as posições de uma sequência de eventos.

Múltiplos grupos de eventos podem ser passados ​​como uma lista de arrays semelhantes. Cada grupo pode ser estilizado independentemente passando listas de valores para lineoffsets , linelengths , linewidths , cores e linestyles .

Observe que as posições podem ser uma matriz 2D, mas, na prática, diferentes grupos de eventos geralmente têm contagens diferentes, de modo que se usará uma lista de matrizes de tamanhos diferentes em vez de uma matriz 2D.

orientação {'horizontal', 'vertical'}, padrão: 'horizontal'

A direção da sequência de eventos:

• 'horizontal': os eventos são organizados horizontalmente. As linhas indicadoras são verticais.

• 'vertical': os eventos são organizados verticalmente. As linhas indicadoras são horizontais.

lineoffsets float ou array, padrão: 1

O deslocamento do centro das linhas desde a origem, na direção ortogonal à orientação .

Se as posições forem 2D, pode ser uma sequência com comprimento correspondente ao comprimento das posições .

comprimentos de linha float ou tipo array, padrão: 1

A altura total das linhas (ou seja, as linhas se estendem de a ).lineoffset - linelength/2lineoffset + linelength/2

Se as posições forem 2D, pode ser uma sequência com comprimento correspondente ao comprimento das posições .

larguras de linha flutuantes ou semelhantes a matrizes, padrão: rcParams["lines.linewidth"](padrão: 1.5)

A(s) largura(s) da(s) linha(s) do evento, em pontos.

Se as posições forem 2D, pode ser uma sequência com comprimento correspondente ao comprimento das posições .

cores cor ou lista de cores, padrão: rcParams["lines.color"](padrão: 'C0')

A(s) cor(es) das linhas do evento.

Se as posições forem 2D, pode ser uma sequência com comprimento correspondente ao comprimento das posições .

estilos de linha str ou tupla ou lista de tais valores, padrão: 'solid'

O padrão é 'sólido'. Strings válidas são ['sólido', 'tracejado', 'traço e ponto', 'pontilhado', '-', '--', '-.', ':']. As tuplas de traço devem ser da forma:

(offset, onoffseq),

onde onoffseq é uma tupla de comprimento uniforme de on e off ink em pontos.

Se as posições forem 2D, pode ser uma sequência com comprimento correspondente ao comprimento das posições .

objeto indexável de dados , opcional

Se fornecidos, os seguintes parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção):

posições , deslocamentos de linha , comprimentos de linha , larguras de linha , cores , estilos de linha

** kwargs

Outros argumentos de palavra-chave são propriedades de coleção de linhas. Consulte LineCollectionpara obter uma lista das propriedades válidas.

Devoluções :

lista deEventCollection

Os EventCollectionque foram adicionados.

Notas

Para linelengths , linewidths , colors e linestyles , se apenas um único valor for fornecido, esse valor será aplicado a todas as linhas. Se for fornecido um tipo de array, ele deve ter o mesmo comprimento que position , e cada valor será aplicado à linha correspondente do array.

Exemplos

( Código fonte , png )