Captures refugee data as publsihed by UNHCR
# Uganda Refugee Population — Interactive Dashboard
**Launch the live dashboard →**
Interactive analysis of UNHCR Uganda's **Active Population by Settlement** report (31 March 2026), covering **1,999,576 registered refugees and asylum-seekers** across 14 settlements.
Built with **Python, Streamlit and Plotly**. All 17 visualisations are interactive — hover for values, zoom, pan, and switch between light and dark themes.
---
## Features
### Filters (sidebar)
| Filter | Options | Behaviour |
|---|---|---|
| **Region** | Western, West Nile, Central | Cascades through all charts and KPIs |
| **Country of Origin** | 9 origin countries (South Sudan, DRC, Sudan, Eritrea, Somalia, Burundi, Rwanda, Ethiopia, Other) | When deselected, the age/gender data is **proportionally scaled** to match the selected origin mix — not simply hidden |
| **Gender** | All, Female, Male | Applies to every chart including age pyramid |
| **Age Group** | All 6 age brackets from 0-4 to 60+ | Filters age-specific chart data |
| **Adult vs Child** | All, Child (0-17), Adult (18+) | Quick toggle for programme targeting |
### Download filtered data
A **Download filtered data (CSV)** button at the bottom of the sidebar exports the currently filtered settlement-level dataset.
---
### Dashboard tabs (17 charts)
| Tab | Charts |
|---|---|
| **Overview** | Settlement totals (ranked horizontal bar), gender summary bar, regional population donut, age-group donut, age & gender pyramid |
| **Age & Gender** | Age composition by settlement (stacked bar), female vs male (grouped bar) |
| **Country of Origin** | Country-of-origin distribution (ranked bar), settlement diversity index (Simpson's, with 0.2 / 0.5 reference lines), origin dominance bar, nationality composition (stacked bar), concentration heatmap |
| **Demographic Insights** | Youth bulge (18-35 %), child share (0-17 %), elderly share (60+ %), gender parity bar (with 50 % reference line) |
| **Programme Targeting** | Education vs live …