RasterBandNodataSetter

Identifies a value to act as a nodata identifier on a raster feature at the band level. That is, values equal to the specified value will now be considered invalid, and will not be affected by many operations (for example, offsetting or scaling).

All selected bands on an input raster feature will receive the same specified nodata value.

Input Ports

Input

Input features must contain raster geometries only.

Parameters

Nodata Value

A numeric value specifying the nodata value to be set on the input raster. This parameter sets the nodata value and discards the original nodata value if it exists.

If the raster's bands have palettes, the function will succeed in setting a new nodata value only if the value is of a key that already exists on the band. To replace all occurrences of the original nodata value with a new value, use the RasterCellValueReplacer.

Replace Cell Values

If No, no cell values in the raster are changed. If Yes, cells that used to be equal to the old nodata value are changed to the new nodata value.

For example, consider a raster with values [1 2 3], in which the nodata value is initially 1 and we are setting it to 2.

If this option is No, the raster will still have values [1 2 3], and 2 is the new nodata value. That is, the cell with a value of 1 that previously was nodata is now a valid value.

If this option is set to Yes, the raster will have values [2 2 3] , and 2 is the new nodata value. That is, the cell with a value of 1 that previously was nodata is still nodata, but now has a different raw value.

Usage Notes

• This transformer supports raster band selection: see the RasterSelector.
• If different nodata values are desired on each band (for example, when setting nodata values on a color raster, where each of the red, green, and blue bands has a different value), then add multiple RasterBandNodataSetter transformers using either different band selections, or by using raster band splitting to separate the bands on which to set the nodata value.

• This transformer does not set the nodata value on the palette level. To set the nodata value on the palettes of a raster, use the RasterPaletteNodataSetter.

Search FME Knowledge Center

Search for samples and information about this transformer on the FME Knowledge Center.

Tags Keywords: raster grid band channel palette key lookup LUT colormap colourmap nodata null void value set modify flag