SeriesMerger
SeriesMerger
The SeriesMerger is a sequencer block, that collects different data series received via different input events and outputs them merged via a single output event.
The SeriesMerger is useful when you have to merge multiple event series (i.e. arrays of data) into a single, merged event series (i.e. merge the elements of different arrays into one array).
Events
| Name | Input/Output | Description |
|---|---|---|
| Any user-added input event | Input | Data value(s) from this event will be collected as the merged series data and will be sent out as combined via Merged events data, after incoming Merge event received. |
| Merge | Input | Will cause all collected input event data to be merged and sent out to via Merged event, one-by-one |
| Merged | Output | Different input event merged data will be emitted one-by-one via this event, after Merge received |
| MergeDone | Output | Will be emitted after all Merged events have been sent out |
| Init | Predefined input event | Will clear all collected pending user events, then emits Inited |
| Inited | Predefined output event | Will be emitted after Init is done |
Arguments
| Name | Description |
|---|---|
| Any user-configurable input argument | Data argument for input series, that need to be merged. Note, that the argument must be selected as data for the corresponding input event. Note also, that all the arguments must be selected as data for the Merged output event. This is done by clicking into the event's Data property and by selecting the argument name. |
Example
For example, let's assume we have to merge 2 separate event series - signals series having values named signal and equally sized values series having values named value - into one merged series where every element has 2 values signal and value. To merge them, we must configure a SeriesMerger block with 2 added input events: signals event, that has a data argument signal and the values event that has a data argument value. The signal and the value argument must also be configured as data arguments for Merged event.
The following table shows some example input series events that were sent to the block and also the corresponding merged output series events that were emitted by the block in response:
| Timestamp (in increasing order) | Input event (with argument values) | Output event (with argument values) |
|---|---|---|
| `T_1` | signals (signal=Sig1) | |
| `T_2` | signals (signal=Sig2) | |
| `T_3` | signals (signal=Sig3) | |
| `T_4` | values (value=1.23) | |
| `T_5` | values (value=2.34) | |
| `T_6` | values (value=3.45) | |
| `T_7` | Merge | Merged (signal=Sig1,value=1.23) |
| Merged (signal=Sig2,Value=2.34) | ||
| Merged (signal=Sig3,Value=3.45) | ||
| MergeDone |
Get started with CDP Studio today
Let us help you take your great ideas and turn them into the products your customer will love.