Overview

The Sentinel-2 mission is a collaboration between the European Space Agency (ESA), the European Commission, industry service providers, and data users. Sentinel-2 delivers high-resolution optical images ideal for land monitoring, emergency response, and security services.

GBDX catalogs the Sentinel-2 offerings publicly available through Amazon Web Services (AWS) At this time, the data set includes Level-1C products. This data is stored in an AWS bucket and accessible through S3. Please read Sentinel-2 on AWS for an overview of the Sentinel program and resulting Sentinel-2 data.

The Sentinel-2 constellation includes two satellites: : Sentinel-2A was launched on 23 June 2015 and Sentinel-2B followed on March 7, 2017. These two satellites together provide global coverage of the earth's land surface every five days.

Spectral Bands: 13 spectral bands: four bands at 10 meters, six bands at 20 meters and three bands at 60 meters spatial resolution.

Date Range: June 23, 2015 to present

Products available through GBDX: Level 1-C

Types

Search

Using the GBDX Catalog API, search by "types" to find Sentinel-2 data. To narrow the search results set, include area, date range, or both. Search results can be further filtered by the properties of a Sentinel-2 record.

Note that the catalog stores "Sentinel-2" as "SENTINEL2". When searching by "types", be sure to sure for "SENTINEL2.

Note: Sentinel-2 products do not need to be ordered. All available records can be accessed from the Amazon S3 location using the S3 bucket name and bucket prefix. Sentinel-2 products cannot be accessed using the GBDX Ordering API endpoint.

Catalog V2 API Request

Send a POST request to https://geobigdata.io/catalog/v2/search with a request body.

For gbdxtools, see Catalog Search Overview

Search Example 1: Search by Types

 {
   	"searchAreaWkt": "POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))",
   	"startDate": "2015-03-01T00:00:00.000Z",
   	"endDate": "2016-03-01T23:59:59.999Z",
   	"types": ["SENTINEL2"]
   }

Search Result Example

 "stats": {
        "recordsReturned": 50,
        "totalRecords": 50,
        "typeCounts": {
            "ESAProduct": 50,
            "GBDXCatalogRecord": 50,
            "SENTINEL2": 50
        }
    },
    "results": [
        {
            "identifier": "2579f8d6-786e-57b7-aa69-68831c7550e0",
            "type": [
                "GBDXCatalogRecord",
                "ESAProduct",
                "SENTINEL2"
            ],
            "properties": {
                "sunAzimuth": 163.323328488621,
                "cloudCover": 100,
                "catalogID": "S2A_OPER_MSI_L1C_DS_EPA__20170508T083647_S20151128T050431_N02.04",
                "vendorID": "ESA",
                "xmlFile": "metadata.xml",
                "browseJpgFile": "preview.jpg",
                "utmZone": 45,
                "offNadirAngle": 9.786730816814552,
                "platformName": "SENTINEL2",
                "utmSequenceNumber": "N",
                "gridSquare": "UK",
                "sunElevation": 49.6342534708362,
                "vendor": "ESA",
                "timestamp": "2015-11-28T05:01:42.031Z",
                "bucketPrefix": "tiles/45/R/UK/2015/11/28/2",
                "imageFile": "preview.jpg",
                "part": 3,
                "bucketName": "sentinel-s2-l1c",
                "s3Region": "eu-central-1",
                "latitudeBand": "R",
                "footprintWkt": "POLYGON((86.0977408861 27.1079794858, 86.0977408861 26.1282534197, 84.9824930197 26.1282534197, 84.9824930197 27.1079794858, 86.0977408861 27.1079794858))",
                "sensorPlatformName": "SENTINEL2",
                "productLevel": "Level-1C",
                "resolution": [
                    60,
                    10,
                    10,
                    10,
                    20,
                    20,
                    20,
                    10,
                    20,
                    60,
                    60,
                    20,
                    20
                ],
                "bandsList": [
                    "CoastalAerosol",
                    "Blue",
                    "Green",
                    "Red",
                    "VegRedEdge5",
                    "VegRedEdge6",
                    "VegRedEdge7",
                    "NIR",
                    "VegRedEdge8a",
                    "WaterVapor",
                    "Cirrus",
                    "SWIR11",
                    "SWIR12"
                ],
                "tileId": "S2A_OPER_MSI_L1C_TL_EPA__20170508T083647_A002261_T45RUK_N02.04"
            }
        }
      
      ... truncated search results show a single record.

Search Example 2: Search for Sentinel-2A or Sentinel-2B Records

The Sentinel 2 mission consists of two satellites: Sentinel-2A (S2A) and Sentinel-2B (S2B). S2A or S2B is prepended to the CatalogID.

To search by S2A or S2B, execute a "filter" search by catalog ID using the LIKE operator *.

 {
	"searchAreaWkt": "POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))",
	"filters": ["catalogID LIKE 'S2A*'"]
}

Types

There are three "types" associated with Sentinel-2 records.

Properties

The following properties and metadata files are associated with a Sentinel-2 record in the GBDX catalog.

Catalog ID

The Catalog ID is the product ID assigned by the vendor. See the Sentinel-2 online guide on Naming Conventions for an explanation of each part of the product catalog ID.

Spectral Bands and Spatial Resolution

The Sentinel-2 MSI acquires 13 spectal bands ranging from Visible and Near-Infrared (VNIR) to Shortwave Infrared (SWIR). The spatial resolution of Sentinel-2 product is dependent on the particular spectral band.

See Sentinel-2 Products on gdal.org for a list of bands and their resolution.

S3 location

The s3 location for a record is bucketName/bucketPrefix

Example: ```s3://sentinel-s2-l1c/tiles/10/S/EG/2015/10/21/0

or

http://sentinel-s2-l1c.s3.amazonaws.com/tiles/10/S/EG/2015/10/21/0

In the example, the bucketName is sentinel-s2-l1c

The bucketPrefix is ``/tiles/10/S/EG/2015/10/21/0```

The bucketPrefix naming convention is tiles/UTM code/latitudeBand/gridSsquare/[year]/[month]/[day]/[sequence]/DATA

Processing Sentinel-2 Data

The Platform team is excited to announce that the version of the ENVI Services Engine software available on the GBDX platform has been upgraded to the most recent 5.4 Service Pack 1 (v5.4.1) recently released by Harris Geospatial Solutions. This upgrade involved updates to the GBDX platform ENVI task runner and deployment of all new ENVI_ tasks with GBDX task versioning of v1.1.0. Furthermore, this new ENVI v5.4.1 also includes full support for Sentinel-2 on AWS datasets. Consequently, the Sentinel-2 data that was recently cataloged for availability on the GBDX platform can now be passed into the ENVI analytic tasks that perform raster processing suitable for Sentinel-2 imagery:

The new ENVI tasks on GBDX include the ability to specify the desired raster band grouping from the Sentinel-2 dataset ("M1-10m" | "M2-20m" | "M3-60m") via input port designation when the ENVI task is executed. Here is a simple gbdxtools Python script example illustrating effective execution of the ENVI_SpectralIndices task on the "M1-10m" bands of a Sentinel-2 dataset:

from gbdxtools import Interface
gbdx = Interface()

raster_location = 's3://sentinel-s2-l1c/tiles/15/R/XP/2016/9/3/0'

task = gbdx.Task('ENVI_SpectralIndices:1.1.0')
task.inputs.input_raster = raster_location
task.inputs.input_raster_format = 'sentinel-2'
task.inputs.input_raster_band_grouping = 'M1-10m'
task.inputs.index = '["Normalized Difference Vegetation Index"]'

wf = gbdx.Workflow([task])
wf.savedata(task.outputs.output_raster_uri, location='ENVI_Indices')

wf.execute()