SIPI Calculator

Block type: PROCESSING

This block takes photos from an optical satellite and calculates Structure Intensive Pigment Index (SIPI). It produces georeferenced single band GeoTIFF file with matrix containing SIPI values. Such files can be manually colorized in QGIS with singleband pseudocolor. It is possible to read SIPI value for particular pixel with Identify Features tool.

Supported parameters

  • satellite - the name of the block providing input data. See section Supported data blocks for valid values.

Example parameters using Sentinel-2 Level 2 (BOA) AOI clipped block as data source:

{
  "sentinelhub-s2-aoiclipped:1": {
    "time": "2018-05-07T16:47:48+00:00/2018-05-09T16:47:49+00:00",
    "limit": 1,
    "intersects": {
      "type": "Polygon",
      "coordinates": [
        [
          [
            18.726196,
            53.473489
          ],
          [
            18.720531,
            53.479312
          ],
          [
            18.708215,
            53.476043
          ],
          [
            18.719931,
            53.468431
          ],
          [
            18.73332,
            53.466183
          ],
          [
            18.739586,
            53.471854
          ],
          [
            18.726196,
            53.473489
          ]
        ]
      ]
    },
    "zoom_level": 14
  },
  "qzsolutions.sipi:1": {
    "satellite": "Sentinel-2 Level 2 (BOA) AOI clipped"
  }
}

Supported data blocks

Currently this block supports input from data blocks:

Landsat-8 Level 1 (TOA) AOI clipped

To see this block on up42 please click here.

Sample block parameters when using Landsat-8 Level 1 (TOA) AOI clipped data block:

{
  "satellite": "Landsat-8 Level 1 (TOA) AOI clipped"
}

Formula used for SIPI1 calculation: \((B05 - B01) / (B05 - B04)\)

Pléiades Download

To see this block on up42 please click here.

Sample block parameters when using Pléiades Download data block:

{
  "satellite": "Pleiades Download"
}

Warning

Please notice that satellite parameter does not contain ‘é’ character but ‘e’.

Formula used for SIPI1 calculation: \((NIR - B) / (NIR - R)\)

Sentinel-2 L1C MSI Full Scenes

To see this block on up42 please click here.

Sample block parameters when using Sentinel-2 L1C MSI Full Scenes data block:

{
  "satellite": "Sentinel-2 L1C MSI Full Scenes"
}

Formula used for SIPI1 calculation: \((B08 - B01) / (B08 - B04)\)

Sentinel-2 Level 2 (BOA) AOI clipped

To see this block on up42 please click here.

Sample block parameters when using Sentinel-2 Level 2 (BOA) AOI clipped data block:

{
  "satellite": "Sentinel-2 Level 2 (BOA) AOI clipped"
}

Formula used for SIPI1 calculation: \((B08 - B01) / (B08 - B04)\)

SPOT 6/7 Download

To see this block on up42 please click here.

Sample block parameters when using SPOT 6/7 Download data block:

{
  "satellite": "SPOT 6/7 Download"
}

Formula used for SIPI2 calculation: \((NIR - B) / (NIR - R)\)

Output format

The block produces a feature collection with up42.data_path property containing a name of the result file.

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

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "bbox": [
        18.69873046875,
        53.46189043285912,
        18.74267578125,
        53.48804553605621
      ],
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              18.720703125,
              53.46189043285912
            ],
            [
              18.69873046875,
              53.46189043285912
            ],
            [
              18.69873046875,
              53.47496999954854
            ],
            [
              18.69873046875,
              53.48804553605621
            ],
            [
              18.720703125,
              53.48804553605621
            ],
            [
              18.74267578125,
              53.48804553605621
            ],
            [
              18.74267578125,
              53.47496999954854
            ],
            [
              18.74267578125,
              53.46189043285912
            ],
            [
              18.720703125,
              53.46189043285912
            ]
          ]
        ]
      },
      "properties": {
        "up42.data_path": "16390e9a-a93a-4fbe-8d9a-17525d363afc.tiff",
        "acquisitionDate": "2018-05-08T09:50:28"
      }
    }
  ]
}

Capabilities

Input

This block has such input_capabilities:

"input_capabilities": {
  "raster": {
    "up42_standard": {
      "format": {
        "or": [
          "SAFE",
          "GTiff",
          "DIMAP"
        ]
      },
      "sensor": {"or": ["Landsat8", "Sentinel2", "SPOT", "Pleiades"]}
    }
  }
}

Warning

Please ensure that input block is listed under Supported data blocks section.

Output

This block has such output_capabilities:

"output_capabilities": {
  "raster": {
    "up42_standard": {
      "format": "GTiff",
      "dtype": "float",
      "resolution": ">"
    },
    "custom": {
      "bands": [
        "sipi"
      ]
    }
  }
}