3D Cubes

Summary

Doc_BoxAlgorithm_3DCubes.png
  • Plugin name : 3D Cubes
  • Version : 1.0
  • Author : Yann Renard
  • Company : Mensia Technologies SA
  • Short description : The input is mapped to a 3D representation of the EEG setup where electrodes are symbolized with cubes, using a color gradient and interpolation.
  • Documentation template generation date : Nov 2 2017

Description

The 3D Cubes box displays the data in a topographic view, where each channel (correctly identified and positionned thanks to a channel localisation file) is associated with a cube. All the cubes are positionned in a 3D space according to the corresponding positions of the electrodes on the scalp. The input data is displayed through 2 modalities:

  • the cubes color
  • the cubes size

The cube size varies according to the same - absolute - range as the color, i.e. high negative or positive values will be displayed as big cube while values close to zero with be displayed as small cubes.

The 3D Cubes 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 box 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)

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

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

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

3. Caption

Label to be displayed on top of the visualization window.

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

4. 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 band power of the signal in the 8-15 Hz frequency range, and average it over the last 32 epochs received.

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

3DCubes_Example.png
Example of scenario using the 3D cubes

Miscellaneous