Copernicus Data Space Ecosystem¤

Copernicus Data Space Ecosystem (CDSE) is a platform providing free and open access to Copernicus Earth observation data and services. It enables users to explore, process, and analyze satellite imagery and geospatial data, supporting various applications in environmental monitoring, climate research, and sustainable development. The CDSE provides different APIs. The SIPT library is using the STAC endpoint.

Getting Access to the CRM API¤

An Copernicus account is required to download data from the dataspace. You can create an account by registering here.
Use your username and password for authentication when using the SIPT library.

Parameters¤

Name	Type	Description
`out_dir`	`str`	Output direcotry. If the directory already contains previously downloaded scenes, these are treated as cached and excluded from the download.
`collection`	`str \\| Collection`	The collection to query. A list of all possible collections can be obtained by `CDSE.available_collections()`. Some common collection are also available as enumerations in `CDSE.Collection`.
`shapefile_path`	`str`	Path to a valid shapefile. Supported formats: `.shp`, `.geojson`, `.kml`, `.gpkg`. You can find shapefiles from sources like OSM Boundaries.
`start_date`	`str`	Start date for temporal filtering. Date string muste be in format `yyyy-mm-dd`.
`end_date`	`str`	End date for temporal filtering. Date string muste be in format `yyyy-mm-dd`. Default is `None` which meants until the present.
`num_processes`	`int`	Number or concurrent download threads. br>Default `1`.

Example¤

Python

from sipt.retrieval import CDSE

collection = CDSE.Collection.SENTINEL_2_L2A
# Alternatively:
collection = 'sentinel-2-l2a'

cdse = CDSE("username", "password")
# Start the download
cdse.retrieve("./data", collection, "path/to/your/shapefile.geojson", '2023-07-01', '2024-08-01', 3)