Instant Bars

Summary

Doc_BoxAlgorithm_InstantBars.png
  • Plugin name : Instant Bars
  • Version : 1.0
  • Author : Yann Renard
  • Company : Mensia Technologies SA
  • Short description : Displays each and every input matrix as a series of colored bars, instantly. Channels are vertically distributed.
  • Documentation template generation date : Nov 2 2017

Description

The Instant Bars box displays input data in form of vertical level bars , one bar per value, one series of bar for each channel. The display is done instantly , meaning that whenever a new data block arrives, it is displayed in the visualization windows, filling all the vertical space. For lisibility (and esthetical) purpose, the bars are colored in a custom gradient (from left to right).

This box is especially suitable for displaying spectrum .

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

Inputs

1. Matrix

The 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 : Spectrum (0x1f261c0a, 0x593bf6bd)

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. 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 ]

3. Gain

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

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

4. Caption

Label to be displayed on top of the visualization window.

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

5. 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 ]

6. 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 : (0x3d3c7c7f, 0xef0e7129)
  • Default value : [ ${AdvancedViz_DefaultColorGradient} ]

Examples

In the following example, we compute the FFT of the input EEG signal and display it.

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

InstantBars_Example.png
Example of scenario using the Instant Bars to display spectrum

Miscellaneous