ProRaster Help – Data Conditioning Editor
On this page, you will find general help for the ProRaster product family including links to documentation, instructional videos, and training videos.
Previous Topic: The Data Transform Editor
Next Topic: The Projection Explorer
Back to: ProRaster Help
Back to: ProRaster
Go to: ProRaster Essential help page, ProRaster Premium help page, ProRaster Scientific help page.
The ProRaster User Guide is available for download as a PDF.
Using the Data Conditioning Filter dialog
In every component, you can select a Data Conditioning Filter to apply to the raster data (specified by your selection of the raster source, field, band, and time range). This filter is applied to the data prior to the data – color transform.
The primary purpose of a Data Conditioning Filter is to remove invalid or unwanted data values from the data stream prior to rendering. These are the operations that are allowed, and the order in which they are applied:
- Reject values
You can define one or more values that will be rejected. If a data value matches one of the listed values to reject, it will be registered as invalid.
- Reject ranges
You can define one or more ranges of values that will be rejected. If a data value is >= the minimum value in a range and <= the maximum value of that range, it will be registered as invalid. This can also be reversed so that values are rejected if outside of the range rather than inside the range.
- Reject color ranges
For 1, 2, 3, and 4-byte color data values, like RGB or RGBA, you can define color ranges that will be rejected. In this case, you define the color you want to reject and an envelope about this color that will also result in rejection. For example, if the color component value is 64 and the envelope is 8, then values from 56 to 72 will be rejected. The envelop will be clipped at zero and 255. This can also be reversed so that values are rejected if outside of the range rather than inside the range.
- Convert to background
If a data value is invalid at this point in the processing, it can now be converted to a “background value” and made valid.
- Cap values below minimum
If a data value is valid and below a minimum cap, it is set to the minimum cap value.
- Cap values above maximum
If a data value is valid and above a maximum cap, it is set to the maximum cap value.
The editor dialog presents you with a list of known filters. First in the list, above the dotted line, will be any filters that have been loaded from the current MRD algorithm. Below the dotted line will be any filters that you have defined and saved via the editor dialog. Select a filter to edit it.
Buttons are provided to add a new filter, delete the current filter, or clone the current filter. You would use the clone operation to save a copy of a filter that you have loaded from an MRD file. You can also delete all filters. If you do this accidentally, make sure you hit Cancel to exit the editor dialog. No changes are saved until you exit the dialog by hitting the OK button.
When you add a new filter, you must immediately give it a unique name, because filters are referred to by name in the algorithm XML. As you type the name, the dialog will indicate whether it is unique and valid or non-unique.
You can then define the six filter parameters as described above – values, value ranges, color ranges, background value and caps. For example, enter a new value and then hit the “Add” button to add it to the list of rejected values.
Once you have defined your data conditioning filters, you will be able to select them by name for every component in your rendering algorithm.