MarvellousAdedokun/Nigeria-Kidnappings

# 🔴 Nigeria Kidnapping & Abduction Analysis ### Boko Haram / ISWAP Operations · 2013–2024 > **Real data. Zero synthetic values.** > Built from a publicly documented conflict registry sourced directly from ACLED-corroborated press records. --- ## Dataset | Field | Detail | |-------|--------| | **Primary source** | Fredaekaraefod/Nigeria-Insurgency-Fatality-Records (GitHub) | | **Original data origin** | Armed Conflict Location & Event Data Project (ACLED) press-sourcing methodology | | **Format** | SQLite database (incidents.db) | | **Coverage** | 831 total conflict incidents · Nigeria · 2009–2026 | | **Kidnapping/abduction subset** | 49 events extracted for this analysis | | **Verification** | All events marked "Confirmed" or "Publicly Documented" with primary source links | | **Population data** | World Bank / datasets/population (CC BY 4.0) | --- ## Project Structure ``` nigeria_kidnapping/ ├── data/ │ ├── incidents.db # Raw SQLite (282 KB) — downloaded from GitHub │ ├── boko_haram_raw.csv # All 831 incidents as CSV │ ├── all_incidents_clean.csv # Cleaned full dataset │ ├── kidnapping_clean.csv # 49 kidnapping/abduction events only │ └── nigeria_population.csv # World Bank national population 2010–2024 ├── src/ │ ├── 01_clean.py # Download → clean → filter │ ├── 02_analysis.py # State-level metrics, per-capita rates, peaks │ ├── 03_charts.py # 5 publication-quality charts │ └── analysis_helpers.py # Shared data loader ├── charts/ │ ├── 01_yearly_trend.png │ ├── 02_by_state.png │ ├── 03_severity.png │ ├── 04_cumulative.png │ └── 05_heatmap.png ├── content.md ├── README.md └── requirements.txt ``` --- ## Quickstart ```bash pip install -r requirements.txt python src/01_clean.py # Download + clean python src/02_analysis.py # Print all metrics python src/03_charts.py # Generate 5 charts ``` --- ## Key Findings ### 1 · Borno State accounts for 49 …