RasterScaling

The raster scaling operator scales/unscales the values of a raster by a given slope factor and offset. This allows to shrink and expand the value range of the pixel values needed to store a raster. It also allows to shift values to all-positive values and back. We use the GDAL terms of scale and unscale. Raster data is often scaled to reduce memory/storage consumption. To get the "real" raster values the unscale operation is applied. Keep in mind that scaling might reduce the precision of the pixel values. (To actually reduce the size of the raster, use the raster type conversion operator and transform to a smaller datatype after scaling.)

The operator applies the following formulas to every pixel.

For unscaling the formula is: p_new = p_old * slope + offset. The key for this mode is mulSlopeAddOffset.

For scaling the formula is: p_new = (p_old - offset) / slope. The key for this mode is subOffsetDivSlope.

p_old and p_new refer to the old and new pixel value. The slope and offset values are either properties attached to the input raster or a fixed value.

An example for Meteosat Second Generation properties is:

  • offset: msg.calibration_offset
  • slope: msg.calibration_slope

Parameters

ParameterTypeDescriptionExample Value
slopeSlopeOffsetSelectionthe key or value to use for slope{"type": "metadataKey" "domain": "", "key": "scale" }
offsetSlopeOffsetSelectionthe key or value to use for offset{"type": "constant" "value": 0.1 }
scalingModemulSlopeAddOffset OR subOffsetDivSlopeselect scale or unscale mode"mulSlopeAddOffset"
outputMeasurement*(optional) Measurementthe measurement of the data produced by the operator{"type": "continuous", "measurement": "Reflectance","unit": "%"}

* if no outputMeasurement is given, the measurement of the input raster is used.

The RasterScaling operator expects exactly one raster input.

ParameterType
sourceSingleRasterSource

Types

The following describes the types used in the parameters.

SlopeOffsetSelection

The SlopeOffsetSelection type is used to specify a metadata key or a constant value.

ValueDescription
{"type": "auto"} *Use slope and offset from the tiles properties
{"type": "constant", "value": number}A constant value.
{"type": "metadataKey", "domain": string, "key": string}A metadata key to lookup dynamic values from raster (tile) properties.

* if set to "auto", the operator will use the values from the decicated (GDAL) raster properties for scale and offset.

Example JSON

{
  "type": "RasterScaling",
  "params": {
    "slope": {
      "type": "metadataKey",
      "domain": "",
      "key": "scale"
    },
    "offset": {
      "type": "constant",
      "value": 1.0
    },
    "outputMeasurement": null,
    "scalingMode": "mulSlopeAddOffset"
  },
  "sources": {
    "raster": {
      "type": "GdalSource",
      "params": {
        "data": "modis-b6"
      }
    }
  }
}