Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ENH:MultiThresholdObjects: Add ability to set custom TRUE and FALSE values. #669

12 changes: 10 additions & 2 deletions src/Plugins/ComplexCore/docs/MultiThresholdObjects.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,11 +13,19 @@ An example of this **Filter's** use would be after EBSD data is read into DREAM.

For example, an integer array contains the values 1, 2, 3, 4, 5. For a comparison value of 3 and the comparison operator greater than, the boolean threshold array produced will contain *false*, *false*, *false*, *true*, *true*. For the comparison set { *Greater Than* 2 AND *Less Than* 5} OR *Equals* 1, the boolean threshold array produced will contain *true*, *false*, *true*, *true*, *false*.

It is possible to set custom values for both the TRUE and FALSE values that will be output to the threshold array. For example, if the user selects an output threshold array type of uint32, then they could set a custom FALSE value of 5 and a custom TRUE value of 20. So then instead of outputting 0's and 1's to the threshold array, the filter would output 5's and 20's.

**NOTE**: If custom TRUE/FALSE values are chosen, then using the resulting mask array in any other filters that require a mask array will break those other filters. This is because most other filters that require a mask array make the assumption that the true/false values are 1/0.

## Parameters ##

| Name | Type | Description |
|------|------|-------------|
| Name | Type | Description |
|--------------------------|-----------------|----------------------------------------------------------------------------------------------------------------|
| Data Arrays to Threshold | Comparison List | This is the set of criteria applied to the objects the selected arrays correspond to when doing the thresholding |
| Use Custom TRUE Value | bool | Specifies whether to output a custom TRUE value |
| Custom TRUE Value | float64 | The custom TRUE value (the default value is 1) |
| Use Custom FALSE Value | bool | Specifies whether to output a custom FALSE value |
| Custom FALSE Value | float64 | The custom FALSE value (the default value is 0) |

## Required Geometry ##

Expand Down
Loading
Loading