Merge Data

Function Description

This step is used to merge multiple data lists into one list. For example, input three lists [A], [B], [C], and the merged output result is [A, B, C].

MergeData

Use Cases

This tool is used to merge data such as poses and numbers.

Inputs

  • Unnamed: First group of data lists to be merged. Supported data types include PoseList, NumberList, StringList, Vector3DList, BoolList, IndexList.

  • Unnamed: Second group of data lists to be merged. The actual number of input ports is determined by the “Port Count” parameter.

Outputs

  • Merged Data List: Consistent with the type of the input data lists.

Parameters

Port Count (1-16)

Sets the number of input ports, range [1,16]. When the input data dimension is smaller than the target dimension, the system automatically elevates the dimension of the input data to ensure compatibility between data of different dimensions during merging.

Dimension of Variable in Array

Specifies the dimension where the specific data element to be operated on is located in the nested list structure.

Data Dimension Description

For NumberList, StringList, Vector3DList, BoolList, IndexList:

[Dimension 1 [Dimension 0 Element1, Element2, Element3…], [Dimension 0 Element1, Element2, Element3…] ]

For PoseList: [Dimension 1 [Dimension 0 [x, y, z, qx, qy, qz, w]], [Dimension 0 [x, y, z, qx, qy, qz, w]] ]

Examples

There are 2 data of NumberList type, namely [[0,1],[2,3]] and [[4,5],[6,7]]. Use the merge tool to merge these two data.

For the first list:

Dimension 0 elements: 0, 1, 2, 3.

Dimension 1 elements: [0,1], [2,3]

Dimension 2 elements: [[0,1],[2,3]]

For the second list:

Dimension 0 elements: 4, 5, 6, 7;

Dimension 1 elements: [4,5],[6,7]

Dimension 2 elements: [[4,5],[6,7]]

When different “Dimension of Variable in Array” is set, the results are as follows:

Dimension of Variable in Array = 0

Elements with Dimension 1 index 0: [0,1] and [4,5],

Elements with Dimension 1 index 1: [2,3] and [6,7],

Merged result: [[0,1,4,5],[2,3,6,7]]

Dimension of Variable in Array = 1

Elements with Dimension 2 index 0: [[0,1],[2,3]] and [[4,5],[6,7]]

Merged result: [[0,1],[2,3],[4,5],[6,7]]

Dimension of Variable in Array = 2

Input data is 2-dimensional data. Since when “Dimension of Variable in Array” is greater than or equal to the input array dimension, dimension elevation occurs, the merged result is:

[[[0,1],[2,3]],[[4,5],[6,7]]]