Split Multicomponent Attribute Array¶
Group (Subgroup)¶
DREAM3D Review (Memory/Management)
Description¶
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.
Parameters¶
| Name | Type | Description |
|---|---|---|
| Postfix | string | Postfix to add to the end of the split Attribute Arrays; this value may be empty |
Required Geometry¶
None
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¶
License & Copyright¶
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: