Block Overview

Block type: PROCESSING

This block uses satellite imagery data and generates RGB georeferenced images using formulas provided as parameters. The output can be opened in standard images viewer and GIS tools like QGIS or ArcGIS.

Input parameters

  • red - the formula used for calculating values of red channel, see formulas for valid values

  • green - the formula used for calculating values of green channel

  • blue - the formula used for calculating values of blue channel

  • satellite - the name of the block providing input data, see supported blocks for valid values

The formula should be a mathematical expression containing: band names, operators and functions. More information about formulas can be found in formulas section. To see list of available bands and sample usage please visit supported blocks section.

Example parameters using Sentinel-2 Level 2 (BOA) AOI clipped block as data source and then generating false color composite:

{
  "sentinelhub-s2-aoiclipped:1": {
    "bbox": [
      19.845642734130864,
      52.30976947421495,
      19.881949734130865,
      52.32649747421495
    ],
    "time": "2018-01-01T00:00:00+00:00/2019-11-20T23:59:59+00:00",
    "limit": 1,
    "zoom_level": 14,
    "time_series": null
  },
  "qzsolutions.mixer-rc:1": {
    "red": "B08/256",
    "blue": "B04/256",
    "green": "B03/256",
    "satellite": "Sentinel-2 Level 2 (BOA) AOI clipped"
  }
}

Output format

The block produces a feature collection with up42.data.aoiclipped property containing a name of the result file. The result file is RGB GeoTIFF with 8 bit resolution channels.

Warning

Values are expected to be between 0 and 255. Results of the formula of specific pixel will be clipped to 0 for results below 0. Values above 255 will be clipped to 255.

For most of satellites it also returns property acquisitionDate containing date of image being taken.

Contents of data.json file returned by a block configured in the previous example:

{
  "type":"FeatureCollection",
  "features":[
    {
      "type":"Feature",
      "bbox":[
        19.84130859375,
        52.308478623663355,
        19.88525390625,
        52.335339071889386
      ],
      "geometry":{
        "type":"Polygon",
        "coordinates":[
          [
            [
              19.86328125,
              52.308478623663355
            ],
            [
              19.84130859375,
              52.308478623663355
            ],
            [
              19.84130859375,
              52.32191088594772
            ],
            [
              19.84130859375,
              52.335339071889386
            ],
            [
              19.86328125,
              52.335339071889386
            ],
            [
              19.88525390625,
              52.335339071889386
            ],
            [
              19.88525390625,
              52.32191088594772
            ],
            [
              19.88525390625,
              52.308478623663355
            ],
            [
              19.86328125,
              52.308478623663355
            ]
          ]
        ]
      },
      "properties":{
        "up42.data.aoiclipped":"86973862-61e8-4233-82f4-2c60049dee2e.tiff",
        "acquisitionDate":"2019-11-19T09:56:09"
      }
    }
  ]
}
Contents of file 86973862-61e8-4233-82f4-2c60049dee2e.tiff

Contents of file 86973862-61e8-4233-82f4-2c60049dee2e.tiff

Capabilities

Input

As this block supports various blocks it has no input_capabilities.

Warning

The workflow editor allows to connect incompatible data input block. Please ensure that input block is listed under supported blocks link.

Output

This block has a single output capability, up42.data.aoiclipped.