Polybench® for biosignals / reference 1.34.1
Copies a sub-selection of input channels to the output. If the input channels change, the output changes as well.

Channel Splitter

Overview

This is the most basic operator to split a selection of channels from an input bus. The Channel Splitter cannot change the order of channels, nor can it change the channel names or units.
The selection of channels is based on the position of those channels in the input channel list.

Operator ports

Input All: Any sample type. The connection is not limited to one type of signal.

Output All(a..z): Any sample type. The connection is not limited to one type of signal.

Properties

Find more information about changing properties here: "Properties Viewer"

AutoEnable
type: See description [this value cannot be changed]
Describes which channels should automatically be enabled, if those channels are available at the input. Uses set theory notation. Examples: {1,2,3,4,5}, {2,4,...} (all even channels), {n-3,...,n} (last 4 channels).

For more information on the notation, see "Set algebra parser".

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

For more information about the rules and usage of the Caption property, please refer to "Caption property - background and usage".

Documentation
type: See description
Optional documentation of this object. If this object is an operator, the Documentation text is displayed below the operator symbol.


Special dialog to change properties of this object: Enable/Disable channels


Variable Parameters

Find more information about Variable Parameters here: "Variable Parameters"

EnabledChannels
type: Parameter list (see "Parameter List")
This list shows which channels are enabled in the splitter (1) and which are not (0).

Using a "SET_PARAMETER" action you may change the selection of channels from within your application. Write a 1 (pseudo-boolean True) to an item in this list to select the channel, or write a 0 (pseudo-boolean False) to disable.

AutoEnable
type: See description
Describes which channels should automatically be enabled, if those channels are available at the input. Uses set theory notation. Examples: {1,2,3,4,5}, {2,4,...} (all even channels), {n-3,...,n} (last 4 channels).

For more information on the set notation, see "Set algebra parser".

EnabledChannelsSet
type: See description
Currently enabled channels written in set notation. The first channel has number 1.

For more information on the set notation, see "Set algebra parser".

Details

An overview of channel splitting operators can be found here: "When to use Channel Terminal, Splitter or Name Splitter"

Output channel names and units are copied from the input of the Channel Splitter. If names or units at the input change, the changes are put through to the output.

If you require more control over a selection of channels, you have to use the Channel Name Splitter ("Channel Name Splitter") or the Channel Terminal ("Channel Terminal").

Examples

Example: Channel Splitter control using Set Theory notation (demo)
This demo shows how a Channel Splitter can be set to enable all channels that are NOT selected by two other Channel Splitters.
The third splitter can do so using an Action (press the button), that reads the channel sets of the first two splitters and then sets the AutoEnable variable with a formula in set-theory notation.
Examples\DF0204026_001_Splitter_Control_With_Set_Notation_Demo.xmc