10.146. Split Data Array (By Tuple)

Group (Subgroup)

Data Manipulation (Memory/Management)

Description

This Filter splits a Data Array into several smaller arrays along a single tuple dimension. The user specifies how many tuples each output array should contain along that dimension; all other dimensions remain unchanged.

For example, given an array with tuple shape (4, 3):

{0} {1} {2}
{3} {4} {5}
{6} {7} {8}
{9} {10} {11}

with tuples for the output arrays set to 2 & 1 and split dimension set to 1 produces two new arrays with tuple shapes (4,2) and (4,1) respectively:

{0} {1}
{3} {4}
{6} {7}
{9} {10}

{2}
{5}
{8}
{11}

Output Container

The Output Container parameter controls where the resulting split arrays are placed:

New Data Group [0]: Creates a new DataGroup to hold the split arrays.
Existing Data Group [1]: Places the split arrays into an existing DataGroup selected by the user.
New Attribute Matrix [2]: Creates a new Attribute Matrix to hold the split arrays.
Existing Attribute Matrix [3]: Places the split arrays into an existing Attribute Matrix selected by the user.

An optional flag allows you to delete the original input array after splitting.

Looking to split by components instead?

See the Split Data Array (By Component) filter that separates each component into its own scalar array.

Tuple Counts

The per-output tuple counts are integers. The sum of all requested output counts along the split dimension must equal the input’s tuple count along that dimension.

Required Input Sources

Input Data Array – the array to split.

Input Parameter(s)

Parameter Name	Parameter Type	Parameter Notes	Description
Data Array	Array Selection	Allowed Types: int8, uint8, int16, uint16, int32, uint32, int64, uint64, float32, float64, boolean	The data array to split by tuples.
Output Container	Choices		Set the output container where the output split arrays will be stored.
Remove Original Array	Bool		Whether or not to remove the original data array after splitting
Split Dimension	Scalar Value	UInt64	The tuple shape dimension to split the arrays from the input data array.
Split Arrays: Split Dimension Counts	DynamicTable		How many tuples each output array should contain along the split dimension only.

• Enter one value per row; each row becomes a new split array. • The sum of all rows must equal the number of tuples in the input array’s split dimension.

Example: If the input array’s tuple shape is (100 × 200 × 300) and the filter is splitting along the first dimension (100), then Split Dimension Counts of 60 | 25 | 15 creates three output arrays whose tuple shapes are (60 × 200 × 300), (25 × 200 × 300), and (15 × 200 × 300) respectively. |

Output Parameter(s)

Parameter Name	Parameter Type	Description
New Data Group	DataGroupCreation	The path to the newly created data group where the output split arrays will be stored.
Existing Data Group	DataGroupSelection	The path to the existing data group where the output split arrays will be stored.
New Attribute Matrix	DataGroupCreation	The path to the newly created attribute matrix where the output split arrays will be stored.
Existing Attribute Matrix	AttributeMatrixSelection	The path to the existing attribute matrix where the output split arrays will be stored.
Output Attribute Matrix Tuple Shape	DynamicTable	The tuple shape for the output attribute matrix.

Example Pipelines

License & Copyright

Please see the description file distributed with this plugin.

DREAM3D‑NX Help

If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX‑Issues GitHub site where the community of DREAM3D‑NX users can help answer your questions.