Datasetpublic

africatic/africa-world-bank-health-population-time-series

Africa World Bank Health and Population Labeled Time Series Data This repository is part of the Africa Temporal Intelligence Corpus (ATIC). It contains sector-specific temporal corpus packages for African countries. ATIC sector repositories are designed for machine consumption first: Parquet tables, stable IDs, reproducible metadata, explicit provenance, review status, and separable semantic layers. Sector Scope Temporal health, nutrition, and population… See the full description on the dataset page: https://huggingface.co/datasets/africatic/africa-world-bank-health-population-time-series.

sourceHugging Faceapache-2.0updated 3mo agoView on Hugging Face

0likes390downloads

Dataset Card

Africa World Bank Health and Population Labeled Time Series Data

This repository is part of the Africa Temporal Intelligence Corpus (ATIC). It contains sector-specific temporal corpus packages for African countries.

ATIC sector repositories are designed for machine consumption first: Parquet tables, stable IDs, reproducible metadata, explicit provenance, review status, and separable semantic layers.

Sector Scope

Temporal health, nutrition, and population indicators for African countries, structured for timeline QA, health-system monitoring, epidemiological context retrieval, and reviewable annotation workflows.

Technical scope:

—life expectancy and mortality-adjacent indicators
—immunization coverage
—population health states
—service access and health-system risk indicators
—collection-guided source grouping: Africa · World Bank Indicators

Repository Layout

text

README.md
sector_manifest.yaml
packages/
  <package_id>/
    raw.parquet
    labels.parquet
    events.parquet
    relationships.parquet
    reasoning.jsonl
    metadata.yaml
    quality_report.json
    README.md
    LICENSE
    CHANGELOG.md
schemas/
ontology/
sources/
docs/
tools/

Package Index

Package	ISO3	Indicator	Coverage	Raw rows	Labels	Quality	Review priority
`somalia_sp_pop_80up_fe_5y_v0_1`	SOM	`Population ages 80 and above, female (% of female population)`	1960-01-01 to 2024-01-01	54	56	0.98	normal
`somalia_sp_pop_0014_ma_zs_v0_1`	SOM	`Population ages 0-14, male (% of male population)`	1962-01-01 to 2024-01-01	58	57	0.98	normal
`federal_republic_of_somalia_sp_pop_80up_fe_5y_v0_1`	SOM	`Population ages 80 and above, female (% of female population)`	1960-01-01 to 2024-01-01	54	56	0.98	normal
`federal_republic_of_somalia_sp_pop_0014_ma_zs_v0_1`	SOM	`Population ages 0-14, male (% of male population)`	1962-01-01 to 2024-01-01	58	57	0.98	normal
`guinea_sh_mlr_incd_p3_v0_1`	GIN	`Incidence of malaria (per 1,000 population at risk)`	2000-01-01 to 2024-01-01	21	20	0.98	normal
`guinea_sp_dyn_cdrt_in_v0_1`	GIN	`Death rate, crude (per 1,000 people)`	1960-01-01 to 2023-01-01	48	51	0.98	normal
`zambia_sh_sta_traf_p5_v0_1`	ZMB	`Mortality caused by road traffic injury (per 100,000 population)`	2000-01-01 to 2019-01-01	18	18	0.98	normal
`zambia_sp_pop_1564_ma_in_v0_1`	ZMB	`Population ages 15-64, male`	1960-01-01 to 2024-01-01	49	58	0.98	normal
`somalia_fed_rep_sh_hiv_artc_zs_v0_1`	SOM	`Antiretroviral therapy coverage (% of people living with HIV)`	2002-01-01 to 2024-01-01	16	16	0.98	normal
`somalia_fed_rep_sh_dyn_aids_fe_zs_v0_1`	SOM	`Women's share of population ages 15+ living with HIV (%)`	1990-01-01 to 2024-01-01	31	37	0.98	normal
`kenya_sp_pop_80up_ma_5y_v0_1`	KEN	`Population ages 80 and above, male (% of male population)`	1960-01-01 to 2024-01-01	56	69	0.98	normal
`kenya_sh_sta_anvp_q1_zs_v0_1`	KEN	`Antenatal care (doctor) (% of women with a birth): Q1 (lowest)`	1993-01-01 to 2014-01-01	5	5	0.98	normal
`guinea_bissau_sp_pop_3539_fe_5y_v0_1`	GNB	`Population ages 35-39, female (% of female population)`	1960-01-01 to 2024-01-01	48	52	0.98	normal
`guinea_bissau_sp_dyn_cdrt_in_v0_1`	GNB	`Death rate, crude (per 1,000 people)`	1960-01-01 to 2023-01-01	51	54	0.98	normal
`ethiopia_sp_pop_0014_ma_in_v0_1`	ETH	`Population ages 0-14, male`	1962-01-01 to 2024-01-01	47	49	0.98	normal
`ethiopia_sp_mtr_1519_q3_zs_v0_1`	ETH	`Teenage pregnancy and motherhood (% of women ages 15-19 who have had children or are currently pregnant): Q3`	2000-01-01 to 2019-01-01	5	5	0.98	normal
`zimbabwe_sp_pop_3034_fe_5y_v0_1`	ZWE	`Population ages 30-34, female (% of female population)`	1960-01-01 to 2023-01-01	56	55	0.98	normal
`zimbabwe_sh_fpl_hear_q3_zs_v0_1`	ZWE	`Heard family planning on radio and television (% of women): Q3`	1994-01-01 to 2015-01-01	5	5	0.98	normal
`south_africa_sh_dth_mort_v0_1`	ZAF	`Number of under-five deaths`	1981-01-01 to 2023-01-01	33	34	0.98	normal
`south_africa_sh_sta_mmrt_v0_1`	ZAF	`Maternal mortality ratio (modeled estimate, per 100,000 live births)`	1985-01-01 to 2023-01-01	27	33	0.98	normal
`eswatini_sm_pop_netm_v0_1`	SWZ	`Net migration`	1960-01-01 to 2024-01-01	55	70	0.98	normal
`eswatini_sp_pop_1564_fe_in_v0_1`	SWZ	`Population ages 15-64, female`	1960-01-01 to 2024-01-01	55	56	0.98	normal
`ghana_sp_pop_6064_ma_5y_v0_1`	GHA	`Population ages 60-64, male (% of male population)`	1961-01-01 to 2024-01-01	55	58	0.98	normal
`ghana_sp_pop_3034_fe_5y_v0_1`	GHA	`Population ages 30-34, female (% of female population)`	1960-01-01 to 2024-01-01	53	52	0.98	normal

Table Contract

Each package follows the ATIC dataset package contract:

—raw.parquet: source observations after light normalization.
—labels.parquet: proposed or reviewed statistical and temporal annotations.
—events.parquet: discrete events linked to evidence.
—relationships.parquet: temporal relationships between observations, labels, and events.
—reasoning.jsonl: generated explanations kept separate from approved labels.
—metadata.yaml: package identity, source provenance, schema version, license, review status, and evidence catalog.
—quality_report.json: row counts, source columns, parse failures, coverage gaps, label distributions, thresholds, quality flags, quality score, and review priority.

The canonical schema files are included under schemas/.

Required raw.parquet columns:

text

observation_id, timestamp, country_iso3, domain, indicator, value, unit,
source_provider, source_dataset, source_record_id, observation_status,
ingestion_version

Required labels.parquet columns:

text

label_id, observation_id, timestamp, country_iso3, domain, indicator,
annotation_level, label_type, label_value, confidence, evidence_id,
review_status, annotator, annotation_version, created_at

Annotation Semantics

ATIC separates source observations from interpretation.

Current seed packages include:

—annotation_level = 2: statistical labels such as year-over-year delta anomalies.
—annotation_level = 3: temporal state labels such as increasing, decreasing, and stable.
—review_status = proposed: automatically generated, not yet human-approved.

Confidence values are bounded from 0.0 to 1.0. They are scoring hints for review priority, not truth guarantees.

Loading Examples

Use huggingface_hub and pyarrow:

python

from huggingface_hub import hf_hub_download
import pyarrow.parquet as pq

repo_id = "africatic/africa-world-bank-health-population-time-series"
path = hf_hub_download(
    repo_id=repo_id,
    repo_type="dataset",
    filename="packages/somalia_sp_pop_80up_fe_5y_v0_1/raw.parquet",
)
raw = pq.read_table(path).to_pandas()
print(raw.head())

Query with DuckDB:

python

import duckdb
from huggingface_hub import hf_hub_download

labels_path = hf_hub_download(
    repo_id="africatic/africa-world-bank-health-population-time-series",
    repo_type="dataset",
    filename="packages/somalia_sp_pop_80up_fe_5y_v0_1/labels.parquet",
)

duckdb.sql("""
    select timestamp, label_type, label_value, confidence
    from read_parquet(?)
    where review_status = 'proposed'
    order by timestamp
""", params=[labels_path]).show()

Validation

After downloading or cloning this repository, validate a package with:

bash

python3 tools/validate_dataset.py packages/somalia_sp_pop_80up_fe_5y_v0_1

Validation checks:

—required package files
—metadata JSON Schema compatibility
—required Parquet columns
—broad Parquet type families
—reasoning JSONL schema
—quality report structure and parquet row-count agreement

Upstream Sources

Current upstream Electric Sheep Africa datasets:

—electricsheepafrica/africa-world-bank-health-indicators-for-eswatini
—electricsheepafrica/africa-world-bank-health-indicators-for-ethiopia
—electricsheepafrica/africa-world-bank-health-indicators-for-federal-republic-of-somalia
—electricsheepafrica/africa-world-bank-health-indicators-for-ghana
—electricsheepafrica/africa-world-bank-health-indicators-for-guinea
—electricsheepafrica/africa-world-bank-health-indicators-for-guinea-bissau
—electricsheepafrica/africa-world-bank-health-indicators-for-kenya
—electricsheepafrica/africa-world-bank-health-indicators-for-somalia
—electricsheepafrica/africa-world-bank-health-indicators-for-somalia-fed-rep
—electricsheepafrica/africa-world-bank-health-indicators-for-south-africa
—electricsheepafrica/africa-world-bank-health-indicators-for-zambia
—electricsheepafrica/africa-world-bank-health-indicators-for-zimbabwe

Country information is preserved from source file paths where upstream rows do not include explicit country columns.

Provenance

Every package records:

—upstream provider
—Hugging Face dataset ID
—source file path
—source revision SHA
—retrieval date
—generation script
—statistical method
—evidence IDs
—review status

This makes each annotation inspectable and reproducible.

Responsible Use

The seed labels in this repository are statistical proposals. They are useful for temporal retrieval, QA, prioritizing review, and building benchmark tasks. They should not be treated as expert-approved facts until their review_status changes to approved.