This is a Disease Tracker made for Africa in our First H-FGA session
# π Africa Disease Tracker
A comprehensive, production-ready disease tracking system for Africa featuring interactive maps, WHO API integration, and 10+ classical epidemiological visualizations.
---
## π― Features
### Core Capabilities
- πΊοΈ **Interactive Disease Maps** - Choropleth maps showing disease prevalence across 54 African countries
- π **10+ Classical Visualizations** - Time-tested public health charts used by epidemiologists
- π¦ **Multi-Disease Support** - Malaria, HIV/AIDS, Tuberculosis, COVID-19
- π₯ **Comprehensive Demographics** - Age groups, gender, family size, pregnancy data
- π **Time-Series Analysis** - Daily/Monthly/Yearly trends with seasonal patterns
- π **WHO API Integration** - Real-time data from Global Health Observatory
### Classical Epidemiological Visualizations
1. β
Choropleth Disease Prevalence Map
2. β
Incidence Rate Heatmap (Country Γ Time)
3. β
Age Pyramid with Disease Overlay
4. β
Mortality vs Incidence Scatter Plot
5. β
Seasonal Trend Line (Multi-Year)
6. β
Small Multiples (Country-wise Comparisons)
7. β
Disease Burden Stacked Area Chart
8. β
Gender Disparity Analysis
9. β
Urban vs Rural Comparison
10. β
Excess Mortality Assessment
---
## π Quick Start
### Local Development
```bash
# Clone the repository
git clone
github.com
cd africa-disease-tracker
# Install dependencies
pip install -r requirements.txt
# Run the dashboard
streamlit run app.py
```
Dashboard will be available at **
http://localhost:8501**
### Deploy to Streamlit Cloud
1. Push this repo to GitHub
2. Go to share.streamlit.io
3. Connect your GitHub account
4. Select this repository
5. Click "Deploy"
---
## π Project Structure
```
africa-disease-tracker/
βββ app.py # Main Streamlit application
βββ config.py # Configuration (diseases, countries, colors)
βββ utils.py # Utility functions & custom CSS
βββ data_fetcher.py # WHO API integration & data processin β¦