pymovements.measure.events.EventSamplesProcessor.process#

EventSamplesProcessor.process(events: DataFrame, samples: DataFrame, identifiers: str | list[str] | None = None, name: str | None = None) → DataFrame[source]#

Process event and gaze dataframe.

Parameters:

  • events (pl.DataFrame) – Event data to process event properties from.

  • samples (pl.DataFrame) – Samples data to process event properties from.

  • identifiers (str | list[str] | None) – Column names to join on events and samples dataframes. (default: None)

  • name (str | None) – Process only events that match the name. (default: None)

Returns:

polars.DataFrame with properties as columns and rows refering to the rows in the source dataframe.

Return type:

pl.DataFrame

Raises:

  • ValueError – If list of identifiers is empty.

  • RuntimeError – If specified event name name is missing from events.