EOMasters Toolbox Pro

S2 Super-Resolution (CLI)

Overview

The S2 Super-Resolution processor can be used with the command line tool gpt. General information about GPF and GPT can be found on their help pages. Specific help for the S2 Super-Resolution processor can be obtained with: ${SNAP-INSTALL-DIR}/bin/gpt -h S2SuperRes
This will show the following help:

Usage:
  gpt S2SuperRes [options] 

Description:
  Super-resolution of a Sentinel-2 product to 5m ground resolution.


Source Options:
  -SsourceProduct=<file>    The Sentinel-2 source product
                            This is a mandatory source.

Parameter Options:
  -PpixelRegion=<rectangle>                         Pixel region at 10m to process. Use the following format: {x},{y},{width},{height}.
  -Presample60mBands=<boolean>                      Whether to include 60m bands and resample them to 5m
                                                    Default value is 'false'.
  -PresampleGeometryBands=<boolean>                 Whether sun and view geometry bands shall be resampled to 5m.
                                                    Default value is 'false'.
  -PresampleOtherBands=<boolean>                    Whether to include other remaining bands and resample them to 5m
                                                    Default value is 'false'.
  -Pshapefile=<path>                                An ESRI shapefile, providing the considered geographical region(s).
  -PsuperResolveBands=<string,string,string,...>    Bands that will be super-resolved to 5m.
                                                    Value must be one of 'B2', 'B3', 'B4', 'B5', 'B6', 'B7', 'B8', 'B8A', 'B11', 'B12'.
                                                    Default value is 'B2,B3,B4,B5,B6,B7,B8,B8A,B11,B12'.
                                                    This is a mandatory parameter.
                                                    Value must not be empty.
  -PwktRegion=<geometry>                            The considered geographical region as a geometry in well-known text format (WKT).

Graph XML Format:
  <graph id="someGraphId">
    <version>1.0</version>
    <node id="someNodeId">
      <operator>S2SuperRes</operator>
      <sources>
        <sourceProduct>${sourceProduct}</sourceProduct>
      </sources>
      <parameters>
        <pixelRegion>rectangle</pixelRegion>
        <shapefile>path</shapefile>
        <wktRegion>geometry</wktRegion>
        <superResolveBands>string,string,string,...</superResolveBands>
        <resample60mBands>boolean</resample60mBands>
        <resampleGeometryBands>boolean</resampleGeometryBands>
        <resampleOtherBands>boolean</resampleOtherBands>
      </parameters>
    </node>
  </graph>

Parameters

sourceProduct This defines the source product on which the processing is performed. Supported are standard Sentinel-2 products of type L1C, L2A and L2A products provided by Theia.
The specified region(s) will be used to select the pixels to be processed. Only one of pixelRegion, shapefile and wktRegion must be specified: The specified region must not exceed a region of 4k square pixels.
In order to super-resolve the images it needs surrounding pixels. Therefore, the processor might crop the specified region by 32 pixels if the region is to close to the edge of the image.
pixelRegion Specifies the pixel region at 10m resolution to process. It should be in the format "{x},{y},{width},{height}" where:
  • x - The x-coordinate of the top-left corner of the region.
  • y - The y-coordinate of the top-left corner of the region.
  • width - The width of the region.
  • height - The height of the region.
shapefile This parameter specifies the path to an ESRI shapefile which defines the geographical region(s) of interest.
wktRegion This parameter specifies the geographical region of interest as a geometry in well-known text format (WKT).
superResolveBands Select the bands which shall be super-resolved. Allowed bands are 'B2', 'B3', 'B4', 'B5', 'B6', 'B7', 'B8', 'B8A', 'B11', 'B12'. For Theia L2A products the band names are mapped to the respective bands of the 'Surface_Reflectance' and the 'Flat_Reflectance' groups.
resample60mBands Whether the 60m bands shall be included in the target product, up-scaled using a bi-cubic interpolation.
resampleGeometryBands Whether the view and sun geometry bands shall be included in the target product, up-scaled to the 5m resolution. The view geometry bands will only be included for the spectral bands that are processed. This option is not working when using Theia L2A products.
resampleOtherBands Whether to include other source bands. If bands are ancillary for spectral bands, they will only be included if the spectral bands is part of the target too.