🚧 Under Construction: This documentation page is being actively developed. Content may change frequently.

InSAR Forest Disturbance Dataset

Sentinel-1 InSAR Processing for Forest Disturbance Detection

Automated pipeline for generating interferometric coherence stacks for deforestation monitoring

💻 Quick Start

# Clone repository
git clone https://github.com/ColmKeyes/InSAR_Forest_Disturbance_Dataset.git
cd InSAR_Forest_Disturbance_Dataset

# Install dependencies
conda env create -f environment.yml
conda activate insar-forest

# Run processing pipeline
python bin/1_generate_s1_catalog.py --area borneo
python bin/2_scene_pair_selector.py
python bin/4_download_s1_scenes.py

⚙️ API Usage

from src.sentinel1slc import Sentinel1Slc

# Initialize SLC processor
processor = Sentinel1Slc(
    output_dir="data/processed",
    dem_path="data/dem.tif",
    orbit_dir="data/orbits"
)

# Process single scene
processor.process_scene("S1A_IW_SLC_20250101")

📚 Documentation Hub

Section	Description	Link
API Reference	Full class/method documentation	API.md
Data Schema	Parquet data schema specification	SCHEMA.md
Processing Guide	Step-by-step pipeline guide	PROCESSING_GUIDE.md
Jupyter Examples	Example notebooks for analysis	notebooks/

📊 Data Schema

classDiagram
    class ScenePair {
        +reference_scene: str
        +secondary_scene: str
        +perpendicular_baseline: float
        +temporal_baseline: int
        +coherence: float
    }
    
    class RADDEvent {
        +event_id: UUID
        +timestamp: DateTime
        +geometry: Polygon
        +magnitude: float
        +confidence: float
    }
    
    ScenePair "1" -- "1" RADDEvent : associated_with

Loading

🧪 Version Compatibility

Component	Version	Notes
Python	3.10+	Required
SNAP	12.0	ESA Sentinel Toolbox
GDAL	3.8+	Geospatial processing
PyroSAR	0.16+	SAR processing library

🔧 Processing Pipeline

flowchart LR
    A[Sentinel-1 Catalog] --> B(Scene Pair Selection)
    B --> C(Baseline Calculation)
    C --> D[Download SLCs]
    D --> E[Interferometric Processing]
    E --> F[Coherence Calculation]
    F --> G[Terrain Correction]
    G --> H[Coregistered Stack]

Loading

🤝 Contributing

Contributions are welcome! Please see our contribution guidelines for details.

---

Developed at University College Dublin Earth Institute