Skip to content

Split Multicomponent Attribute Array

Group (Subgroup)

DREAM3D Review (Memory/Management)


This Filter splits an \f$n\f$-component Attribute Array into \f$ n \f$ scalar arrays, where each array is one of the original components. Any arbitrary component array may be split in this manner, and the output arrays will have the same primitive type as the input array. The original array is not modified; instead, \f$ n \f$ new arrays are created. For example, consider an unsigned 8-bit array with three components:

{ v1 v2 v3 }, { v4 v5 v6 }, { v7 v8 v9 } ...

This Filter will produce three new scalar unsigned 8-bit arrays:

{ v1 }, { v4 }, { v7 } ...
{ v2 }, { v5 }, { v8 } ...
{ v3 }, { v6 }, { v9 } ...

The user must specificy a postfix string to add to the newly created arrays. For example, if the original multicomponent Attribute Array is named "Foo" and the postfix is set to "Component", this Filter will produce three new arrays named "FooComponent0", "FooComponent1", and "FooComponent2". The numbering will always be present regardless of how the postfix is set.

This Filter is the opposite operation of the Combine Attribute Arrays Filter, and the generalized version of the Extract Component as Attribute Array Filter.


Name Type Description
Postfix string Postfix to add to the end of the split Attribute Arrays; this value may be empty

Required Geometry


Required Objects

Kind Default Name Type Component Dimensions Description
Any Attribute Array None Any > (1) The multicomponent Attribute Array to split

Created Objects

Kind Default Name Type Component Dimensions Description
Attribute Arrays Input array name + Postfix + component number Same as input array (1) The set of scalar Attribute Arrays, equal to the number of components of the input Attribute Array

Example Pipelines

Please see the description file distributed with this plugin.

DREAM3D Mailing Lists

If you need more help with a filter, please consider asking your question on the DREAM3D Users mailing list: