Continuous Oscilloscope

Summary

Doc_BoxAlgorithm_ContinuousOscilloscope.png
  • Plugin name : Continuous Oscilloscope
  • Version : 1.0
  • Author : Yann Renard
  • Company : Mensia Technologies SA
  • Short description : Displays the input matrices as a series of curves. Channels are vertically distributed.
  • Documentation template generation date : Nov 2 2017

Description

The Continuous Oscilloscope displays temporal numerical data in the form of curves, all the channels being distributed vertically, each one with its own horizontal axis. Channel are given a color, overlaps are rendered additively. The display is done continuously , meaning that once the end of the horizontal scale is reached, it goes back to the origin.

The Continuous Oscilloscope box shares common concepts and settings with the other boxes in the Mensia Advanced Visualization Toolset . Additional information are available in the dedicated documentation pages:

Inputs

1. Matrix

The first input can be a streamed matrix or any derived stream (Signal, Spectrum, Feature Vector). Please set the input type according to the actual stream type connected.

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

2. Markers

The second input expect stimulations. They will be displayed as red vertical lines .

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

Settings

1. Channel Localisation

The channel localisation file containing the cartesian coordinates of the electrodes to be displayed. A default configuration file is provided, and its path stored in the configuration token ${AdvancedViz_ChannelLocalisation}.

  • Type identifier : Filename (0x330306dd, 0x74a95f98)
  • Default value : [ ${AdvancedViz_ChannelLocalisation} ]

2. Temporal Coherence

Select Time Locked for a continuous data stream, and specify the time scale below. Select Independent for a discontinuous data stream, and specify the matrix count below.

  • Type identifier : Temporal Coherence (0x8f02e3f6, 0xffb00f4b)
  • Default value : [ Time Locked ]

3. Time Scale

The time scale in seconds, before the displays goes back to the origin.

  • Type identifier : Float (0x512a166f, 0x5c3ef83f)
  • Default value : [ 20 ]

4. Matrix Count

The number of input matrices to receive before the displays goes back to the origin.

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

5. Positive Data Only ?

If this checkbox is ticked, the vertical scale is shifted so that 0 is at the bottom. Only positive values will be displayed.

  • Type identifier : Boolean (0x2cdb2f0b, 0x12f231ea)
  • Default value : [ false ]

6. Gain

Gain (floating-point scalar factor) to apply to the input values before display.

  • Type identifier : Float (0x512a166f, 0x5c3ef83f)
  • Default value : [ 1 ]

7. Caption

Label to be displayed on top of the visualization window.

  • Type identifier : String (0x79a9edeb, 0x245d83fc)
  • Default value : [ ]

8. Translucency

This setting expect a value between 0 and 1, from transparent to opaque color rendering (nb: this value is the alpha component of the color).

  • Type identifier : Float (0x512a166f, 0x5c3ef83f)
  • Default value : [ 1 ]

9. Color

Color gradient to use. This setting can be set manually using the color gradient editor. Several presets exist in form of configuration tokens ${AdvancedViz_ColorGradient_X}, where X can be:

  • Matlab or Matlab_Discrete
  • Icon or Icon_Discrete
  • Elan or Elan_Discrete
  • Fire or Fire_Discrete
  • IceAndFire or IceAndFire_Discrete

The default values AdvancedViz_DefaultColorGradient or AdvancedViz_DefaultColorGradient_Discrete are equal to </t>Matlab and Matlab_Discrete.

An example of topography rendering using these color gradients can be found here.

  • Type identifier : (0x7f45a2a9, 0x7db12219)
  • Default value : [ ${AdvancedViz_DefaultColor} ]

Examples

In the following example, we filter the input signal in the 8-15 Hz frequency range and simply display it.

You can find a commented scenario in the provided sample set, the scenario file name is {ContinuousOscilloscope.mxs}.

ContinuousOscilloscope_Example.png
Example of scenario using the Continuous Oscilloscope

Miscellaneous