Signal Concatenation

Summary

Doc_BoxAlgorithm_SignalConcatenation.png
  • Plugin name : Signal Concatenation
  • Version : 2.0
  • Author : Laurent Bonnet
  • Company : INRIA
  • Short description : Concatenates multiple signal streams
  • Documentation template generation date : Nov 2 2017

Description

The signal stream concatenation box reads multiple streams in parallel, and produces a single stream that is the concatenation of all inputs.

The input streams must share the same characteristics : sampling frequency, number of channels, sample count per block. User can specify a time-out value beyond which a stream is considered as finished if no samples are received. If user wants a specific part of a given stream, he can specify a stimulation used as end-of-stream trigger.

The status stimulation output deliver the stimulation OVTK_StimulationId_EndOfFile when the concatenation is finished. You can connect this output to a BoxAlgorithm_PlayerController to script your concatenation easily.

Inputs

The box has a pair of input (signal, stimulation) per source.

1. Input signal 1

Signal stream from source #1.

  • Type identifier : Signal (0x5ba36127, 0x195feae1)

2. Input stimulations 1

Stimulation stream from source #1.

  • Type identifier : Stimulations (0x6f752dd0, 0x082a321e)

3. Input signal 2

Signal stream from source #2.

  • Type identifier : Signal (0x5ba36127, 0x195feae1)

4. Input stimulations 2

Stimulation stream from source #2.

  • Type identifier : Stimulations (0x6f752dd0, 0x082a321e)

Outputs

1. Signal

Concatenated signal stream.

  • Type identifier : Signal (0x5ba36127, 0x195feae1)

2. Stimulations

Concatenated stimulation stream.

  • Type identifier : Stimulations (0x6f752dd0, 0x082a321e)

3. Status

Status stimulation stream (sends OVTK_StimulationId_EndOfFile on success).

  • Type identifier : Stimulations (0x6f752dd0, 0x082a321e)

Settings

A stimulation setting is added for each input pair.

1. Time out before assuming end-of-file (in sec)

If no samples are received beyond this time-out value, a stream is considered as finished.

  • Type identifier : Integer (0x007deef9, 0x2f3e95c6)
  • Default value : [ 5 ]

2. End-of-file stimulation for input 1

Stimulation that triggers the end-of-stream for source #1.

  • Type identifier : Stimulation (0x2c132d6e, 0x44ab0d97)
  • Default value : [ OVTK_StimulationId_ExperimentStop ]

3. End-of-file stimulation for input 2

Stimulation that triggers the end-of-stream for source #2.

  • Type identifier : Stimulation (0x2c132d6e, 0x44ab0d97)
  • Default value : [ OVTK_StimulationId_ExperimentStop ]

Examples

This box is mainly designed to concatenate multiple signal files. For example, you have 10 sessions of training and you want to train a classifier on the whole set of data. You can use the Signal Stream Concatenation to produce one EEG file containing the 10 sessions, and then feed a Classifier trainer box with it.

Miscellaneous