Pansharpen

Pansharpens images from Pléiades / SPOT Reflectance (Download) or Sentinel-2 L2A Analytic (GeoTIFF).


Description

A processing block that creates a single high resolution color image from high resolution panchromatic and lower resolution multispectral image bands.

See this block on the marketplace.

Compatibility

Data blocks

Catalog collections

Use in combination with Processing from Storage.

How it works

Pansharpening is a fusion process that combines a high resolution panchromatic band with a multispectral band. The result of the process is a high resolution image with preserved spectral characteristics. Pansharpening can be useful before applying certain segmentation or classification algorithms.

  • With Pléiades and SPOT collections

    The process uses panchromatic and multispectral bands acquired at the same time by the same sensor, so the result image retains the high spatial resolution of the panchromatic image and the spectral information from the multispectral image.

  • With Sentinel-2 data block

    There is no panchromatic band in Sentinel-2 images, so a synthetic panchromatic band is used to increase the spatial resolution of the 20 m and 60 m bands to 10 m. The synthetic panchromatic band is generated using the average value of the visual and the near-infrared bands.

ParameterOverview
methodstring / required
The method used in the pansharpening procedure. The allowed values:
  • SFIM (smoothing filter-based intensity modulation) — this method uses a ratio between a high resolution panchromatic band and its low-pass version filtered with a smoothing filter.
  • Brovey — this method uses a mathematical combination of the color image and high resolution data. Each band in the color image is multiplied by a ratio of the high resolution data divided by the sum of the color bands.
  • Esri — this method uses a weighted average and the additional near-infrared band. The result of the weighted average will be used in calculating the output values. Don't use with Sentinel-2 data.
The default value is SFIM.
edge_sharpen_factorfloat
Use only if method="SFIM"
Factor to reduce blurring of edges in a pansharpened result. The default value is 1.7.
weightfloat
Use only if method="Brovey"
The multiplication value that lets you modulate the influence of multispectral values on the final image. Can be set to a value between 0 and 1. The default value is 0.2.
weightsarray of floats
Use only if method="Esri"
The sequence of weights for each multispectral band that depend on the overlap of the spectral sensitivity curves of the multispectral bands with the panchromatic band. The order of the values in the array: R, G, B, NIR.

The multispectral band with the largest overlap with the panchromatic band should get the largest weight. A multispectral band that doesn't overlap at all with the panchromatic band should get a weight of 0. By changing the near-infrared weight value, the green output can be made more or less vibrant.
  • The default weights for Pléiades: [0.2, 0.34, 0.34, 0.23]
  • The default weights for SPOT: [0.24, 0.2, 0.24, 0]
bboxarray of integers / required if
Required if intersects or contains aren't specified.
A bounding box to use as an AOI. Will clip to scenes that intersect with this box.
containsobject / required if
Required if bbox or intersects aren't specified.
A GeoJSON geometry to use as an AOI. Will clip to scenes that fully cover this geometry.
intersectsobject / required if
Required if bbox or contains aren't specified.
A GeoJSON geometry to use as an AOI. Will clip to scenes that intersect with this geometry.
clip_to_aoiboolean / required
Whether the specified AOI should be clipped before processing:
  • true — The AOI should be clipped first.
  • false — The full scene should be processed.
The default value is false.
include_panboolean / required
If true, includes the panchromatic band in the output pansharpened image. The default value is false.

How to use it in a workflow

  1. Open the console, go Projects icon Projects, and select a project.
  2. Go to the Workflows tab and click Create Workflow.
  3. Name your workflow.
  4. Add Sentinel-2 L2A Analytic (GeoTIFF) or Processing from Storage as a data block.
  5. Add Pansharpen as a processing block.
  6. Click Save & Configure Job.
  7. Adjust job parameters as follows:
  8. Choose a pansharpening method and configure its parameters.
  9. Click Run job.

After that you can download job outputs and visualize them.

Examples


Click to see an example using SFIM
{
  "up42-processing-from-storage:1": {
    "asset_ids": ["01f4fb18-dfd4-49b6-aba0-8853cb494809"]
  },
  "pansharpen:1": {
    "method": "SFIM",
    "edge_sharpen_factor": 1.7
    "bbox": null,
    "contains": null,
    "intersects": null,
    "clip_to_aoi": false,
    "include_pan": false
  }
}

Click to see an example using Brovey
{
  "up42-processing-from-storage:1": {
    "asset_ids": ["01f4fb18-dfd4-49b6-aba0-8853cb494809"]
  },
  "pansharpen:1": {
    "method": "Brovey",
    "weight": 0.2
    "bbox": null,
    "contains": null,
    "intersects": null,
    "clip_to_aoi": false,
    "include_pan": false
  }
}

Click to see an example using Esri
{
  "up42-processing-from-storage:1": {
    "asset_ids": ["01f4fb18-dfd4-49b6-aba0-8853cb494809"]
  },
  "pansharpen:1": {
    "method": "Esri",
    "weights": [0.2, 0.34, 0.34, 0.23]
    "bbox": null,
    "contains": null,
    "intersects": null,
    "clip_to_aoi": false,
    "include_pan": false
  }
}

Capabilities

Input

raster
up42_standard
bands
{
  "or": [
    [
      "coastal",
      "blue",
      "green",
      "red",
      "rededge",
      "rededge2",
      "rededge3",
      "nir",
      "nir2",
      "watervapour",
      "swir2",
      "swir3"
    ],
    [
      "red",
      "green",
      "blue",
      "nir",
      "pan"
    ]
  ]
}
format
{
  "or": [
    "DIMAP",
    "MTL"
  ]
}
sensor
{
  "or": [
    "Pleiades",
    "SPOT",
    "Sentinel2"
  ]
}

Output

raster
up42_standard
bands
{
  "or": [
    [
      "red",
      "green",
      "blue",
      "nir"
    ],
    [
      "red",
      "green",
      "blue",
      "nir",
      "pan"
    ],
    [
      "coastal",
      "blue",
      "green",
      "red",
      "rededge",
      "rededge2",
      "rededge3",
      "nir",
      "nir2",
      "watervapour",
      "swir2",
      "swir3"
    ],
    [
      "coastal",
      "blue",
      "green",
      "red",
      "rededge",
      "rededge2",
      "rededge3",
      "nir",
      "nir2",
      "watervapour",
      "swir2",
      "swir3",
      "pan"
    ]
  ]
}
dtype> (propagated)
formatGTiff
sensor> (propagated)
resolution> (propagated)
processing_level> (propagated)
To know more please check the block capabilities specifications.

Learn more