DREAM.3D v6 User Manual
|
Core (Memory/Management)
This Filter will "stack" any number of user-chosen Attribute Arrays into a single attribute array. The arrays must all share the same primitive type and number of tuples, but may have differing component dimensions. The resulting combined array will have a total number of components equal to the sum of the number of components for each stacked array. The order in which the components are placed in the combined array is the same as the ordering chosen by the user when selecting the arrays. For example, consider two arrays, one that is a 3-vector and one that is a scalar. The values in memory appear as follows:
Vector: tuple 1 - { v1 v2 v3 } ; tuple 2 - { v1 v2 v3 } ; tuple 3 - { v1 v2 v3 } ...
Scalar: tuple 1 - { s1 } ; tuple 2 - { s1 } ; tuple 3 - { s1 } ...
To have the components of the combined array contain the scalar values first, use the box and arrows to the right of the array selection to move the scalar array above the vector array:
After executing the Filter, the combined array will have component dimensions of 1 x 4, and will have values in memory as follows:
Combined (scalar first): tuple 1 - { s1 v1 v2 v3 } ; tuple 2 - { s1 v1 v2 v3 } ; tuple 3 - { s1 v1 v2 v3 } ...
To have the components of the combined array contain the vector values first, simply move the vector array above the scalar array:
After executing the Filter, the combined array will still have component dimensions of 1 x 4, and but now the values in memory are as follows:
Combined (vector first): tuple 1 - { v1 v2 v3 s1 } ; tuple 2 - { v1 v2 v3 s1 } ; tuple 3 - { v1 v2 v3 s1 } ...
The user may also select to normalize the resulting combined array. The normalization procedure will enforce a range of [0, 1] for all values in the combined array. This may be useful for combining two arrays that have different order of magnitude data. Note that this option will fundamentally change the underlying data in the combined array from the original incoming arrays.
Name | Type | Description |
---|---|---|
Standardize Data | bool | Whether to standardize the combine data on the interval [0, 1] |
Not Applicable
Kind | Default Name | Type | Component Dimensions | Description |
---|---|---|---|---|
Any Attribute Array | None | Any | Any | Attribute Arrays to combine |
Kind | Default Name | Type | Component Dimensions | Description |
---|---|---|---|---|
Any Attribute Array | CombinedData | Any | Any | Combined Attribute Array name |
Please see the description file distributed with this Plugin
If you need more help with a Filter, please consider asking your question on the DREAM.3D Users Google group!