Skip to content

Tutorials: Installation and Initial Setting

Jump to bottom
Roberto Del Prete edited this page Aug 25, 2025 · 1 revision

Φ-Down Tutorials

Welcome to the phidown wiki! This section provides step-by-step tutorials on how to use Φ-Down for different tasks. Each tutorial is organized as a dedicated page.

Step 1: Installation

Install from PyPI (Recommended)

pip install phidown

Or Install from Source with PDM or pip

git clone https://github.com/ESA-PhiLab/phidown.git
cd phidown
pip install pdm
pdm install # or pip install .

Configure Credentials

To authenticate with the Copernicus Data Space Ecosystem (CDSE), you must provide S3 access credentials. These can be configured using a .s5cfg file or passed directly via the command line.

Option 1: Configure with .s5cfg File

Create a file named .s5cfg in the working directory and add the following content:

Manage S3 Credentials: https://eodata-s3keysmanager.dataspace.copernicus.eu/panel/s3-credentials

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key
aws_region = eu-central-1
host_base = eodata.dataspace.copernicus.eu
host_bucket = eodata.dataspace.copernicus.eu
use_https = true
check_ssl_certificate = true

Φ-Down — A Python library for streamlined access to Copernicus Data Space Ecosystem (CDSE) data.

Citation

If you use Φ-Down in your research or applications, please cite:

@misc{delprete2025phidown,
  author       = {Del Prete, Roberto},
  title        = {phidown: A Python Tool for Streamlined Data Downloading from CDSE},
  year         = {2025},
  month        = {May},
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.15332053},
  url          = {https://doi.org/10.5281/zenodo.15332053}
}
Clone this wiki locally