Sentinel 3 Marine Copernicus Data Access User Manual https://coda.eumetsat.int Sentinel 3 Marine Copernicus Data Acces EUMETSAT Doc.No. : EUM/OPS-SEN3/MAN/16/880763 Eumetsat-Allee 1, D-64295 Darmstadt, Germany Tel: +49 6151 807-7 Issue : v2B Draft Fax: +49 6151 807 555 Date : 18 October 2018 http://www.eumetsat.int WBS/DBS : © EUMETSAT The copyright of this document is the property of EUMETSAT. EUM/OPS-SEN3/MAN/16/880763 v2B Draft, 18 October 2018 CODA user manual Table of Contents 1 INTRODUCTION .............................................................................................................................. 4 1.1 CODArep Online Rolling Archive ........................................................................................... 4 1.2 File naming convention .......................................................................................................... 5 1.3 Acronyms scheme .................................................................................................................. 9 1.4 OLCI and SLSTR bands description .................................................................................... 11 1.4.1 OLCI ............................................................................................................................... 11 1.4.2 SLSTR ............................................................................................................................ 12 2 CODA GRAPHICAL USER INTERFACE ...................................................................................... 13 2.1 Map viewer tool .................................................................................................................... 13 2.2 Search Options..................................................................................................................... 13 2.2.1 Full Text Search ............................................................................................................. 14 2.2.1.1 Wildcards and Operators .......................................................................................... 14 2.2.1.2 Search Keywords ..................................................................................................... 15 2.2.2 Advanced Search ........................................................................................................... 21 2.2.2.1 Available search parameters for the advanced search ............................................ 22 2.3 Search results list ................................................................................................................. 23 2.3.1 Product Details ............................................................................................................... 24 2.4 User Profile Panel ................................................................................................................ 25 2.5 Batch download from CODA and CODArep GUI ................................................................. 26 2.5.1 Download the cart using a Download Manager (aria2) ................................................. 26 3 APIS AND BATCH SCRIPTING .................................................................................................... 28 3.1 OPEN DATA PROTOCOL (ODATA) ................................................................................... 28 3.1.1 URI Components............................................................................................................ 28 3.1.2 Service Metadata Document .......................................................................................... 29 3.1.3 Querying Products in the Data Hub archive .................................................................. 30 3.2 OData System Query Options .............................................................................................. 32 3.3 Download ............................................................................................................................. 39 3.4 Discover Product Nodes ...................................................................................................... 40 3.5 Download manifest file knowing the product UUID .............................................................. 41 3.6 Download of quick-look file knowing the product UUID ....................................................... 41 3.7 Verifying Download integrity using the MD5 checksum ....................................................... 41 4 OPEN SEARCH ............................................................................................................................. 43 4.1 URI Components .................................................................................................................. 43 4.2 Using Open Search to discover products ............................................................................ 43 4.2.1 Discover the list of the products stored in the archive ................................................... 43 4.2.2 Paging results ................................................................................................................ 43 4.2.3 Sorting results ................................................................................................................ 44 4.3 Discover the products over a predefined Area Of Interest (AOI): Geographical Search ..... 44 4.3.1 Polygon .......................................................................................................................... 44 4.3.2 Point ............................................................................................................................... 45 4.4 Open Search queries examples (combined with full text search) ........................................ 45 5 BATCH SCRIPTING ...................................................................................................................... 47 5.1 Query via Curl ...................................................................................................................... 47 5.2 Query via Wget..................................................................................................................... 47 5.3 Download via Wget .............................................................................................................. 47 5.4 Scripts Examples ................................................................................................................. 48 5.4.1 dhusget script ................................................................................................................. 48 5.4.2 Odata-demo.sh script ..................................................................................................... 51 6 OLCI ORBIT PREDICTION ........................................................................................................... 53 Page 2 of 56 EUM/OPS-SEN3/MAN/16/880763 v2B Draft, 18 October 2018 CODA user manual 7 USEFUL LINKS ............................................................................................................................. 55 8 KNOWN ISSUES AND USEFUL TIPS FOR CODA WEB SERVICE ........................................... 56 Page 3 of 56 EUM/OPS-SEN3/MAN/16/880763 v2B Draft, 18 October 2018 CODA user manual 1 INTRODUCTION The Sentinel-3 Marine CODA (Copernicus Online Data Access) Web Service provides complete, free and open access to Sentinel-3 user products provided by EUMETSAT on behalf of the European Commission. In order to access CODA GUI and CODA API functionalities, it is necessary to have an Earth Observation Portal (EO Portal) user account. The Web Service consists of a rolling archive with http access up to 1 year of data online1. It provides Sentinel-3 Level-1 and Level-2 (only Marine) products for the following instruments: OLCI (Ocean and Land Colour Instrument), SLSTR (Sea and Land Surface Temperature Radiometer), SRAL (SAR Altimeter). Sentinel-3 Data are provided in different latency modes, as shown in the following table: Latency Time Description modes Archive Near Real- Products available to users within three hours after sensing. 1 month Time (NRT) Non time Products available to the users within one month after sensing. This 1 year critical additional delay allows consolidation of some auxiliary or ancillary data (e.g. precise orbit data) (NTC) Short time Products available to the users within 48 hours after sensing, due 1 month critical mainly to the consolidation of some auxiliary or ancillary data (e.g. preliminary restituted orbit data) (STC) (Only for SRAL products) Table 1: Latency mode of CODA data The selection of a product type in terms of delivery time (NRT, STC and NTC) is a trade-off between real-time needs and the final accuracy needed. 1.1 CODArep Online Rolling Archive Sentinel-3 data on CODA are always processed using the last available algorithms, but algorithms are periodically updated. So, in order to allow users to be able to access consistent datasets, “older” OLCI and SRAL NTC data have been reprocessed according to the latest standards. These reprocessed datasets are available via the online archive at this link: https://codarep.eumetsat.int. 1 In case of need for data older than one year, please go to EUMETSAT Data Centre https://www.eumetsat.int/website/home/Data/DataDelivery/EUMETSATDataCentre/index.html Page 4 of 56 EUM/OPS-SEN3/MAN/16/880763 v2B Draft, 18 October 2018 CODA user manual Like for CODA online archive, users can access CODArep archive using their Earth Observation Portal (EO Portal) credentials or setting up an EO Portal