electricsheepafrica/africa-uganda-languages

---
annotations_creators:
- no-annotation
language_creators:
- found
language:
- en
license: cc-by-sa-4.0
multilinguality:
- monolingual
size_categories:
- n<1K
source_datasets:
- original
task_categories:
- other
task_ids: []
tags:
- africa
- humanitarian
- hdx
- electric-sheep-africa
- languages
- uga
pretty_name: "Uganda: Languages"
dataset_info:
splits:
- name: train
num_examples: 20
- name: test
num_examples: 5
---

# Uganda: Languages

**Publisher:** CLEAR Global (previously Translators without Borders) · **Source:** [HDX](https://data.humdata.org/dataset/uganda-languages) · **License:** `cc-by-sa` · **Updated:** 2026-04-06

---

## Abstract

Data on languages spoken in Uganda, showing the main language spoken in the household by proportion of the population. Data is drawn from AfroBarometer. For more resources on the languages of Uganda and language use in humanitarian contexts please visit: https://clearglobal.org/language-maps-and-data/

Each row in this dataset represents time-series observations. Temporal coverage is indicated by the `datetime_published`, `date_creation` column(s). Geographic scope: **UGA**.

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

---

## Dataset Characteristics

| | |
|---|---|
| **Domain** | Demographics and population |
| **Unit of observation** | Time-series observations |
| **Rows (total)** | 25 |
| **Columns** | 16 (4 numeric, 10 categorical, 2 datetime) |
| **Train split** | 20 rows |
| **Test split** | 5 rows |
| **Geographic scope** | UGA |
| **Publisher** | CLEAR Global (previously Translators without Borders) |
| **HDX last updated** | 2026-04-06 |

---

## Variables

**Geographic** — `location_code` (UGA), `location_name` (Uganda), `location_level` (range 0.0–0.0), `reliability_score` (range 0.6965–0.6965), `representivity_rating` (moderate).

**Temporal** — `datetime_published`, `date_creation`.

**Demographic** — `language_code` (saam1283, stan1293, acol1236), `language_name` (Saamia, English, Acoli), `language_rank` (range 1.0–25.0).

**Outcome / Measurement** — `proportion_value` (range 0.0005–0.2516).

**Identifier / Metadata** — `dataset_name` (Uganda Round 9 data (2022)), `source` (AfroBarometer), `esa_source` (HDX), `esa_processed` (2026-04-07).

**Other** — `url` (https://www.afrobarometer.org/wp-content/uploads/2024/03/UGA_R9.data_.final_.wtd_release.19Jun22_Updated.7Nov23.sav).

---

## Quick Start

```python
from datasets import load_dataset

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

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

---

## Schema

| Column | Type | Null % | Range / Sample Values |
|---|---|---|---|
| `location_code` | object | 0.0% | UGA |
| `location_name` | object | 0.0% | Uganda |
| `location_level` | int64 | 0.0% | 0.0 – 0.0 (mean 0.0) |
| `language_code` | object | 0.0% | saam1283, stan1293, acol1236 |
| `language_name` | object | 0.0% | Saamia, English, Acoli |
| `language_rank` | int64 | 0.0% | 1.0 – 25.0 (mean 13.0) |
| `proportion_value` | float64 | 0.0% | 0.0005 – 0.2516 (mean 0.04) |
| `reliability_score` | float64 | 0.0% | 0.6965 – 0.6965 (mean 0.6965) |
| `dataset_name` | object | 0.0% | Uganda Round 9 data (2022) |
| `url` | object | 0.0% | https://www.afrobarometer.org/wp-content/uploads/2024/03/UGA_R9.data_.final_.wtd_release.19Jun22_Updated.7Nov23.sav |
| `source` | object | 0.0% | AfroBarometer |
| `datetime_published` | datetime64[ns] | 0.0% | |
| `date_creation` | datetime64[ns] | 0.0% | |
| `representivity_rating` | object | 0.0% | moderate |
| `esa_source` | object | 0.0% | HDX |
| `esa_processed` | object | 0.0% | 2026-04-07 |

---

## Numeric Summary

| Column | Min | Max | Mean | Median |
|---|---|---|---|---|
| `location_level` | 0.0 | 0.0 | 0.0 | 0.0 |
| `language_rank` | 1.0 | 25.0 | 13.0 | 13.0 |
| `proportion_value` | 0.0005 | 0.2516 | 0.04 | 0.0234 |
| `reliability_score` | 0.6965 | 0.6965 | 0.6965 | 0.6965 |

---

## 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) 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 CLEAR Global (previously Translators without Borders) and has not been independently validated by ESA.
- Automated cleaning cannot correct for misreported values, definitional inconsistencies, or sampling bias in the original collection.
- Refer to the [original HDX dataset page](https://data.humdata.org/dataset/uganda-languages) for the publisher's own methodology notes and caveats.

---

## Citation

```bibtex
@dataset{hdx_africa_uganda_languages,
title = {Uganda: Languages},
author = {CLEAR Global (previously Translators without Borders)},
year = {2026},
url = {https://data.humdata.org/dataset/uganda-languages},
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.*

annotations_creators:
- 无注释
language_creators:
- 爬取获取
language:
- 英语
license: CC BY-SA 4.0
multilinguality:
- 单语
size_categories:
- 样本量少于1000条
source_datasets:
- 原创数据集
task_categories:
- 其他
task_ids: []
tags:
- 非洲
- 人道主义
- HDX（Humanitarian Data Exchange）
- Electric Sheep Africa
- 语言
- UGA（乌干达国家代码）
pretty_name: "乌干达：语言数据集"
dataset_info:
splits:
- name: train
num_examples: 20
- name: test
num_examples: 5

---

# 乌干达：语言数据集

**发布方**：CLEAR Global（前身为Translators without Borders）· **数据来源**：[HDX（Humanitarian Data Exchange）](https://data.humdata.org/dataset/uganda-languages) · **授权协议**：`cc-by-sa` · **更新时间**：2026年4月6日

---

## 摘要

本数据集包含乌干达境内使用语言的相关数据，展示了按人口占比统计的各家庭主要使用语言情况。数据源自AfroBarometer。如需获取更多乌干达语言及人道主义场景下语言使用的相关资源，请访问：https://clearglobal.org/language-maps-and-data/

本数据集的每一行均代表时序观测数据。时间覆盖范围由`datetime_published`（发布时间）和`date_creation`（创建时间）列标注。地理覆盖范围：**UGA（乌干达国家代码）**。

*本数据集已由[Electric Sheep Africa](https://huggingface.co/electricsheepafrica)整理为适配机器学习的Parquet（Parquet）格式。*

---

## 数据集特征

| 特征项 | 详情 |
|---|---|
| **研究领域** | 人口与人口统计学 |
| **观测单元** | 时序观测数据 |
| **总行数** | 25条 |
| **列数** | 16列（4列数值型、10列分类型、2列日期时间型） |
| **训练集划分** | 20条数据 |
| **测试集划分** | 5条数据 |
| **地理覆盖范围** | UGA（乌干达） |
| **发布方** | CLEAR Global（前身为Translators without Borders） |
| **HDX最后更新时间** | 2026年4月6日 |

---

## 变量说明

**地理类变量**：`location_code`（国家代码，值为UGA）、`location_name`（国家名称，值为乌干达）、`location_level`（取值范围0.0–0.0）、`reliability_score`（可信度评分，取值范围0.6965–0.6965）、`representivity_rating`（代表性评级，值为中等）。

**时间类变量**：`datetime_published`、`date_creation`。

**人口统计学类变量**：`language_code`（语言代码，可选值为saam1283、stan1293、acol1236）、`language_name`（语言名称，可选值为Saamia、英语、阿科利语）、`language_rank`（语言排名，取值范围1.0–25.0）。

**结果/测量类变量**：`proportion_value`（人口占比，取值范围0.0005–0.2516）。

**标识符/元数据类变量**：`dataset_name`（数据集名称，值为乌干达第9轮调研数据（2022年））、`source`（数据来源，值为AfroBarometer）、`esa_source`（ESA数据源，值为HDX）、`esa_processed`（ESA处理时间，值为2026-04-07）。

**其他变量**：`url`（原始数据链接，https://www.afrobarometer.org/wp-content/uploads/2024/03/UGA_R9.data_.final_.wtd_release.19Jun22_Updated.7Nov23.sav）。

---

## 快速上手

python
from datasets import load_dataset

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

print(train.shape)
train.head()

---

## 数据结构

| 列名 | 数据类型 | 空值占比 | 取值范围/示例值 |
|---|---|---|---|
| `location_code` | 字符串型 | 0.0% | UGA |
| `location_name` | 字符串型 | 0.0% | 乌干达 |
| `location_level` | 整型 | 0.0% | 0.0 – 0.0（均值0.0） |
| `language_code` | 字符串型 | 0.0% | saam1283、stan1293、acol1236 |
| `language_name` | 字符串型 | 0.0% | Saamia、英语、阿科利语 |
| `language_rank` | 整型 | 0.0% | 1.0 – 25.0（均值13.0） |
| `proportion_value` | 浮点型 | 0.0% | 0.0005 – 0.2516（均值0.04） |
| `reliability_score` | 浮点型 | 0.0% | 0.6965 – 0.6965（均值0.6965） |
| `dataset_name` | 字符串型 | 0.0% | 乌干达第9轮调研数据（2022年） |
| `url` | 字符串型 | 0.0% | https://www.afrobarometer.org/wp-content/uploads/2024/03/UGA_R9.data_.final_.wtd_release.19Jun22_Updated.7Nov23.sav |
| `source` | 字符串型 | 0.0% | AfroBarometer |
| `datetime_published` | datetime64[ns] | 0.0% | 无 |
| `date_creation` | datetime64[ns] | 0.0% | 无 |
| `representivity_rating` | 字符串型 | 0.0% | 中等 |
| `esa_source` | 字符串型 | 0.0% | HDX |
| `esa_processed` | 字符串型 | 0.0% | 2026-04-07 |

---

## 数值型变量统计摘要

| 列名 | 最小值 | 最大值 | 均值 | 中位数 |
|---|---|---|---|---|
| `location_level` | 0.0 | 0.0 | 0.0 | 0.0 |
| `language_rank` | 1.0 | 25.0 | 13.0 | 13.0 |
| `proportion_value` | 0.0005 | 0.2516 | 0.04 | 0.0234 |
| `reliability_score` | 0.6965 | 0.6965 | 0.6965 | 0.6965 |

---

## 数据整理流程

原始数据通过CKAN API从HDX下载，并转换为Parquet（Parquet）格式。所有列名均转为小写，并标准化为蛇形命名法（snake_case）。将常见的缺失值标记（`N/A`、`null`、`none`、`-`、`unknown`、`no data`、`#N/A`）统一替换为`NaN`（非数值缺失值标记）。根据解析成功率（阈值为85%以上），将2列从字符串类型转换为数值型或日期时间型。本数据集以80/20的比例划分为训练集与测试集，使用固定随机种子（random seed，42）进行划分，并以Snappy（Snappy）压缩的Parquet格式存储。

---

## 数据集局限性

- 本数据集源自CLEAR Global（前身为Translators without Borders），未经过Electric Sheep Africa的独立验证。
- 自动化数据清洗无法修正原始数据收集中的错报值、定义不一致或抽样偏差问题。
- 如需了解发布方的方法论说明与注意事项，请参阅[HDX原始数据集页面](https://data.humdata.org/dataset/uganda-languages)。

---

## 引用格式

bibtex
@dataset{hdx_africa_uganda_languages,
title = {Uganda: Languages},
author = {CLEAR Global (previously Translators without Borders)},
year = {2026},
url = {https://data.humdata.org/dataset/uganda-languages},
note = {Repackaged for machine learning by Electric Sheep Africa (https://huggingface.co/electricsheepafrica)}
}

---

*[Electric Sheep Africa](https://huggingface.co/electricsheepafrica) — 非洲机器学习数据集基础设施。尼日利亚拉各斯。*