Polybench® Reference
Displays an electrode representation for each input channel and changes the electrode colors according to the input signals.

Electrode Map


This viewer draws electrode images for every channel on a background object. The background may contain an image.
During design time, but optionally also at end-user run time, the electrode positions can be changed.

Operator ports

Input Colors: Specific sample type, see below.

Paired User Interface Object

This operator is loaded simultaneously with a user interface object. The user interface object can be moved to another page, and would normally be displayed in the end-user application. The operator and this user interface object can never be separated. If you delete the operator, the user interface is deleted automatically as well. Note that you cannot delete the user interface, only the operator symbol!


Find more information about changing properties here: link

type: Integer value
default size of the electrodes in a value between 0 and 1000. 1000 means that the electrode would fill the entire map.

type: True or False
Set to false if the user should not be able to move the electrodes on the electrode map
Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'

type: Known image name
The name of the background image. The image name can be selected from the Image Repository (press the small button).

This property uses the Image Repository. For more information about the use of images in a project, refer to link

type: Known color name
Color name from the color repository

This property uses the Color Repository. For more information about the use of colors in a project, refer to link

type: Known color name
Color name from the color repository

This property uses the Color Repository. For more information about the use of colors in a project, refer to link

type: Known color name
Default color for every electrode; this is a color name from the color repository

This property uses the Color Repository. For more information about the use of colors in a project, refer to link

type: See description
Border style from the border repository to define the outer border. Leave empty to have no border.

type: Known text font name
Normal text font name from the font repository.

This property uses the Font Repository. For more information about the use of text fonts in a project, refer to link

type: Select from the list
The position of the text in relation to the electrode symbol it belongs to.
Select one of those presets:
The text is displayed above the electrode
The text is displayed right from the electrode
The text is displayed below the electrode
The text is displayed left from the electrode

type: Word or phrase
The name of the object in the project. This name must not contain '.' or '$' characters.

Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.

type: See description
Optional documentation of this object.

It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.

Extra dialog to change properties of this object: Default layouts


The Electrode Map operator has a Color input, and not a signal input. To convert signals to colors, use the Signal to Color operator (link), which provides a number of color schemes that can be used to color the electrodes on the map.

After connecting the Electrode Map operator to the color signal, electrode symbols are displayed on one side of the map. You should then drag the electrodes one by one to the place you want them to have. To be able to drag the electrodes, the Editable property should be set to True.

A common use of the Electrode Map is to display the electrodes on positions on a background image. You can load a background image in the Image Repository, and then select that image in the property BackgroundImage.

The size of all electrodes can be changed. Used is a sizing scale between 0 and 1000, where 0 is invisible and 1000 for filling up the entire map area. If you change the size of the entire map, you will see that the electrodes scale. This is because there size is relative to the map size.

The properties dialog of the Electrode Map offer functions to align the electrodes along the left, top, right or bottom border of the map. You will probably have to select an appropriate position of the electrode texts, which can be done with the property TextPosition.

After loading of a project with an Electrode Map, and if the system gets a RESET action, the Electrode Map shows all electrodes with the same color, which is the color specified in the property ElectrodeDefaultColor.

User Interface Object on Printable Pages

The user interface of this component will not be printed on a report if it is put on a Printable Page (see link). The reason for that, is that the object is especially designed for use on screens, and does not have a function on paper.

Behaviour in relation to the data cursor in reviewed data

This object reacts on a change of the central Data Cursor of a group of synchronized objects. This means that if this object has the same SyncID as the object that changes the Data Cursor, then this object will change its state accordingly. For more information see also: link.