Stage 03 - Trigger Detection

This stage detects the potential passing of wavefronts on each channel (for example, transitions between Down and Up states) as trigger times.

config template

Input

A neo.Block and Segment object containing an AnalogSignal object containing all signal channels (additional AnalogSignal objects are ignored).

should pass check_input.py

Output

The same input data object, but extended with a neo.Event object named ‘transitions’, containing

  • times: time stamps where a potential wavefront, i.e., state transition, was detected,

  • labels: either UP or DOWN,

  • annotations: information about the detection methods and copy of AnalogSignal.annotations,

  • array_annotations: channels and the array_annotations of the AnalogSignal object that correspond to the respective channels.

The output neo.Block is stored in {output_path}/{profile}/stage03_trigger_detection/trigger_times.{NEO_FORMAT}.

The intermediate results and plots of each processing block are stored in the {output_path}/{profile}/stage03_trigger_detection/{block_name}/.

Usage

In this stage offers alternative trigger detection methods (choose one), which can be selected via the DETECTION_BLOCK parameter. There are additional filter blocks to post-process the detected triggers, they can be selected (choose any) via the TRIGGER_FILTER parameter.

Blocks

Utility Blocks (fixed)

check_input

Check whether the input data representation adheres to the stage's requirements.

plot_trigger_times

Plot an excerpt of the input data and corresponding trigger times.

Detection Blocks (choose one)

hilbert_phase

Detect trigger times (i.e., state transition / local wavefronts onsets) by finding crossing of a set phase-value in the channel signals.

minima

Detect trigger times (i.e., state transition / local wavefronts onsets) by finding local minima preceding a prominent peak in the channel signals.

threshold

Detect trigger times (i.e., state transition / local wavefronts onsets) by applying a threshold to each channel signal.

Trigger Filter Blocks (choose any)

remove_short_states

Remove detected triggers (state transitions) when the corresponding Up and Down states are shorter than a minimum duration.