pymovements.events.EventDataFrame#

class pymovements.events.EventDataFrame(data: pl.DataFrame | None = None, name: str | list[str] | None = None, onsets: list[int] | np.ndarray | None = None, offsets: list[int] | np.ndarray | None = None)[source]#

A DataFrame for event data.

Each row has at least an event name with its onset and offset specified.

__init__(data: pl.DataFrame | None = None, name: str | list[str] | None = None, onsets: list[int] | np.ndarray | None = None, offsets: list[int] | np.ndarray | None = None)[source]

Initialize an pymovements.events.event_dataframe.EventDataFrame.

Parameters:

  • data (pl.DataFrame) – A dataframe to be transformed to a polars dataframe. This argument is mutually exclusive with all the other arguments.

  • name (str) – Name of events

  • onsets (list[int]) – List of onsets

  • list[int] (offsets;) – List of offsets

Raises:

ValueError – If list of onsets is passed but not a list of offsets, or vice versa, or if length of onsets does not match length of offsets.

Methods

__init__([data, name, onsets, offsets])

Initialize an pymovements.events.event_dataframe.EventDataFrame.

add_event_properties(event_properties)

Add new event properties into dataframe.

Attributes

columns

List of column names.

event_property_columns

Event property columns for this dataframe.

schema

Schema of event dataframe.