Instant Bitmap

Summary

Doc_BoxAlgorithm_InstantBitmap.png
  • Plugin name : Instant Bitmap
  • Version : 1.0
  • Author : Yann Renard
  • Company : Mensia Technologies SA
  • Short description : Displays each and every input matrix as a map of colored tiles, or bitmap, instantly.
  • Documentation template generation date : Apr 11 2018

Description

The Instant Bitmap box displays input data in form of a 2D map of colored blocks (or bitmap). The display is done instantly , meaning that whenever a new data block arrives, it is displayed in the visualization windows, filling all the horizontal space. The bitmap colors are chosen according to a custom gradient.

The Instant Bitmap 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. 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 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 {InstantBitmap.mxs}.

InstantBitmap_Example.png
Example of scenario using the Instant Bitmap to display spectrum

Miscellaneous