Matplotlib.pyplot.eventplot() en Python

Matplotlib es una increíble biblioteca de visualización en Python para gráficos 2D de arrays. Matplotlib es una biblioteca de visualización de datos multiplataforma basada en arrays NumPy y diseñada para funcionar con la pila SciPy más amplia.

Matplotlib.pyplot.eventplot()

Esta función se usa a menudo para trazar líneas idénticas en una posición determinada. Estos gráficos, en general, se utilizan para representar eventos neuronales en neurociencia, donde más a menudo se denominan ráster de picos, ráster de puntos o gráfico ráster. Más a menudo, también se usa para mostrar el tiempo o el posicionamiento de múltiples conjuntos de eventos diferentes o discretos. Por ejemplo, las horas de llegada de los empleados cada día a una empresa cada mes o la fecha de los huracanes cada año durante la última década o siglo.

Sintaxis:: matplotlib.pyplot.eventplot(posiciones, orientación=’vertical’, desplazamientos de línea=2, longitudes de línea=2, ancho de línea= Ninguno, colores= Ninguno, estilos de línea=’sólido’, *, datos= Ninguno, **kwargs)

Parámetros:

• Posiciones: este parámetro es generalmente un objeto similar a una array 1D o D donde cada valor en la array representa un evento. Para una posición similar a una array 2D, cada fila corresponde a una fila o una columna de la línea que depende del parámetro de orientación. Es un parámetro requerido para este método.
• orientación: Es un argumento opcional que toma dos valores, ya sea ‘horizontal’ o ‘vertical’. Es responsable de controlar la dirección de las colecciones de eventos. Si el valor pasado de orientación es ‘horizontal’, las líneas están dispuestas horizontalmente en filas y son verticales, mientras que si el valor pasado es ‘vertical’, las líneas están dispuestas verticalmente en columnas y son horizontales.
• lineoffsets: este es un argumento opcional cuyo valor predeterminado es 1. Este parámetro se utiliza para trazar el desplazamiento del centro de las líneas a partir del origen, que son ortogonales a la orientación del gráfico. Acepta un escalar o secuencia de escalares como sus valores.
• linelengths: similar a lineoffsets, también es un parámetro opcional cuyo valor predeterminado es 1 y acepta escalar o una secuencia escalar como su valor. Se utiliza para establecer la altura total de las líneas. Establece los tramos de las líneas desde lineoffset – linelength/2 a lineoffset + linelength/2.
• linewidths: Es un parámetro opcional cuyo valor por defecto es Ninguno. Acepta escalar o secuencia escalar o Ninguno como valores. Se utiliza para establecer el(los) ancho(s) de línea de las líneas de eventos en puntos. Si se establece en Ninguno, el valor predeterminado es su configuración rcParams.
• colors: como su nombre indica, se utiliza para establecer los colores de las líneas de eventos. Es un parámetro opcional cuyo valor por defecto es Ninguno. Si el valor es Ninguno, el valor predeterminado es rcParams. Toma como valor el color, la secuencia de colores o Ninguno.
• linestyles: Es un parámetro opcional que toma como valor una string, tupla o una secuencia de strings o tuplas. El valor predeterminado para este parámetro es ‘sólido’. Las strings válidas para este parámetro son [‘sólidas’, ‘discontinuas’, ‘guionadas’, ‘punteadas’, ‘-‘, ‘–’, ‘-.’, ‘:’]. Las tuplas de guión deben tener la forma de (offset, onoffseq) donde onoffseq es una tupla de entrada y salida de tinta en puntos de longitudes iguales.
• **kwargs: Es un parámetro opcional. Generalmente acepta palabras clave de las propiedades de LineCollection.

Devolución:
este método devuelve una lista de objetos EventCollection que contiene la EventCollection que se agregó.

Nota: es importante tener en cuenta que para longitudes de línea, anchos de línea, colores y estilos de línea, si solo se proporciona un valor único, esos valores se aplican a todas las líneas, mientras que para un valor similar a una array es importante que tenga la misma longitud que posiciones y cada valor se aplica a la fila correspondiente de la array.

Ejemplo 1:

import numpy as np
import matplotlib.pyplot as plt
  
positions = np.array([2, 4, 6])[:,np.newaxis]
offsets = [2,4,6]
  
plt.eventplot(positions, lineoffsets=offsets)
plt.show()

Producción:

Ejemplo 2:

import numpy as np
import matplotlib.pyplot as plt
  
spike = 100*np.random.random(100)
plt.eventplot(spike, 
              orientation = 'vertical',
              linelengths = 0.8, 
              color = [(0.5,0.5,0.8)])

Producción: