ConcatInputs¶
Concatenate the given data (packets, chunks, blocks, arrays or lists) along a new or existing axis.
It is assumed that all data ports are either None or carry items of the same type and, in case of packets, with the same number and type of chunks, and the chunks to be concatenated have the same number of elements along all axes except for the one along which they are concatenated. Any meta-data is copied from the packet on the first input data port (in sequential order) that is non empty. If properties are specified, they will be applied to the axis of concatenated chunks whether or not a new axis is appended. If a new axis is created and the properties parameter is empty, sequential integers will be used as values. If append new axis is selected, the output will have two axes of the same type, one containing the concatenated values, and the other having the values of the first non-empty data port. This node has 10 input ports that can be wired into simultaneously, but can also take a list of packets, in addition or instead of the data ports, in the "dataN" port. If the node is given dictionaries (structures) to concatenate, all dictionaries must have the same fields, and the node will create a structure of arrays (SoA), meaning that the output is a dictionary with the same keys and each key is the concatenation of the values of that key in the input dictionaries. To merge dictionaries with unlike keys, use the DictMerge node. If scalar values are given, they will be concatenated into a list (regardless of the create_new and axis settings), and if sets are given, they will be unioned unless the create_new (axis) option is chosen, in which case they will be concatenated into a list of sets. Version 1.5.1
Ports/Properties¶
data1¶
Input data 1.
- verbose name: Data1
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data2¶
Input data 2.
- verbose name: Data2
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data3¶
Input data 3.
- verbose name: Data3
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data4¶
Input data 4.
- verbose name: Data4
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data5¶
Input data 5.
- verbose name: Data5
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data6¶
Input data 6.
- verbose name: Data6
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data7¶
Input data 7.
- verbose name: Data7
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data8¶
Input data 8.
- verbose name: Data8
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data9¶
Input data 9.
- verbose name: Data9
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
data10¶
Input data 10.
- verbose name: Data10
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: IN
dataN¶
Additional input data.
- verbose name: Datan
- default value: None
- port type: DataPort
- value type: list (can be None)
- data direction: IN
outdata¶
Data to process.
- verbose name: Outdata
- default value: None
- port type: DataPort
- value type: AnyIndexable (can be None)
- data direction: OUT
axis¶
Axis along which to concatenate data. All items must be of the same type and compatible dimensions (meaning, of same dimension for all but the concatenation axis). For plain numeric data and collections, the typed axes are ignored and behave as if axis 0 was selected.
- verbose name: Concatenate Along Axis
- default value: time
- port type: ComboPort
- value type: str (can be None)
create_new¶
Whether to create a new axis. If enabled, a new axis of the desired kind will be inserted and data will be concatenated along that axis.
- verbose name: Append New Axis
- default value: True
- port type: BoolPort
- value type: bool (can be None)
required_inputs¶
Required number of inputs. If data is not received in at least this many inputs, None will be output for this tick.
- verbose name: Required Inputs
- default value: 0
- port type: IntPort
- value type: int (can be None)
chunk_props¶
What properties to write into the returned chunks. If 'first', the properties of the first matching input will be used. If 'merged', the properties are merged across all successive inputs, where later properties override earlier ones.
- verbose name: Assign Chunk Props
- default value: first
- port type: EnumPort
- value type: str (can be None)
new_axis_custom_label¶
You can optionally specify a custom_label for the newly created axis, to distinguish it from the original axis. This and the subsequent options apply only to packets.
- verbose name: New Axis Custom Label
- default value: None
- port type: StringPort
- value type: str (can be None)
properties¶
Values for the primary property of the new axis, if any. For instance, this would be a list of channel names if the axis is 'space'. If not given and a new axis is inserted, successive integers starting from 0 will be used as the values (so if this is e.g., a frequency axis, then the frequencies will be 0, 1, 2, and so on up to the number of packets that are concatenated.
- verbose name: Values For New Axis
- default value: None
- port type: ListPort
- value type: list (can be None)
correct_order¶
Correct axis order. If this is enabled, then axes will be re-ordered to match the axis order in the first data port. This only works if axes do not occur more than once in each block.
- verbose name: Correct Order
- default value: True
- port type: BoolPort
- value type: bool (can be None)
allow_markers¶
Enable to allow concatenation of streams with markers. If set to auto, this will be enabled if and only if all packets have only marker streams.
- verbose name: Allow Markers
- default value: auto
- port type: EnumPort
- value type: str (can be None)
verbose¶
Print diagnostic outputs about potential edge cases.
- verbose name: Verbose
- default value: True
- port type: BoolPort
- value type: bool (can be None)
set_breakpoint¶
Set a breakpoint on this node. If this is enabled, your debugger (if one is attached) will trigger a breakpoint.
- verbose name: Set Breakpoint (Debug Only)
- default value: False
- port type: BoolPort
- value type: bool (can be None)
metadata¶
User-definable meta-data associated with the node. Usually reserved for technical purposes.
- verbose name: Metadata
- default value: {}
- port type: DictPort
- value type: dict (can be None)