ETracker.record_event

ETracker.record_event(label)

Record timestamped experimental event during data collection.

Events are merged with gaze data based on timestamp proximity during save operations. Uses appropriate timing source for simulation vs. real eye tracker modes.

Parameters

Name	Type	Description	Default
label	str	Descriptive label for the event (e.g., ‘trial_start’, ‘stimulus_onset’).	required

Raises

Name	Type	Description
	RuntimeWarning	If called when recording is not active.

Examples

ET_controller.record_event('trial_1_start')
#  present stimulus 
ET_controller.record_event('stimulus_offset')

# ETracker.record_event { #DeToX.ETracker.record_event }

```python
ETracker.record_event(label)
```

Record timestamped experimental event during data collection.

Events are merged with gaze data based on timestamp proximity
during save operations. Uses appropriate timing source for
simulation vs. real eye tracker modes.

## Parameters {.doc-section .doc-section-parameters}

| Name   | Type         | Description                                                              | Default    |
|--------|--------------|--------------------------------------------------------------------------|------------|
| label  | [str](`str`) | Descriptive label for the event (e.g., 'trial_start', 'stimulus_onset'). | _required_ |

## Raises {.doc-section .doc-section-raises}

| Name   | Type                               | Description                             |
|--------|------------------------------------|-----------------------------------------|
|        | [RuntimeWarning](`RuntimeWarning`) | If called when recording is not active. |

## Examples {.doc-section .doc-section-examples}

```python
ET_controller.record_event('trial_1_start')
#  present stimulus 
ET_controller.record_event('stimulus_offset')
```