Added basic README.md.
This commit is contained in:
parent
6bbaa4b3eb
commit
e98325a3a6
1 changed files with 70 additions and 0 deletions
70
README.md
Normal file
70
README.md
Normal file
|
|
@ -0,0 +1,70 @@
|
|||
# Satellite Data Fusion Pipeline
|
||||
|
||||
A Python pipeline for downloading, processing, and fusing Sentinel-2 and Sentinel-3 satellite imagery to generate high-resolution NDVI time series.
|
||||
|
||||
## Features
|
||||
|
||||
- **Data Download**: Downloads Sentinel-2 L2A (via AWS Earth Search) and Sentinel-3 OLCI (via OpenEO/Copernicus)
|
||||
- **Cloud Detection**: Identifies cloud-covered images using NDVI analysis
|
||||
- **EFAST Fusion**: Combines S2 and S3 data using the EFAST algorithm for enhanced temporal resolution
|
||||
- **NDVI Calculation**: Generates Normalized Difference Vegetation Index from raw and fused data
|
||||
- **Web Visualization**: Interactive web viewer for exploring NDVI time series and imagery
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
pip install git+https://github.com/DHI-GRAS/efast.git
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
Set environment variables for Copernicus Data Space authentication:
|
||||
- `CDSE_USER`: Copernicus Data Space username
|
||||
- `CDSE_PASSWORD`: Copernicus Data Space password
|
||||
|
||||
## Usage
|
||||
|
||||
```python
|
||||
from run import run_pipeline
|
||||
|
||||
run_pipeline(season=2024, site_position=(47.116171, 11.320308), site_name="innsbruck")
|
||||
```
|
||||
|
||||
The pipeline processes data in stages:
|
||||
1. Download S2/S3 imagery
|
||||
2. Generate NDVI from raw data
|
||||
3. Detect clouds
|
||||
4. Prepare data for fusion
|
||||
5. Run EFAST fusion
|
||||
6. Generate NDVI from fused outputs
|
||||
|
||||
## Data Structure
|
||||
|
||||
```
|
||||
data/
|
||||
{site_name}/
|
||||
{season}/
|
||||
raw/
|
||||
s2/ # Sentinel-2 GeoTIFFs
|
||||
s3/ # Sentinel-3 GeoTIFFs
|
||||
ndvi/ # NDVI from raw data
|
||||
prepared/
|
||||
s2/ # Prepared S2 data
|
||||
s3/ # Prepared S3 data
|
||||
fusion/ # EFAST fusion outputs
|
||||
ndvi/ # NDVI from prepared/fused data
|
||||
clouds.json # Cloud detection results
|
||||
```
|
||||
|
||||
## Web Viewer
|
||||
|
||||
Run a local HTTP server to view the web interface:
|
||||
|
||||
```bash
|
||||
cd webapp
|
||||
python3 -m http.server 8000
|
||||
```
|
||||
|
||||
Then open `http://localhost:8000/webapp` in your browser to visualize NDVI time series and compare S2, S3, and fusion outputs.
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue