eodal.downloader.sentinel2.creodias module

REST-API based downloading of Sentinel-2 datasets from CREODIAS.

Make sure to have a valid CREODIAS account and provide your username and password as environmental variables:

On a Linux system you can specify your credentials in the current Python environment by:

export CREODIAS_USER = "<your-user-name>"
export CREODIAS_PASSWORD= "<your-password>"

Copyright (C) 2022 Lukas Valentin Graf

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

eodal.downloader.sentinel2.creodias.query_creodias(start_date: date, end_date: date, max_records: int, processing_level: ProcessingLevels, bounding_box: Polygon, cloud_cover_threshold: int | None = 100) → DataFrame[source]

queries the CREODIAS Finder API to obtain available datasets for a given geographic region, date range and Sentinel-2 processing level (L1C or L2A).

NO AUTHENTICATION is required for running this query.

Parameters:

  • start_date – start date of the queried time period (inclusive)

  • end_date – end date of the queried time period (inclusive)

  • max_records – maximum number of items returned. NOTE that CREODIAS might limit this number!

  • processing_level – queried Sentinel-2 processing level

  • bounding_box – polygon in geographic coordinates (WGS84) denoting the queried region

  • cloud_cover_threshold – cloudy pixel percentage threshold (0-100%) for filtering mapper too cloudy for processing. All mapper with a cloud cover lower than the threshold specified will be downloaded. Per default all mapper are downloaded.

Returns:

results of the CREODIAS query (no downloaded data!) as pandas DataFrame