README.md

🛰️ Sentinel-2 Imagery Processing Starter Kit

Process real satellite data in minutes — not days.

What's included

sentinel2_starter_kit/
├── sentinel2_starter_kit.ipynb   ← Main notebook (start here)
├── requirements.txt
├── .env.example                  ← Copy to .env and fill in credentials
└── src/
    ├── auth.py                   ← CDSE authentication (OAuth2 + S3)
    ├── search.py                 ← Product catalogue search
    ├── download.py               ← Band-level S3 download
    ├── processing.py             ← NDVI, NDWI, RGB composites
    ├── export.py                 ← Cloud Optimized GeoTIFF export
    └── visualization.py          ← Matplotlib + Folium plots

Quick start

1. Create a CDSE account (free)

Sign up at dataspace.copernicus.eu

2. Generate S3 credentials

Log in → User Settings → S3 Credentials → Generate

3. Set up your environment

cp .env.example .env
# Edit .env with your credentials

4. Install dependencies

pip install -r requirements.txt

5. Open the notebook

jupyter notebook sentinel2_starter_kit.ipynb

Edit the configuration block at the top of the notebook to set your area of interest and date range, then run all cells.

Outputs

The notebook produces:

• outputs/ndvi_YYYY-MM-DD.tif — NDVI Cloud Optimized GeoTIFF
• outputs/ndwi_YYYY-MM-DD.tif — NDWI Cloud Optimized GeoTIFF
• outputs/true_color_YYYY-MM-DD.tif — True color RGB COG
• outputs/false_color_YYYY-MM-DD.tif — False color NIR COG
• outputs/*.png — Publication-ready visualizations

All GeoTIFFs can be opened directly in QGIS, ArcGIS, or any GIS platform.

System requirements

• Python 3.9+
• ~500 MB disk space per processed scene (bands only, not full product)
• Internet connection for CDSE API calls

---

Sentinel-2 data © European Space Agency (ESA), provided free of charge via the Copernicus programme.