Interactive barchart showing the maternal mortality rates across africa
# africa-mmr
Interactive horizontal bar chart of **maternal mortality ratios (MMR per 100,000 live births)** across African countries, using the latest reported year per country from the WHO Global Health Observatory.
**Live chart:**
bk-advisors.github.io
## Outputs
| Asset | Purpose | Path |
|-------|---------|------|
| Interactive HTML | GitHub Pages landing page (ggiraph tooltips) | index.html |
| Portrait PNG (4:5) | LinkedIn image post (3000×3750 @ 300 dpi) | output/africa-mmr.png |
| Landscape PNG (1.91:1) | LinkedIn link share (4200×2200 @ 300 dpi) | output/africa-mmr-wide.png |
## Data
| Column | Source | Indicator |
|--------|--------|-----------|
| `mmr`, `low`, `high` | WHO GHO | **MDG_0000000026** — Maternal mortality ratio, modeled, per 100,000 live births |
| `country` | WHO GHO country dimension | `DIMENSION/COUNTRY/DimensionValues` |
`R/prep_africa_mmr.R` selects the latest year per African country and joins on the country dimension for full names. Raw JSON dumps (`data/who_*_raw.json`) are gitignored — see the header of that script for the curl commands to re-fetch them (R's `fromJSON()` on the URL fails on Windows due to TLS).
## Repo layout
```
interactive-africa-mmr.qmd Quarto source for the interactive chart
index.html Rendered self-contained output (served by Pages)
_quarto.yml Quarto project config
data/africa_mmr.csv Cleaned dataset (country, code, year, mmr, low, high)
R/
theme_bka.R BKA-branded ggplot2 theme (local copy)
prep_africa_mmr.R Raw WHO JSON -> africa_mmr.csv
africa-mmr-linkedin.R Generates the portrait + landscape PNGs
audit_figures.R Verifies post claims against the CSV
validate_sources.R Cross-checks CSV vs the live WHO API
fetch_validation_data.R Caches API responses to .rds for reports
output/ Publication-ready PNGs
```
## Build
All commands run from the repo root.
```bash
# 1 …