{"_id":"598374f67c926c0028d2e560","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":33,"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"],"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":2,"slug":"gbdx-data-sets-in-progress","title":"Data Sets on GBDX"},"user":"55fae9d4825d5f19001fa379","__v":0,"parentDoc":null,"updates":[],"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":3,"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# 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\n\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--- | --- | ---\nCatalogID | The record ID provided by the vendor (ESA) | S2B_OPER_MSI_L1C_DS_SGS__20170705T221903_S20170705T202937_N02.05.\nsunAzimuth | The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north | 33.7813510068443\ncloudCover | Estimate of the max cloud-covered fraction of the product component | 0.000 to 1.000, -999.000 if not assessed\nvendorID | 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\nbrowseJpgFile | This is the name of the browse image for this record | preview.jpg\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\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\nplatformName | The name of the sensor platform that acquired the data. The properties \"platformName\" and sensorPlatformName have the same value | SENTINEL2\nutmSequenceNumber |The UTM sequence number for the tile | S\ngridSquare | The grid square for the tile | NB\nsunElevation |The angle of the sun above the horizon | 47.0597253055857\nvendor | The name of the data provider. The properties \"vendorID\" and \"vendor\" have the same value. | For Sentinel-2 data, the vendorID is \"ESA\"\ntimestamp |The timestamp on the acquisition the product is derived from | 2017-07-05T20:29:39.027Z\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\nimageFile | This is the name of the image file for this record | preview.jpg\npart |The part of the strip for this image | 0\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\ns3Region | The Amazon S3 region where the data is stored | eu-west-1\nlatitudeBand |The latitude band for the tile | K\nfootprintWkt | the geometry that defines the location of the record | MULTIPOLYGON(((-151.967203869 -16.2808333229, -151.967203869 -17.270741654, -153.000187194 -17.270741654, -153.000187194 -16.2808333229, -151.967203869 -16.2808333229)))\nsensorPlatformName | 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]\nbandsList | The list of bands included in the product record | CoastalAerosol\", \"Blue\", \"Green\", \"Red\", \"VegRedEdge5\", \"VegRedEdge6\", \"VegRedEdge7\", \"NIR\", \"VegRedEdge8a\", \"WaterVapor\", \"Cirrus\", \"SWIR11\", \"SWIR12\nbucketName | The name of the Amazon S3 bucket the Sentinel-2 data is stored in | sentinel-s2-l1c\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\n**Coming soon**: GBDX will soon support running ENVI algorithms on GBDX using Sentinel-2 data as inputs. This update will be announced on the GBDX [Platform Status Page](doc:platform-status-1) and on Twitter at [:::at:::GBDXReleaseLog](http://twitter.com/GBDXReleaseLog).\n\nThe GBDX team is in the process of testing additional algorithms with Sentinel-2 data as inputs. \n\nAt this time, the following public task has been run with Sentinel-2 data on GBDX:\n\n```gdal-cli-multiplex```","excerpt":"","slug":"sentinel-2","type":"basic","title":"Sentinel-2 (ESA)"}