8.111. Replace Value in Array (Conditional)
Group (Subgroup)
Core (Misc)
Description
This Filter replaces values in a user specified Attribute Array with a user specified value a second boolean Attribute Array specifies, but only when Use Conditional Mask is true. For example, if the user entered a Replace Value of 5.5, then for every occurence of true in the conditional boolean array, the selected Attribute Array would be changed to 5.5. If Use Conditional Mask is false, then Value to Replace will be searched for in the provided Attribute Array and all instances will be replaced. Below are the ranges for the values that can be entered for the different primitive types of arrays (for user reference). The selected Attribute Array must be a scalar array.
Primitive Data Types
Type |
Size |
Range |
|---|---|---|
Signed Integer |
8 bit |
0 to 255 |
Unsigned Integer |
8 bit |
-128 to 127 |
Signed Integer |
16 bit |
-32,768 to 32,767 |
Unsigned Integer |
16 bit |
0 to 65,535 |
Signed Integer |
32 bit |
-2,147,483,648 to 2,147,483,647 |
Unsigned Integer |
32 bit |
0 to 4,294,967,295 |
Signed Integer |
64 bit |
9,223,372,036,854,775,808 to 9,223,372,036,854,775,807 |
Unsigned Integer |
64 bit |
0 to 18,446,744,073,709,551,615 |
Float |
32 bit |
-3.4e+38 to -1.1e-38, 0.0, 1.1e-38 to 3.4e+38 (7 digits) |
Double |
64 bit |
-1.7e+308 to -2.2e-308, 0.0, 2.2e-308 to 1.7e+308 (15 digits) |
Boolean |
8 bit |
0 = false and any other value will be forced to 1 = true |
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
New Value |
String |
The value that will be used as the replacement value |
Optional Data Mask
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Use Conditional Mask |
Bool |
Whether to use a boolean mask array to replace values marked TRUE |
|
Invert Mask |
Bool |
This makes the filter replace values that are marked FALSE in the conditional array |
|
Conditional Array |
Array Selection |
Allowed Types: int8, uint8, boolean Comp. Shape: 1 |
The complete path to the conditional array that will determine which values/entries will be replaced if index is TRUE |
Value To Replace |
String |
The numerical value that will be replaced in the array |
Input Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Attribute Array |
Array Selection |
Allowed Types: int8, uint8, int16, uint16, int32, uint32, int64, uint64, float32, float64, boolean |
The complete path to array that will have values replaced |
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.