A district-scale MODIS-VIIRS mismatch analysis of Ghana's fire regime
# ghana-fire-mismatch
## Overview
`ghana-fire-mismatch` is a reproducible Ghana fire mismatch analysis repository. It compares two complementary satellite fire evidence streams in a common spatial and monthly framework:
- **VIIRS active-fire detections**, treated as a thermal activity signal.
- **MODIS MCD64A1 burned area**, treated as a mapped burned-area impact signal.
The repository prepares spatial units and fire-observation panels, merges active-fire and burned-area evidence, and runs the Ghana MODIS burned-area and VIIRS active-fire mismatch analysis.
The public project contract is:
```text
data_processing/ prepares spatial units, fire panels, and merged analysis inputs.
mismatch_analysis/ consumes the merged panels and writes mismatch outputs.
```
## Scientific scope
The project compares product signals, not product truth. The core interpretation rules are:
- VIIRS active fire is a thermal activity signal.
- MODIS MCD64A1 burned area is a mapped burned-area impact signal.
- The products are complementary, not interchangeable.
- VIIRS active fire is not treated as validation for MODIS burned area.
- MODIS burned area is not treated as validation for VIIRS active-fire detections.
- Mismatch states are observational classifications, not direct error labels.
- The workflow supports descriptive and diagnostic analysis; it does not identify causal drivers.
The primary mismatch states are:
```text
both-zero
VIIRS-only
MODIS-BA-only
both-positive
```
## Repository layout
```text
ghana-fire-mismatch/
|-- README.md
|-- LICENSE
|-- CITATION.cff
|-- environment.yml
|-- pyproject.toml
|-- docs/
| |-- workflow.md
| |-- data_access.md
| |-- data_contracts.md
| |-- output_provenance.md
| |-- reproduction.md
| |-- github_release_checklist.md
| `-- known_limitations.md
|-- data_processing/
| |-- README.md
| |-- merge_af_ba_panels.py
| |-- tests/
| |-- geo_data_prep/
| |-- rp1_mv_firms_panels/
| `-- rp1_gee_ba_scripts/
|-- mismatch_analy …