Instant Bitmap (3D Stream)


  • Plugin name : Instant Bitmap (3D Stream)
  • Version : 1.0
  • Author : Yann Renard
  • Company : Mensia Technologies SA
  • Short description : Displays the input matrices as a map of colored tiles, or bitmap, continuously.
  • Documentation template generation date : Dec 3 2018


The Instant Bitmap (3D Stream) box displays input data in form of 2D maps of colored blocks (or bitmap). Each time a matrix is received, its contents are displayed to fill the visualization. Depending on the input type, the three dimensions of the matrix will be ordonned differently. The bitmap colors are chosen according to a custom gradient.


1. Matrix

The input matrices to be displayed. Currently this box supports only the Time-Frequency stream.

  • Type identifier : Time-frequency (0x5a90816b, 0xff2aff72)

2. Markers

The second input expects stimulations. They will be displayed as colored vertical lines.

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


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


In the following example, we compute the Time-Frequency Analysis for a generated signal. You can find a commented scenario in the provided sample set, the scenario file name is InstantBitmap3DStream.mxs.

Example of scenario using the Instant Bitmap (3D Stream)