{"_id":"598374f67c926c0028d2e560","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":36,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37","59e76ce41938310028037295","5a009de510890d001c2aabfe","5a96f89c89442e002041144b"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"category":{"_id":"595412446ed4d9001b3e7b37","project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-06-28T20:32:04.415Z","from_sync":false,"order":3,"slug":"gbdx-data-sets-in-progress","title":"Data Sets on GBDX"},"user":"55fae9d4825d5f19001fa379","__v":1,"parentDoc":null,"updates":["5a31aed2e75bd0001ead53f4"],"next":{"pages":[],"description":""},"createdAt":"2017-08-03T19:09:42.019Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"# Overview\n\nThe 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. \n \nGBDX 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 <a href=\"http://sentinel-pds.s3-website.eu-central-1.amazonaws.com/\">Sentinel-2 on AWS</a> for an overview of the Sentinel program and resulting Sentinel-2 data. \n\nThe 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. \n\n**Spectral Bands**: 13 [spectral bands](http://www.gdal.org/frmt_sentinel2.html): four bands at 10 meters, six bands at 20 meters and three bands at 60 meters spatial resolution.\n \n**Date Range**: June 23, 2015 to present\n \n**Products available through GBDX**: Level 1-C\n\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/412fe10-Sentinel-2_image.jpg\",\n        \"Sentinel-2 image.jpg\",\n        1856,\n        1965,\n        \"#1d231b\"\n      ],\n      \"caption\": \"Title: Etna erupts\\nReleased 16/03/2017 4:54 pm\\nCopyright contains modified Copernicus Sentinel data (2017), processed by ESA, CC BY-SA 3.0 IGO\"\n    }\n  ]\n}\n[/block]\n# Types\n\nType | Description\n--- | ---\nESAProduct | Product type for all Sentinel records\nSENTINEL2 | All records acquired by the Sentinel-2 satellite\n\n# Search \n\nUsing 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. \n\nNote that the catalog stores \"Sentinel-2\" as \"SENTINEL2\". When searching by \"types\", be sure to sure for \"SENTINEL2. \n\n**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.\n\n## Catalog V2 API Request\n\nSend a ```POST``` request to ```https://geobigdata.io/catalog/v2/search``` with a request body. \n\nFor gbdxtools, see  <a href=\"http://gbdxtools.readthedocs.io/en/latest/catalog_search.html#catalog-search-overview\">Catalog Search Overview</a>\n\n## Search Example 1: Search by Types\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \" {\\n   \\t\\\"searchAreaWkt\\\": \\\"POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))\\\",\\n   \\t\\\"startDate\\\": \\\"2015-03-01T00:00:00.000Z\\\",\\n   \\t\\\"endDate\\\": \\\"2016-03-01T23:59:59.999Z\\\",\\n   \\t\\\"types\\\": [\\\"SENTINEL2\\\"]\\n   }\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n## Search Result Example \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \" \\\"stats\\\": {\\n        \\\"recordsReturned\\\": 50,\\n        \\\"totalRecords\\\": 50,\\n        \\\"typeCounts\\\": {\\n            \\\"ESAProduct\\\": 50,\\n            \\\"GBDXCatalogRecord\\\": 50,\\n            \\\"SENTINEL2\\\": 50\\n        }\\n    },\\n    \\\"results\\\": [\\n        {\\n            \\\"identifier\\\": \\\"2579f8d6-786e-57b7-aa69-68831c7550e0\\\",\\n            \\\"type\\\": [\\n                \\\"GBDXCatalogRecord\\\",\\n                \\\"ESAProduct\\\",\\n                \\\"SENTINEL2\\\"\\n            ],\\n            \\\"properties\\\": {\\n                \\\"sunAzimuth\\\": 163.323328488621,\\n                \\\"cloudCover\\\": 100,\\n                \\\"catalogID\\\": \\\"S2A_OPER_MSI_L1C_DS_EPA__20170508T083647_S20151128T050431_N02.04\\\",\\n                \\\"vendorID\\\": \\\"ESA\\\",\\n                \\\"xmlFile\\\": \\\"metadata.xml\\\",\\n                \\\"browseJpgFile\\\": \\\"preview.jpg\\\",\\n                \\\"utmZone\\\": 45,\\n                \\\"offNadirAngle\\\": 9.786730816814552,\\n                \\\"platformName\\\": \\\"SENTINEL2\\\",\\n                \\\"utmSequenceNumber\\\": \\\"N\\\",\\n                \\\"gridSquare\\\": \\\"UK\\\",\\n                \\\"sunElevation\\\": 49.6342534708362,\\n                \\\"vendor\\\": \\\"ESA\\\",\\n                \\\"timestamp\\\": \\\"2015-11-28T05:01:42.031Z\\\",\\n                \\\"bucketPrefix\\\": \\\"tiles/45/R/UK/2015/11/28/2\\\",\\n                \\\"imageFile\\\": \\\"preview.jpg\\\",\\n                \\\"part\\\": 3,\\n                \\\"bucketName\\\": \\\"sentinel-s2-l1c\\\",\\n                \\\"s3Region\\\": \\\"eu-central-1\\\",\\n                \\\"latitudeBand\\\": \\\"R\\\",\\n                \\\"footprintWkt\\\": \\\"POLYGON((86.0977408861 27.1079794858, 86.0977408861 26.1282534197, 84.9824930197 26.1282534197, 84.9824930197 27.1079794858, 86.0977408861 27.1079794858))\\\",\\n                \\\"sensorPlatformName\\\": \\\"SENTINEL2\\\",\\n                \\\"productLevel\\\": \\\"Level-1C\\\",\\n                \\\"resolution\\\": [\\n                    60,\\n                    10,\\n                    10,\\n                    10,\\n                    20,\\n                    20,\\n                    20,\\n                    10,\\n                    20,\\n                    60,\\n                    60,\\n                    20,\\n                    20\\n                ],\\n                \\\"bandsList\\\": [\\n                    \\\"CoastalAerosol\\\",\\n                    \\\"Blue\\\",\\n                    \\\"Green\\\",\\n                    \\\"Red\\\",\\n                    \\\"VegRedEdge5\\\",\\n                    \\\"VegRedEdge6\\\",\\n                    \\\"VegRedEdge7\\\",\\n                    \\\"NIR\\\",\\n                    \\\"VegRedEdge8a\\\",\\n                    \\\"WaterVapor\\\",\\n                    \\\"Cirrus\\\",\\n                    \\\"SWIR11\\\",\\n                    \\\"SWIR12\\\"\\n                ],\\n                \\\"tileId\\\": \\\"S2A_OPER_MSI_L1C_TL_EPA__20170508T083647_A002261_T45RUK_N02.04\\\"\\n            }\\n        }\\n      \\n      ... truncated search results show a single record.\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n## Search Example 2: Search for Sentinel-2A or Sentinel-2B Records\n\nThe Sentinel 2 mission consists of two satellites: Sentinel-2A (S2A) and Sentinel-2B (S2B). S2A or S2B is prepended to the CatalogID. \n\nTo search by S2A or S2B, execute a \"filter\" search by catalog ID using the LIKE operator ```*```.\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \" {\\n\\t\\\"searchAreaWkt\\\": \\\"POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))\\\",\\n\\t\\\"filters\\\": [\\\"catalogID LIKE 'S2A*'\\\"]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n# Types\n\nThere are three \"types\" associated with Sentinel-2 records. \n\nType | Definition\n--- | ---\nGBDXCatalogRecord | The parent type for all GBDX catalog records\nESAProduct | This type is associated with all ESA products. \nSENTINEL2 | This type is associated with all records acquired from ESA's Sentinel-2 sensor platform. \n\n\n# Properties\n\nThe following properties  and metadata files are associated with a Sentinel-2 record in the GBDX catalog. \n\nProperty | Description | Values\n--- | --- | ---\nbandsList | The list of bands included in the product record | CoastalAerosol\", \"Blue\", \"Green\", \"Red\", \"VegRedEdge5\", \"VegRedEdge6\", \"VegRedEdge7\", \"NIR\", \"VegRedEdge8a\", \"WaterVapor\", \"Cirrus\", \"SWIR11\", \"SWIR12\nbrowseJpgFile | This is the name of the browse image for this record | preview.jpg\nbucketName | The name of the Amazon S3 bucket the Sentinel-2 data is stored in | sentinel-s2-l1c\nbucketPrefix | Amazon S3 bucket prefix. This filters the contents of an S3 bucket, so that only data stored in the prefix is displayed. | tiles/4/K/NB/2017/7/3/0\nCatalogID | The record ID provided by the vendor (ESA)|S2B_OPER_MSI_L1C_DS_SGS__20170705T221903_S20170705T202937_N02.05\ncloudCover | Estimate of the max cloud-covered fraction of the product component | 0.000 to 1.000, -999.000 if not assessed\nfootprintWkt | the geometry that defines the location of the record | See search results example\ngridSquare | The grid square for the tile | NB\nimageFile | This is the name of the image file for this record | preview.jpg\nlatitudeBand |The latitude band for the tile | K\noffNadirAngle | The spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired | 2.839526066752065\npart |The part of the strip for this image | 0\nplatformName | The name of the sensor platform that acquired the data. The properties \"platformName\" and sensorPlatformName have the same value | SENTINEL2\nproductLevel | The product level for the record | All Sentinel-2 products are \"Level-1C\"\nresolution |The spatial resolution is dependent on the particular spectral band.  | [60.0, 10.0, 10.0, 10.0, 20.0, 20.0, 20.0, 10.0, 20.0, 60.0, 60.0, 20.0, 20.0]\ns3Region | The Amazon S3 region where the data is stored | eu-west-1\nsensorPlatformName | The name of the sensor platform that acquired the data. The properties \"platformName\" and sensorPlatformName have the same value | SENTINEL2\nsunAzimuth | The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north | 33.7813510068443\nsunElevation |The angle of the sun above the horizon | 47.0597253055857\ntileId |See figure 2 on <a href=\"https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi/naming-convention/\">Naming Conventions</a>  for an explanation of the tile ID naming convention. In Sentinel-2 documentation, \"tile\" is also referred to as \"granule\"| S2B_OPER_MSI_L1C_TL_SGS__20170705T221903_A001727_T05KNB_N02.05\ntimestamp |The timestamp on the acquisition the product is derived from | 2017-07-05T20:29:39.027Z\nutmSequenceNumber |The UTM sequence number for the tile | S\nutmZone | The UTM (Universal Transverse Mercator) system divides the Earth's surface into 60 zones. Each UTM zone has a vertical width of 6° of longitude and horizontal width of 8° of latitude.(source: https://sentinel.esa.int/web/sentinel/missions/sentinel-2/data-products) | 5\nvendorID | The name of the data provider.  The properties \"vendorID\" and \"vendor\" have the same value.  | For Sentinel-2 data, the vendorID is \"ESA\"\nvendor | The name of the data provider.  The properties \"vendorID\" and \"vendor\" have the same value. | For Sentinel-2 data, the vendorID is \"ESA\"\nxmlFile |This file contains the raw metada this record was derived from| metadata.xml\n\n\n# Catalog ID\nThe Catalog ID is the product ID assigned by the vendor. See the Sentinel-2 online guide on  <a href=\"https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi/naming-convention/\">Naming Conventions</a> for an explanation of each part of the product catalog ID. \n\n# Spectral Bands and Spatial Resolution\n\nThe 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. \n\n See <a href=\"http://www.gdal.org/frmt_sentinel2.html\">Sentinel-2 Products on gdal.org </a> for a list of bands and their resolution. \n\n# S3 location\nThe s3 location for a record is bucketName/bucketPrefix\n\nExample: ```s3://sentinel-s2-l1c/tiles/10/S/EG/2015/10/21/0\n\nor \n\nhttp://sentinel-s2-l1c.s3.amazonaws.com/tiles/10/S/EG/2015/10/21/0\n\nIn the example, the bucketName is ```sentinel-s2-l1c```\n\nThe bucketPrefix is ``/tiles/10/S/EG/2015/10/21/0```\n\nThe bucketPrefix  naming convention is ```tiles/UTM code/latitudeBand/gridSsquare/[year]/[month]/[day]/[sequence]/DATA```\n\n\n\n\n# Processing Sentinel-2 Data\n\nThe 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:\n\nThe 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:\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"from gbdxtools import Interface\\ngbdx = Interface()\\n\\nraster_location = 's3://sentinel-s2-l1c/tiles/15/R/XP/2016/9/3/0'\\n\\ntask = gbdx.Task('ENVI_SpectralIndices:1.1.0')\\ntask.inputs.input_raster = raster_location\\ntask.inputs.input_raster_format = 'sentinel-2'\\ntask.inputs.input_raster_band_grouping = 'M1-10m'\\ntask.inputs.index = '[\\\"Normalized Difference Vegetation Index\\\"]'\\n\\nwf = gbdx.Workflow([task])\\nwf.savedata(task.outputs.output_raster_uri, location='ENVI_Indices')\\n\\nwf.execute()\",\n      \"language\": \"python\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"sentinel-2","type":"basic","title":"SENTINEL-2 (ESA)"}

Getting Started

GBDX Operations

GBDX Stories

Data Sets on GBDX

Raster Data Access (RDA) Guide

GBDX Notebooks

Authentication Guide

Ordering Guide

Catalog V2 API Guide

Algorithms

Tasks and Workflows Guide

S3 Storage Service Guide

Web Application (Deprecated)

Thumbnail Service Guide (Deprecated)

AnswerFactory Application

Read & Query Vector Services Guide

Aggregations & Facets Vector Services Guide

Write & Ingest Vector Services Guide

IDAHO Guide

Helpful Links

SENTINEL-2 (ESA)

# 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 <a href="http://sentinel-pds.s3-website.eu-central-1.amazonaws.com/">Sentinel-2 on AWS</a> 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](http://www.gdal.org/frmt_sentinel2.html): 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 [block:image] { "images": [ { "image": [ "https://files.readme.io/412fe10-Sentinel-2_image.jpg", "Sentinel-2 image.jpg", 1856, 1965, "#1d231b" ], "caption": "Title: Etna erupts\nReleased 16/03/2017 4:54 pm\nCopyright contains modified Copernicus Sentinel data (2017), processed by ESA, CC BY-SA 3.0 IGO" } ] } [/block] # Types Type | Description --- | --- ESAProduct | Product type for all Sentinel records SENTINEL2 | All records acquired by the Sentinel-2 satellite # 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 <a href="http://gbdxtools.readthedocs.io/en/latest/catalog_search.html#catalog-search-overview">Catalog Search Overview</a> ## Search Example 1: Search by Types [block:code] { "codes": [ { "code": " {\n \t\"searchAreaWkt\": \"POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))\",\n \t\"startDate\": \"2015-03-01T00:00:00.000Z\",\n \t\"endDate\": \"2016-03-01T23:59:59.999Z\",\n \t\"types\": [\"SENTINEL2\"]\n }", "language": "json" } ] } [/block] ## Search Result Example [block:code] { "codes": [ { "code": " \"stats\": {\n \"recordsReturned\": 50,\n \"totalRecords\": 50,\n \"typeCounts\": {\n \"ESAProduct\": 50,\n \"GBDXCatalogRecord\": 50,\n \"SENTINEL2\": 50\n }\n },\n \"results\": [\n {\n \"identifier\": \"2579f8d6-786e-57b7-aa69-68831c7550e0\",\n \"type\": [\n \"GBDXCatalogRecord\",\n \"ESAProduct\",\n \"SENTINEL2\"\n ],\n \"properties\": {\n \"sunAzimuth\": 163.323328488621,\n \"cloudCover\": 100,\n \"catalogID\": \"S2A_OPER_MSI_L1C_DS_EPA__20170508T083647_S20151128T050431_N02.04\",\n \"vendorID\": \"ESA\",\n \"xmlFile\": \"metadata.xml\",\n \"browseJpgFile\": \"preview.jpg\",\n \"utmZone\": 45,\n \"offNadirAngle\": 9.786730816814552,\n \"platformName\": \"SENTINEL2\",\n \"utmSequenceNumber\": \"N\",\n \"gridSquare\": \"UK\",\n \"sunElevation\": 49.6342534708362,\n \"vendor\": \"ESA\",\n \"timestamp\": \"2015-11-28T05:01:42.031Z\",\n \"bucketPrefix\": \"tiles/45/R/UK/2015/11/28/2\",\n \"imageFile\": \"preview.jpg\",\n \"part\": 3,\n \"bucketName\": \"sentinel-s2-l1c\",\n \"s3Region\": \"eu-central-1\",\n \"latitudeBand\": \"R\",\n \"footprintWkt\": \"POLYGON((86.0977408861 27.1079794858, 86.0977408861 26.1282534197, 84.9824930197 26.1282534197, 84.9824930197 27.1079794858, 86.0977408861 27.1079794858))\",\n \"sensorPlatformName\": \"SENTINEL2\",\n \"productLevel\": \"Level-1C\",\n \"resolution\": [\n 60,\n 10,\n 10,\n 10,\n 20,\n 20,\n 20,\n 10,\n 20,\n 60,\n 60,\n 20,\n 20\n ],\n \"bandsList\": [\n \"CoastalAerosol\",\n \"Blue\",\n \"Green\",\n \"Red\",\n \"VegRedEdge5\",\n \"VegRedEdge6\",\n \"VegRedEdge7\",\n \"NIR\",\n \"VegRedEdge8a\",\n \"WaterVapor\",\n \"Cirrus\",\n \"SWIR11\",\n \"SWIR12\"\n ],\n \"tileId\": \"S2A_OPER_MSI_L1C_TL_EPA__20170508T083647_A002261_T45RUK_N02.04\"\n }\n }\n \n ... truncated search results show a single record.", "language": "json" } ] } [/block] ## 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 ```*```. [block:code] { "codes": [ { "code": " {\n\t\"searchAreaWkt\": \"POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))\",\n\t\"filters\": [\"catalogID LIKE 'S2A*'\"]\n}", "language": "json" } ] } [/block] # Types There are three "types" associated with Sentinel-2 records. Type | Definition --- | --- GBDXCatalogRecord | The parent type for all GBDX catalog records ESAProduct | This type is associated with all ESA products. SENTINEL2 | This type is associated with all records acquired from ESA's Sentinel-2 sensor platform. # Properties The following properties and metadata files are associated with a Sentinel-2 record in the GBDX catalog. Property | Description | Values --- | --- | --- bandsList | The list of bands included in the product record | CoastalAerosol", "Blue", "Green", "Red", "VegRedEdge5", "VegRedEdge6", "VegRedEdge7", "NIR", "VegRedEdge8a", "WaterVapor", "Cirrus", "SWIR11", "SWIR12 browseJpgFile | This is the name of the browse image for this record | preview.jpg bucketName | The name of the Amazon S3 bucket the Sentinel-2 data is stored in | sentinel-s2-l1c bucketPrefix | Amazon S3 bucket prefix. This filters the contents of an S3 bucket, so that only data stored in the prefix is displayed. | tiles/4/K/NB/2017/7/3/0 CatalogID | The record ID provided by the vendor (ESA)|S2B_OPER_MSI_L1C_DS_SGS__20170705T221903_S20170705T202937_N02.05 cloudCover | Estimate of the max cloud-covered fraction of the product component | 0.000 to 1.000, -999.000 if not assessed footprintWkt | the geometry that defines the location of the record | See search results example gridSquare | The grid square for the tile | NB imageFile | This is the name of the image file for this record | preview.jpg latitudeBand |The latitude band for the tile | K offNadirAngle | The spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired | 2.839526066752065 part |The part of the strip for this image | 0 platformName | The name of the sensor platform that acquired the data. The properties "platformName" and sensorPlatformName have the same value | SENTINEL2 productLevel | The product level for the record | All Sentinel-2 products are "Level-1C" resolution |The spatial resolution is dependent on the particular spectral band. | [60.0, 10.0, 10.0, 10.0, 20.0, 20.0, 20.0, 10.0, 20.0, 60.0, 60.0, 20.0, 20.0] s3Region | The Amazon S3 region where the data is stored | eu-west-1 sensorPlatformName | The name of the sensor platform that acquired the data. The properties "platformName" and sensorPlatformName have the same value | SENTINEL2 sunAzimuth | The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north | 33.7813510068443 sunElevation |The angle of the sun above the horizon | 47.0597253055857 tileId |See figure 2 on <a href="https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi/naming-convention/">Naming Conventions</a> for an explanation of the tile ID naming convention. In Sentinel-2 documentation, "tile" is also referred to as "granule"| S2B_OPER_MSI_L1C_TL_SGS__20170705T221903_A001727_T05KNB_N02.05 timestamp |The timestamp on the acquisition the product is derived from | 2017-07-05T20:29:39.027Z utmSequenceNumber |The UTM sequence number for the tile | S utmZone | The UTM (Universal Transverse Mercator) system divides the Earth's surface into 60 zones. Each UTM zone has a vertical width of 6° of longitude and horizontal width of 8° of latitude.(source: https://sentinel.esa.int/web/sentinel/missions/sentinel-2/data-products) | 5 vendorID | The name of the data provider. The properties "vendorID" and "vendor" have the same value. | For Sentinel-2 data, the vendorID is "ESA" vendor | The name of the data provider. The properties "vendorID" and "vendor" have the same value. | For Sentinel-2 data, the vendorID is "ESA" xmlFile |This file contains the raw metada this record was derived from| metadata.xml # Catalog ID The Catalog ID is the product ID assigned by the vendor. See the Sentinel-2 online guide on <a href="https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi/naming-convention/">Naming Conventions</a> 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 <a href="http://www.gdal.org/frmt_sentinel2.html">Sentinel-2 Products on gdal.org </a> 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: [block:code] { "codes": [ { "code": "from gbdxtools import Interface\ngbdx = Interface()\n\nraster_location = 's3://sentinel-s2-l1c/tiles/15/R/XP/2016/9/3/0'\n\ntask = gbdx.Task('ENVI_SpectralIndices:1.1.0')\ntask.inputs.input_raster = raster_location\ntask.inputs.input_raster_format = 'sentinel-2'\ntask.inputs.input_raster_band_grouping = 'M1-10m'\ntask.inputs.index = '[\"Normalized Difference Vegetation Index\"]'\n\nwf = gbdx.Workflow([task])\nwf.savedata(task.outputs.output_raster_uri, location='ENVI_Indices')\n\nwf.execute()", "language": "python" } ] } [/block]