# josuebatasema9-ux/scripts-wcs-version-1 architecture

> Architecture diagram of the GitHub repository josuebatasema9-ux/scripts-wcs-version-1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/josuebatasema9-ux/scripts-wcs-version-1
- Repository: https://github.com/josuebatasema9-ux/scripts-wcs-version-1

## Overview

This repository is a quasi-real-time deforestation monitoring workflow for Kahuzi-Biega National Park. An operator launches individual stages or the ordered pipeline; Sentinel-1/2 composites feed spectral analysis, SAR-optical fusion and land-cover classification, then loss and hotspot analysis, alerting, validation and patrol reporting. Google Earth Engine and Drive provide the documented acquisition/export boundary. Shared raster and configuration helpers support several stages. The README documents the overall sequence; some later-stage inputs and internal calls were not sampled, so those links reflect documented workflow rather than inspected call sites.

Main entry points: [`run_pipeline.py`](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/run_pipeline.py) (Pipeline runner), [`src/s01_acquisition_gee.py`](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s01_acquisition_gee.py) (Sentinel composites), [`src/s05_loss_detection.py`](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s05_loss_detection.py) (Forest-loss maps), [`src/utils.py`](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/utils.py) (Raster and config utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_acquisition["Satellite acquisition"]
  node_acquisition["Sentinel composites"]
end

subgraph group_analysis["Fusion and classification"]
  node_signatures["Spectral signatures"]
  node_fusion["SAR-optical fusion"]
  node_fusion_metrics["Fusion metrics<br/>[fusion_metrics.py]"]
  node_classification["Land-cover classification"]
  node_segmentation["Deep segmentation"]
end

subgraph group_monitoring["Loss and alerts"]
  node_loss["Forest-loss maps"]
  node_hotspots["Emerging hotspots"]
  node_alerts["NRT radar alerts<br/>[s07_nrt_alerts.py]"]
end

subgraph group_operations["Validation and patrols"]
  node_validation["Accuracy validation<br/>[s08_validation.py]"]
  node_patrol["Patrol report"]
end

subgraph group_shared["Shared utilities"]
  node_utils["Raster and config utilities<br/>[utils.py]"]
end

node_operator(("Operator"))
node_runner["Pipeline runner<br/>[run_pipeline.py]"]
node_gee["Earth Engine"]
node_drive["Google Drive"]

node_operator -->|"launches"| node_runner
node_runner -->|"dispatches"| node_acquisition
node_runner -->|"dispatches"| node_signatures
node_runner -->|"dispatches"| node_fusion
node_runner -->|"dispatches"| node_classification
node_runner -->|"dispatches"| node_loss
node_runner -->|"dispatches"| node_hotspots
node_runner -->|"dispatches"| node_alerts
node_runner -->|"dispatches"| node_validation
node_runner -->|"dispatches"| node_patrol
node_acquisition -->|"queries imagery"| node_gee
node_acquisition -->|"exports composites"| node_drive
node_acquisition -->|"provides composites"| node_signatures
node_acquisition -->|"provides bands"| node_fusion
node_fusion -->|"uses metrics"| node_fusion_metrics
node_fusion -->|"provides features"| node_classification
node_classification -->|"supports deep models"| node_segmentation
node_classification -->|"provides class maps"| node_loss
node_loss -->|"provides loss series"| node_hotspots
node_loss -.->|"supports confirmation"| node_alerts
node_hotspots -.->|"feeds assessment"| node_validation
node_alerts -.->|"feeds assessment"| node_validation
node_validation -.->|"informs priorities"| node_patrol
node_acquisition -->|"loads config"| node_utils
node_signatures -->|"uses helpers"| node_utils
node_loss -->|"reads and writes rasters"| node_utils
node_hotspots -->|"reads rasters"| node_utils
node_alerts -->|"reads and writes rasters"| node_utils

click node_runner "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/run_pipeline.py"
click node_acquisition "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s01_acquisition_gee.py"
click node_signatures "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s02_signatures_separability.py"
click node_fusion "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s03_fusion_model.py"
click node_fusion_metrics "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/fusion_metrics.py"
click node_classification "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s04_classification.py"
click node_segmentation "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s04b_deep_segmentation.py"
click node_loss "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s05_loss_detection.py"
click node_hotspots "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s06_hotspots_ehsa.py"
click node_alerts "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s07_nrt_alerts.py"
click node_validation "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s08_validation.py"
click node_patrol "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s09_patrol_report.py"
click node_utils "https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/utils.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_acquisition toneBlue
class node_signatures,node_fusion,node_fusion_metrics,node_classification,node_segmentation toneAmber
class node_loss,node_hotspots,node_alerts toneMint
class node_validation,node_patrol toneRose
class node_utils,node_operator,node_gee,node_drive toneIndigo
class node_runner toneTeal
```

## Components

### Satellite acquisition

- [Sentinel composites](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s01_acquisition_gee.py): `src/s01_acquisition_gee.py`

### Fusion and classification

- [Spectral signatures](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s02_signatures_separability.py): `src/s02_signatures_separability.py`
- [SAR-optical fusion](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s03_fusion_model.py): `src/s03_fusion_model.py`
- [Fusion metrics](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/fusion_metrics.py): `src/fusion_metrics.py`
- [Land-cover classification](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s04_classification.py): `src/s04_classification.py`
- [Deep segmentation](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s04b_deep_segmentation.py): `src/s04b_deep_segmentation.py`

### Loss and alerts

- [Forest-loss maps](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s05_loss_detection.py): `src/s05_loss_detection.py`
- [Emerging hotspots](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s06_hotspots_ehsa.py): `src/s06_hotspots_ehsa.py`
- [NRT radar alerts](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s07_nrt_alerts.py): `src/s07_nrt_alerts.py`

### Validation and patrols

- [Accuracy validation](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s08_validation.py): `src/s08_validation.py`
- [Patrol report](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/s09_patrol_report.py): `src/s09_patrol_report.py`

### Shared utilities

- [Raster and config utilities](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/src/utils.py): `src/utils.py`

### Other components

- **Operator**
- [Pipeline runner](https://github.com/josuebatasema9-ux/scripts-wcs-version-1/blob/main/run_pipeline.py): `run_pipeline.py`
- **Earth Engine**
- **Google Drive**

## Connections

- Operator → Pipeline runner: launches (evidence: `run_pipeline.py`)
- Pipeline runner → Sentinel composites: dispatches (evidence: `run_pipeline.py`)
- Pipeline runner → Spectral signatures: dispatches (evidence: `run_pipeline.py`)
- Pipeline runner → SAR-optical fusion: dispatches (evidence: `run_pipeline.py`)
- Pipeline runner → Land-cover classification: dispatches (evidence: `run_pipeline.py`)
- Pipeline runner → Forest-loss maps: dispatches (evidence: `run_pipeline.py`)
- Pipeline runner → Emerging hotspots: dispatches (evidence: `run_pipeline.py`)
- Pipeline runner → NRT radar alerts: dispatches (evidence: `run_pipeline.py`)
- Pipeline runner → Accuracy validation: dispatches (evidence: `run_pipeline.py`)
- Pipeline runner → Patrol report: dispatches (evidence: `run_pipeline.py`)
- Sentinel composites → Earth Engine: queries imagery (evidence: `src/s01_acquisition_gee.py`)
- Sentinel composites → Google Drive: exports composites (evidence: `src/s01_acquisition_gee.py`)
- Sentinel composites → Spectral signatures: provides composites (evidence: `README.md`)
- Sentinel composites → SAR-optical fusion: provides bands (evidence: `src/s03_fusion_model.py`)
- SAR-optical fusion → Fusion metrics: uses metrics (evidence: `src/s03_fusion_model.py`)
- SAR-optical fusion → Land-cover classification: provides features (evidence: `src/s03_fusion_model.py`)
- Land-cover classification → Deep segmentation: supports deep models (evidence: `README.md`)
- Land-cover classification → Forest-loss maps: provides class maps (evidence: `README.md`)
- Forest-loss maps → Emerging hotspots: provides loss series (evidence: `README.md`)
- Forest-loss maps → NRT radar alerts: supports confirmation
- Emerging hotspots → Accuracy validation: feeds assessment
- NRT radar alerts → Accuracy validation: feeds assessment
- Accuracy validation → Patrol report: informs priorities
- Sentinel composites → Raster and config utilities: loads config (evidence: `src/s01_acquisition_gee.py`)
- Spectral signatures → Raster and config utilities: uses helpers (evidence: `src/s02_signatures_separability.py`)
- Forest-loss maps → Raster and config utilities: reads and writes rasters (evidence: `src/s05_loss_detection.py`)
- Emerging hotspots → Raster and config utilities: reads rasters (evidence: `src/s06_hotspots_ehsa.py`)
- NRT radar alerts → Raster and config utilities: reads and writes rasters (evidence: `src/s07_nrt_alerts.py`)
