Skip to content

charkelham/ukraine-humanitarian-dashboard

Repository files navigation

🇺🇦 Ukraine Humanitarian Dashboard

An interactive four-panel dashboard tracking the humanitarian situation in Ukraine since the February 2022 escalation — covering internal displacement, conflict fatalities, humanitarian funding flows, and oblast-level displacement patterns.

📊 Dashboard Panels

Panel Description Source
IDP Displacement Over Time Total internally displaced persons across all oblasts, tracked across IOM DTM survey rounds (May 2023 – Apr 2025) IOM DTM
Conflict Fatalities by Month Monthly conflict-related fatalities from Feb 2022 – Mar 2025, showing the evolution of violence intensity ACLED
Humanitarian Funding by Sector Committed vs paid funding by humanitarian cluster (USD millions), 2024 OCHA FTS
Displacement by Oblast Most recent IDP counts by oblast — four occupied oblasts (Donetska, Luhanska, Khersonska, Zaporizka) excluded due to data access constraints IOM DTM

🔗 Live Dashboard

View the interactive dashboard — hosted via GitHub Pages, no install required.

🗂 Repository Structure

ukraine-humanitarian-dashboard/
├── Ukraine Humanitarian Dashboard.ipynb   # Jupyter notebook — full analysis pipeline
├── conflict_by_oblast.csv                 # ACLED conflict event-level data (~309k rows)
├── funding_raw.csv                        # OCHA FTS funding flow data (1,270 rows)
├── dashboard.html                         # Pre-built interactive dashboard (Plotly)
└── README.md

Note: The notebook references a data/idp_by_oblast.csv file (IOM DTM displacement data) which is not included in this repository due to distribution restrictions. The notebook expects data files in a data/ subdirectory — adjust paths or move files as needed to reproduce locally.

🛠 Tech Stack

  • Python 3 with pandas for data processing
  • Plotly for interactive visualisation (4-panel subplot layout)
  • Jupyter Notebook for reproducible analysis
  • Output is a single self-contained HTML file (all chart data embedded)

🔧 How to Run

# Clone the repo
git clone https://github.com/charkelham/ukraine-humanitarian-dashboard.git
cd ukraine-humanitarian-dashboard

# Install dependencies
pip install pandas plotly

# Run the notebook or execute cells to regenerate dashboard.html
jupyter notebook "Ukraine Humanitarian Dashboard.ipynb"

📦 Data Sources

Dataset Source Coverage
IDP displacement by oblast IOM Displacement Tracking Matrix May 2023 – Apr 2025
Conflict events & fatalities ACLED Feb 2022 – Mar 2025
Humanitarian funding flows OCHA Financial Tracking Service 2024

📝 Key Findings

  • 3.4 million internally displaced persons as of April 2025 (down from a peak of 5.1M in May 2023)
  • Dnipropetrovska (588k) and Kharkivska (463k) host the largest IDP populations
  • Conflict fatalities escalated sharply from mid-2024, with monthly deaths exceeding 9,000 in June and November 2024
  • Multipurpose Cash ($210M committed) and Protection ($136M) are the largest funded sectors
  • Food Security has the highest paid disbursement ($320M) but relatively lower commitments ($94M)

Built as a portfolio project demonstrating humanitarian data analysis, ETL pipeline design, and interactive dashboard development.

About

Ukraine Humanitarian Dashboard

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors