electricsheepafrica/africa-demographics-lesotho

---
annotations_creators:
- no-annotation
language_creators:
- found
language:
- en
license: other
multilinguality:
- monolingual
size_categories:
- 1K<n<10K
source_datasets:
- original
task_categories:
- tabular-classification
- other
task_ids: []
tags:
- africa
- humanitarian
- hdx
- electric-sheep-africa
- demographics
- health
- lso
pretty_name: "Lesotho - Subnational Demographic and Health Data"
dataset_info:
splits:
- name: train
num_examples: 804
- name: test
num_examples: 201
---

# Lesotho - Subnational Demographic and Health Data

**Publisher:** The DHS Program · **Source:** [HDX](https://data.humdata.org/dataset/dhs-subnational-data-for-lesotho) · **License:** `hdx-other` · **Updated:** 2026-02-24

---

## Abstract

Contains data from the [DHS data portal](https://api.dhsprogram.com/). There is also a dataset containing [Lesotho - National Demographic and Health Data](https://data.humdata.org/dataset/dhs-data-for-lesotho) on HDX.

The DHS Program Application Programming Interface (API) provides software developers access to aggregated indicator data from The Demographic and Health Surveys (DHS) Program. The API can be used to create various applications to help analyze, visualize, explore and disseminate data on population, health, HIV, and nutrition from more than 90 countries.

Each row in this dataset represents first-level administrative unit observations. Data was last updated on HDX on 2026-02-24. Geographic scope: **LSO**.

*Curated into ML-ready Parquet format by [Electric Sheep Africa](https://huggingface.co/electricsheepafrica).*

---

## Dataset Characteristics

| | |
|---|---|
| **Domain** | Public health |
| **Unit of observation** | First-level administrative unit observations |
| **Rows (total)** | 1,006 |
| **Columns** | 30 (14 numeric, 16 categorical, 0 datetime) |
| **Train split** | 804 rows |
| **Test split** | 201 rows |
| **Geographic scope** | LSO |
| **Publisher** | The DHS Program |
| **HDX last updated** | 2026-02-24 |

---

## Variables

**Geographic** — `iso3` (LSO), `location` (Berea, Maseru, Mohale's Hoek), `dhs_countrycode` (LS), `countryname` (Lesotho), `surveyyear` (range 2004.0–2023.0) and 8 others.

**Outcome / Measurement** — `value` (range 0.0–139.0), `istotal` (range 0.0–0.0).

**Identifier / Metadata** — `dataid` (range 106169.0–7981358.0), `indicatorid` (RH_DELP_C_DHF, CH_DIAT_C_ORT, FE_FRTR_W_TFR), `characteristicid` (range 423001.0–423010.0), `characteristiclabel` (Berea, Maseru, Mohale's Hoek), `ispreferred` (range 0.0–1.0) and 3 others.

**Other** — `indicator` (Place of delivery: Health facility, Treatment of diarrhea: Either ORS or RHF, Total fertility rate 15-49), `precision` (range 0.0–1.0), `indicatororder` (range 11763080.0–260321010.0), `characteristicorder` (range 1423001.0–1423010.0), `denominatorweighted` (range 8.0–3077.0) and 2 others.

---

## Quick Start

```python
from datasets import load_dataset

ds = load_dataset("electricsheepafrica/africa-demographics-lesotho")
train = ds["train"].to_pandas()
test = ds["test"].to_pandas()

print(train.shape)
train.head()
```

---

## Schema

| Column | Type | Null % | Range / Sample Values |
|---|---|---|---|
| `iso3` | object | 0.0% | LSO |
| `location` | object | 0.0% | Berea, Maseru, Mohale's Hoek |
| `dataid` | int64 | 0.0% | 106169.0 – 7981358.0 (mean 4127056.3877) |
| `indicator` | object | 0.0% | Place of delivery: Health facility, Treatment of diarrhea: Either ORS or RHF, Total fertility rate 15-49 |
| `value` | float64 | 0.0% | 0.0 – 139.0 (mean 43.4174) |
| `precision` | int64 | 0.0% | 0.0 – 1.0 (mean 0.9205) |
| `dhs_countrycode` | object | 0.0% | LS |
| `countryname` | object | 0.0% | Lesotho |
| `surveyyear` | int64 | 0.0% | 2004.0 – 2023.0 (mean 2012.5795) |
| `surveyid` | object | 0.0% | LS2014DHS, LS2009DHS, LS2023DHS |
| `indicatorid` | object | 0.0% | RH_DELP_C_DHF, CH_DIAT_C_ORT, FE_FRTR_W_TFR |
| `indicatororder` | int64 | 0.0% | 11763080.0 – 260321010.0 (mean 101197284.2346) |
| `indicatortype` | object | 0.0% | I |
| `characteristicid` | int64 | 0.0% | 423001.0 – 423010.0 (mean 423005.4881) |
| `characteristicorder` | int64 | 0.0% | 1423001.0 – 1423010.0 (mean 1423005.4881) |
| `characteristiccategory` | object | 0.0% | Region |
| `characteristiclabel` | object | 0.0% | Berea, Maseru, Mohale's Hoek |
| `byvariableid` | int64 | 0.0% | 0.0 – 631002.0 (mean 16107.7694) |
| `byvariablelabel` | object | 72.6% | |
| `istotal` | int64 | 0.0% | 0.0 – 0.0 (mean 0.0) |
| `ispreferred` | int64 | 0.0% | 0.0 – 1.0 (mean 0.8907) |
| `sdrid` | object | 0.0% | |
| `regionid` | object | 0.0% | |
| `surveyyearlabel` | float64 | 24.8% | 2004.0 – 2014.0 (mean 2009.1519) |
| `surveytype` | object | 0.0% | |
| `denominatorweighted` | float64 | 23.9% | 8.0 – 3077.0 (mean 343.0574) |
| `denominatorunweighted` | float64 | 23.9% | 26.0 – 1427.0 (mean 346.0339) |
| `levelrank` | int64 | 0.0% | 1.0 – 1.0 (mean 1.0) |
| `esa_source` | object | 0.0% | |
| `esa_processed` | object | 0.0% | |

---

## Numeric Summary

| Column | Min | Max | Mean | Median |
|---|---|---|---|---|
| `dataid` | 106169.0 | 7981358.0 | 4127056.3877 | 4229160.0 |
| `value` | 0.0 | 139.0 | 43.4174 | 40.1 |
| `precision` | 0.0 | 1.0 | 0.9205 | 1.0 |
| `surveyyear` | 2004.0 | 2023.0 | 2012.5795 | 2014.0 |
| `indicatororder` | 11763080.0 | 260321010.0 | 101197284.2346 | 93906230.0 |
| `characteristicid` | 423001.0 | 423010.0 | 423005.4881 | 423005.0 |
| `characteristicorder` | 1423001.0 | 1423010.0 | 1423005.4881 | 1423005.0 |
| `byvariableid` | 0.0 | 631002.0 | 16107.7694 | 0.0 |
| `istotal` | 0.0 | 0.0 | 0.0 | 0.0 |
| `ispreferred` | 0.0 | 1.0 | 0.8907 | 1.0 |
| `surveyyearlabel` | 2004.0 | 2014.0 | 2009.1519 | 2009.0 |
| `denominatorweighted` | 8.0 | 3077.0 | 343.0574 | 217.5 |
| `denominatorunweighted` | 26.0 | 1427.0 | 346.0339 | 278.0 |
| `levelrank` | 1.0 | 1.0 | 1.0 | 1.0 |

---

## Curation

Raw data was downloaded from HDX via the CKAN API and converted to Parquet. Column names were lowercased and standardised to snake_case. Common missing-value markers (`N/A`, `null`, `none`, `-`, `unknown`, `no data`, `#N/A`) were unified to `NaN`. 2 column(s) with >80% missing values were removed: `cilow`, `cihigh`. 1 column(s) were cast from string to numeric or datetime based on parse-success rate (>85% threshold). The dataset was split 80/20 into train and test partitions using a fixed random seed (42) and saved as Snappy-compressed Parquet.

---

## Limitations

- Data originates from The DHS Program and has not been independently validated by ESA.
- Automated cleaning cannot correct for misreported values, definitional inconsistencies, or sampling bias in the original collection.
- The following columns have >20% missing values and should be treated with caution in modelling: `byvariablelabel`, `surveyyearlabel`, `denominatorweighted`, `denominatorunweighted`.
- Refer to the [original HDX dataset page](https://data.humdata.org/dataset/dhs-subnational-data-for-lesotho) for the publisher's own methodology notes and caveats.

---

## Citation

```bibtex
@dataset{hdx_africa_demographics_lesotho,
title = {Lesotho - Subnational Demographic and Health Data},
author = {The DHS Program},
year = {2026},
url = {https://data.humdata.org/dataset/dhs-subnational-data-for-lesotho},
note = {Repackaged for machine learning by Electric Sheep Africa (https://huggingface.co/electricsheepafrica)}
}
```

---

*[Electric Sheep Africa](https://huggingface.co/electricsheepafrica) — Africa's ML dataset infrastructure. Lagos, Nigeria.*