S2Downloader
Free software: EUPL 1.2
Documentation: https://fernlab.git-pages.gfz-potsdam.de/products/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 from the AWS Public Datasets, the [Sentinel-2 Cloud-Optimized GeoTIFFs](https://registry.opendata.aws/sentinel-2-l2a-cogs/) managed by [element84](https://www.element84.com/). 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 "absolute/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 GFZ Helmholtz 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.
2 maintainers
Release files for s2downloader 1.4.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| s2downloader-1.4.6.tar.gz | 10.1 MB | Details |
Release files / s2downloader-1.4.6.tar.gz
| Download URL | s2downloader-1.4.6.tar.gz |
|---|---|
| Size | 10.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d715e4a1ea469deb3b3b00182ec3670b0fbcb7080b1f8874ddaa894c4a1326bc
|
|
BLAKE2b-256 checksum How to use checksums |
644730ae762f4a37d38c1bd37a07755c7fa2fb379b1195f7ccf77df4716ce34d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
