Help Content > Import Data > Download

Purpose

This tool allows user to perform a query and download Sentinel-2 data from the Copernicus Data Space (https://dataspace.copernicus.eu/browser). An account with login credentials is required.

Technical Note

This tool performs a search for Sentinel-2 data according to the query built through the input parameters. According to today's ESA policies, a maximum of two concurrent downloads per account are allowed. The downloaded data has to be decompressed. To display the downloaded data, the TCI file (or the bands 4-3-2) in the GRANULE\L1C_*\IMG_DATA folder has to be loaded in the view.

When started from the SARscape graphical user interface (under Import Data->Sentinel-2 Data Download), the downloader is executed as a stand-alone, detached window. In this way, the downloading process does not depend on ENVI: you can even close ENVI while the downloader will continue to run. Under Linux, we use the "xterm" application to spawn the downloader into a stand-alone terminal: please make sure that this application is already installed on the machine where you are using SARscape. Xterm is usually available by default on most of the available Linux distributions or can be easily installed through the various distribution repositories (e.g., under RHEL/CentOS, simply run "yum install xterm" as administrator to install it). However, it is not possible to start the download while another process is running on the same working directory. If this happens, the first process will be killed and has to be resumed again.

Product Type:

Level-1C: Top-of-atmosphere reflectances in cartographic geometry,

Level-2A: Bottom-of-atmosphere reflectance in cartographic geometry. products are nominally published 48-60 hours after the publication of the corresponding L1C products.

Level-2Ap data are the products generated before March 2018.

Progress File

When at least one full data is downloaded, a Progress File named as defined in the Output tab is created in the output directory. This file can be used to skip already downloaded files which match the query. This file contains a list of all the data which are completely downloaded and the MD5 match the one provided by Copernicus Data Space. When a second request is preformed using the Sentinel Data Download tool, it is possible to set an already existing Progress File in the Progress File field. The software makes the following steps

•creates a list of needed files which fulfill the query created by the user using the provided parameters

•check if files in this this list are already present in the Progress File (if provided). If they are present, the files are not downloaded (again) and are skipped

•If a file is already downloaded, present in the output directory and the list of needed files but not in the Progress File, the software performs a MD5 check with the file present on the Copernicus Data Space server and if they match, the Progress file is actualized with this acquisition.

This functionality is helpful when an archive has to be updated with new files.

IMPORTANT: never use the same Progress File when using two concurrent downloads!

Concurrent downloads

One account allows a maximum of two concurrent download. Two different download can be launched with this tool but it is imperative to use two different progress files.

Please note: According to the connection speed the download of a single image can take up to several hours.

Please note: Data Space also deals with data provided through the Long Term Archive (LTA) by automatically triggering and monitoring the acquisition of files no longer available in the online storage.

Input Files

Optional Input Files

Input file(s) name of the image to be used as geographic reference for the search query. These files are mandatory if no shapefile or coordinate box is given as a reference. These files can be geocoded files, slant range or ground range files. However, the data type of the whole list has to be the same.

Optional Files

Geographical region

A vector file (.shp), or a Google Earth file (.kml or .kmz) can be upload to specify a region of interest. All acquisitions inside or intersecting this polygon are returned. The shapefile must be in GEO-GLOBAL cartographic system.

Parameters - Principal Parameters

Geographic Region

Box coordinates. All acquisitions inside or intersecting this box are returned. These fields have to be left empty if a shapefile is used as spatial reference. Co-ordinate decimal values must be entered using the dot (e.g. 29.30) and not the comma (e.g. 29,30) character.

West

The Westernmost cartographic co-ordinate (in decimal degrees).

North

The Northernmost cartographic co-ordinate (in decimal degrees).

East

The Easternmost cartographic co-ordinate (in decimal degrees).

South

The Southernmost cartographic co-ordinate (in decimal degrees).

From

Sensing period start date (day-MONTH-year), dd-MMM-yyyy, (01-JAN-1970).

Sensing period stop date (day-MONTH-year), dd-MMM-yyyy, (01-JAN-1970).

Preview Only

With this flag the Preview Mode shows the RGB considering the bands 4-3-2 .

Unzip Files

With this flag on, the downloaded files will be unzipped. to the directory selected in the Output Files.

Product Type

Filter for product type (S2MSI1C, S2MSC2A, S2MSC2Ap). This parameter is optional.

Relative Orbit

Filter for relative orbit (e.g. 1, 2, 3... ). This parameter is optional.

Wait For Completion

It allows to close the panel ones the process is completed.

Cloud Coverage

Percentage of cloud coverage of S2 products for each area covered by a reference band. Possible values go from 0 TO 100.

Cloud Coverage

Percentage of cloud coverage of S2 products for each area covered by a reference band. Possible values go from 0 TO 100.

Username of Sentinel Scientific Hub login credentials. This field is mandatory.

Data Space Login - PASSWORD

Password of Sentinel Scientific Hub login credentials. This field is mandatory.

Data Space concurrent downloads

Maximum number of simultaneous performed download (available download from 0 to 2).

Parameters - Global

It brings to the general section of the Preferences parameters. Any modified value will be used and stored for further processing sessions.

Parameters - Data Space Services

Data Space Base URL

It allows setting the Downloader web API entry point to perform queries (http://catalogue.dataspace.copernicus.eu/resto/api/collections/).

Data Space Search URL

Subdirectory appended to the base_url address for performing search operations.

Data Space Data URL

Parameter list for performing data downloading operations.

Data Space Connection timeout

The number of seconds the Multidownloader will wait on Copernicus Data Space before considering a pending connection failed.

Data Space Download timeout

The number of seconds the Multidownloader will wait on Copernicus Data Space to download at least the number of bytes specified in the download_speed field before considering a pending download failed.

Data Space Download Speed

A threshold value, in byte, of data that must be downloaded from Copernicus Data Space within the specified download time out, otherwise the connection is considered lost and an error is triggered.

Parameters - Data Space Account

Data Space Login - USERNAME

Username of Copernicus Data Space credentials. This field is optional only if the ASF login is inserted.

Data Space Login - USERNAME

Password of Copernicus Data Space credentials. This field is optional only if the ASF login is inserted.

Data Space concurrent download

Maximum number of simultaneous performed download (available download from 0 to 2, if 0 is selected the search is not performed in Copernicus Data Space).

Parameters - Other Parameters

It brings to the general section of the Preferences parameters. Any modified value will be used and stored for further processing sessions.

Output Files

Progress File Name

Name of the progress file. All the files found will be downloaded in this directory. More information in the technical notes.

In case the Preview Mode is active, no SAR data is downloaded. Instead, following files will be created for each acquisition:

*.png

Quicklook image file of the acquisition.

*.kml

Kml file, which can be opened in Google Earth, ArcGIS Earth (or similar). This file contains a footprint polygon and will drape the *.png image

*.safe

This file which contains the general product information of the acquisition in XML format. The original file is called manifest.safe. It will be automatically renamed during download in order to have several different manifest.safe in the same folder. More information here https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification

*.dat (with .hdr)

Image quicklook file and corresponding hdr file readable in any GIS software.

Unzip files to this directory

All the downloaded files are unzipped in this directory.

General Functions

Exec

The processing step is executed.

Store Batch

The processing step is stored in the batch list. The Batch Browser button allows to load the batch processing list.

The window will be closed.

Help

Specific help document section.

Specific Function(s)

None.

Sentinel-2 Download

Sentinel-2 Download