s2downloader 1.3.0

Downloader for Sentinel-2 from aws.

S2Downloader

• Free software: EUPL 1.2

• Documentation: https://fernlab.git-pages.gfz-potsdam.de/products/data-portal/s2downloader/doc/

• Information on how to cite the S2Downloader Python package can be found in the CITATION file.

• Submit feedback by filing an issue here

Downloader for Sentinel-2 data.

Feature overview

The S2Downloader allows to download Sentinel-2 L2A data from the cost-free element84 AWS Amazon Cloud server. It specifically serves the purpose to download data for user-defined area of interests (AOI), defined by a bounding box or whole tiles which are the original data product provided by ESA.

Features

Features on Sentinel-2 tile level

• download atmospheric corrected L2A Sentinel-2 thumbnail, overview, and data from AWS

• provide single date or time range for finding data at the server

• select which individual bands to download, all bands are supported: "coastal", "blue", "green", "red", "rededge1", "rededge2", "rededge3", "nir", "nir08", "nir09", "cirrus", "swir16", "swir22"

• provide UTM zone, latitude band and grid square to download whole tiles

Features on AOI level

• input data: configuration json file

• customizable filtering for noData

• optional: customizable mask SCL classes (default masked classes: clouds shadow, clouds, cirrus -> 3, 7, 8, 9, 10), all available classes:

  • 0 - No data

  • 1 - Saturated / Defective

  • 2 - Dark Area Pixels

  • 3 - Cloud Shadows

  • 4 - Vegetation

  • 5 - Bare Soils

  • 6 - Water

  • 7 - Clouds low probability / Unclassified

  • 8 - Clouds medium probability

  • 9 - Clouds high probability

  • 10 - Cirrus

  • 11 - Snow / Ice

• mosaic data from different tiles (same utm zone) into one tif file

• resample bands to user-defined target resolution

• select resampling method

Features for saving the results

• define output location

• save thumbnails for the available scenes

• save overviews for the available scenes

Installation

Install S2Downloader

Usage

Run with relative or absolute path to config json file:

S2Downloader --filepath "path/to/config.json"

Relative paths in the config file are supposed to be relative to the location of the repository.

See usage for more details about the config file.

Expected Output

The downloaded raster files and overviews are saved in .tif format, the thumbnails are saved as .jpg. Additional information is saved in a.json and a logging file.

See usage for more details about the output files.

History / Changelog

You can find the protocol of recent changes in the S2Downloader package here.

Contribution

Contributions are always welcome. Please contact us, if you wish to contribute to the S2Downloader.

Developed by

S2Downloader has been developed by FERN.Lab, the Helmholtz Innovation Lab “Remote sensing for sustainable use of resources”, located at the Helmholtz Centre Potsdam, GFZ German Research Centre for Geosciences. FERN.Lab is funded by the Initiative and Networking Fund of the Helmholtz Association.

Credits

This package was created with Cookiecutter and the fernlab/cookiecutter-pypackage project template.