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.
data2¶
Input data 2.
data3¶
Input data 3.
data4¶
Input data 4.
data5¶
Input data 5.
data6¶
Input data 6.
data7¶
Input data 7.
data8¶
Input data 8.
data9¶
Input data 9.
data10¶
Input data 10.
dataN¶
Additional input data.
outdata¶
Data to process.
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.
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.
required_inputs¶
Required number of inputs. If data is not received in at least this many inputs, None will be output for this tick.
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.
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.
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.
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.
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¶
Print diagnostic outputs about potential edge cases.
set_breakpoint¶
Set a breakpoint on this node. If this is enabled, your debugger (if one is attached) will trigger a breakpoint.
metadata¶
User-definable meta-data associated with the node. Usually reserved for technical purposes.