electricsheepafrica/africa-climate-sudan

---
annotations_creators:
- no-annotation
language_creators:
- found
language:
- en
license: other
multilinguality:
- monolingual
size_categories:
- 10K<n<100K
source_datasets:
- original
task_categories:
- tabular-classification
- other
task_ids: []
tags:
- africa
- humanitarian
- hdx
- electric-sheep-africa
- baseline-population
- climate-weather
- conflict-violence
- displacement
- economics
- education
- food-security
- funding
- sdn
pretty_name: "HDX HAPI Data for Sudan"
dataset_info:
splits:
- name: train
num_examples: 14340
- name: test
num_examples: 3585
---

# HDX HAPI Data for Sudan

**Publisher:** HDX Humanitarian API Data · **Source:** [HDX](https://data.humdata.org/dataset/hdx-hapi-sdn) · **License:** `hdx-other` · **Updated:** 2026-02-18

---

## Abstract

This dataset contains data obtained from the
[HDX Humanitarian API](https://hapi.humdata.org/) (HDX HAPI),
which provides standardized humanitarian indicators designed
for seamless interoperability from multiple sources.
The data facilitates automated workflows and visualizations
to support humanitarian decision making.
For more information, please see the HDX HAPI
[landing page](https://data.humdata.org/hapi)
and
[documentation](https://hdx-hapi.readthedocs.io/en/latest/).

Each row in this dataset represents subnational administrative unit observations. Temporal coverage is indicated by the `reference_period_start`, `reference_period_end` column(s). Geographic scope: **SDN**.

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

---

## Dataset Characteristics

| | |
|---|---|
| **Domain** | Food security and nutrition |
| **Unit of observation** | Subnational administrative unit observations |
| **Rows (total)** | 17,925 |
| **Columns** | 18 (3 numeric, 11 categorical, 2 datetime) |
| **Train split** | 14,340 rows |
| **Test split** | 3,585 rows |
| **Geographic scope** | SDN |
| **Publisher** | HDX Humanitarian API Data |
| **HDX last updated** | 2026-02-18 |

---

## Variables

**Geographic** — `location_code` (SDN), `provider_admin1_name` (South Darfur, North Darfur, South Kordofan), `provider_admin2_name` (Ar Rahad, Melit, Ag Geneina), `admin1_code` (SD03, SD02, SD07), `admin1_name` (South Darfur, North Darfur, South Kordofan) and 5 others.

**Temporal** — `reference_period_start`, `reference_period_end`.

**Identifier / Metadata** — `esa_source` (HDX), `esa_processed`.

**Other** — `has_hrp`, `in_gho`, `operation` (Armed Clashes in Sudan, Armed Clashes in Sudan (Overview), Darfur conflict), `reporting_round` (range 0.0–70.0).

---

## Quick Start

```python
from datasets import load_dataset

ds = load_dataset("electricsheepafrica/africa-climate-sudan")
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% | SDN |
| `has_hrp` | bool | 0.0% | |
| `in_gho` | bool | 0.0% | |
| `provider_admin1_name` | object | 0.9% | South Darfur, North Darfur, South Kordofan |
| `provider_admin2_name` | object | 11.3% | Ar Rahad, Melit, Ag Geneina |
| `admin1_code` | object | 0.9% | SD03, SD02, SD07 |
| `admin1_name` | object | 0.9% | South Darfur, North Darfur, South Kordofan |
| `admin2_code` | object | 11.3% | SD02129, SD02128, SD04115 |
| `admin2_name` | object | 11.3% | Ar Rahad, Melit, Ag Geneina |
| `admin_level` | int64 | 0.0% | 0.0 – 2.0 (mean 1.8786) |
| `operation` | object | 0.0% | Armed Clashes in Sudan, Armed Clashes in Sudan (Overview), Darfur conflict |
| `assessment_type` | object | 0.0% | BA, SA |
| `population` | int64 | 0.0% | 20.0 – 11585384.0 (mean 107776.2169) |
| `reporting_round` | int64 | 0.0% | 0.0 – 70.0 (mean 22.0722) |
| `reference_period_start` | datetime64[ns] | 0.0% | |
| `reference_period_end` | datetime64[ns] | 0.0% | |
| `esa_source` | object | 0.0% | HDX |
| `esa_processed` | object | 0.0% | |

---

## Numeric Summary

| Column | Min | Max | Mean | Median |
|---|---|---|---|---|
| `admin_level` | 0.0 | 2.0 | 1.8786 | 2.0 |
| `population` | 20.0 | 11585384.0 | 107776.2169 | 25401.0 |
| `reporting_round` | 0.0 | 70.0 | 22.0722 | 20.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) 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 HDX Humanitarian API Data 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/hdx-hapi-sdn) for the publisher's own methodology notes and caveats.

---

## Citation

```bibtex
@dataset{hdx_africa_climate_sudan,
title = {HDX HAPI Data for Sudan},
author = {HDX Humanitarian API Data},
year = {2026},
url = {https://data.humdata.org/dataset/hdx-hapi-sdn},
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.*

### 数据集元数据
- 注释创建者：无注释（no-annotation）
- 语言生成方式：公开语料爬取（found）
- 语言：英语（en）
- 许可证：其他（other）
- 多语言属性：单语言（monolingual）
- 数据规模：样本量介于10000至100000之间
- 源数据集类型：原创数据集（original）
- 任务类别：表格分类任务（tabular-classification）、其他（other）
- 任务子类别：无
- 标签：非洲、人道主义、HDX、electric-sheep-africa、基线人口（baseline-population）、气候-天气、冲突-暴力、流离失所、经济学、教育、粮食安全、资助、SDN
- 友好展示名称：苏丹HDX HAPI数据集

---

# 苏丹HDX HAPI数据集

**发布方**：HDX人道主义API数据集 · **来源**：[HDX（Humanitarian Data Exchange，人道主义数据交换平台）](https://data.humdata.org/dataset/hdx-hapi-sdn) · **许可证**：`hdx-other` · **更新时间**：2026-02-18

---

## 摘要
本数据集收录自[HDX人道主义API（HDX HAPI）](https://hapi.humdata.org/)的数据，该接口提供标准化的人道主义指标，旨在实现多源数据的无缝互操作。本数据集可助力自动化工作流与可视化流程，以支撑人道主义决策制定。如需了解更多信息，请访问HDX HAPI的[落地页](https://data.humdata.org/hapi)与[官方文档](https://hdx-hapi.readthedocs.io/en/latest/)。

本数据集的每一行代表次国家级行政单元的观测数据。时间覆盖范围由`reference_period_start`、`reference_period_end`字段标识。地理范围：**SDN（苏丹）**。本数据集已由[Electric Sheep Africa](https://huggingface.co/electricsheepafrica)整理为适用于机器学习的Parquet格式（Parquet）。

---

## 数据集特征
| 项 | 详情 |
|---|---|
| **研究领域** | 粮食安全与营养 |
| **观测单元** | 次国家级行政单元观测数据 |
| **总数据行数** | 17925 |
| **字段总数** | 18个（3个数值型、11个分类型、2个日期时间型） |
| **训练集样本量** | 14340条 |
| **测试集样本量** | 3585条 |
| **地理覆盖范围** | SDN（苏丹） |
| **发布方** | HDX人道主义API数据集 |
| **HDX最后更新时间** | 2026-02-18 |

---

## 变量说明
**地理类变量** — `location_code`（SDN）、`provider_admin1_name`（南达尔富尔州、北达尔富尔州、南科尔多凡州）、`provider_admin2_name`（阿拉哈德、梅利特、阿贾杰奈纳）、`admin1_code`（SD03、SD02、SD07）、`admin1_name`（南达尔富尔州、北达尔富尔州、南科尔多凡州）及另外5个字段。
**时间类变量** — `reference_period_start`、`reference_period_end`。
**标识符/元数据类变量** — `esa_source`（HDX）、`esa_processed`。
**其他变量** — `has_hrp`、`in_gho`、`operation`（苏丹武装冲突、苏丹武装冲突（概览）、达尔富尔冲突）、`reporting_round`（取值范围0.0–70.0）。

---

## 快速上手示例
python
from datasets import load_dataset

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

print(train.shape)
train.head()

---

## 数据Schema
| 字段名 | 数据类型 | 空值占比 | 取值范围/示例值 |
|---|---|---|---|
| `location_code` | 字符串（object） | 0.0% | SDN |
| `has_hrp` | 布尔型（bool） | 0.0% | 无 |
| `in_gho` | 布尔型（bool） | 0.0% | 无 |
| `provider_admin1_name` | 字符串（object） | 0.9% | 南达尔富尔州、北达尔富尔州、南科尔多凡州 |
| `provider_admin2_name` | 字符串（object） | 11.3% | 阿拉哈德、梅利特、阿贾杰奈纳 |
| `admin1_code` | 字符串（object） | 0.9% | SD03、SD02、SD07 |
| `admin1_name` | 字符串（object） | 0.9% | 南达尔富尔州、北达尔富尔州、南科尔多凡州 |
| `admin2_code` | 字符串（object） | 11.3% | SD02129、SD02128、SD04115 |
| `admin2_name` | 字符串（object） | 11.3% | 阿拉哈德、梅利特、阿贾杰奈纳 |
| `admin_level` | 64位整型（int64） | 0.0% | 0.0 – 2.0（均值1.8786） |
| `operation` | 字符串（object） | 0.0% | 苏丹武装冲突、苏丹武装冲突（概览）、达尔富尔冲突 |
| `assessment_type` | 字符串（object） | 0.0% | BA、SA |
| `population` | 64位整型（int64） | 0.0% | 20.0 – 11585384.0（均值107776.2169） |
| `reporting_round` | 64位整型（int64） | 0.0% | 0.0 – 70.0（均值22.0722） |
| `reference_period_start` | 日期时间型（datetime64[ns]） | 0.0% | 无 |
| `reference_period_end` | 日期时间型（datetime64[ns]） | 0.0% | 无 |
| `esa_source` | 字符串（object） | 0.0% | HDX |
| `esa_processed` | 字符串（object） | 0.0% | 无 |

---

## 数值型变量统计摘要
| 字段名 | 最小值 | 最大值 | 均值 | 中位数 |
|---|---|---|---|---|
| `admin_level` | 0.0 | 2.0 | 1.8786 | 2.0 |
| `population` | 20.0 | 11585384.0 | 107776.2169 | 25401.0 |
| `reporting_round` | 0.0 | 70.0 | 22.0722 | 20.0 |

---

## 数据集整理流程
原始数据通过CKAN API从HDX下载，并转换为Parquet格式。字段名统一转为小写并标准化为蛇形命名法（snake_case）。常见缺失值标记（`N/A`、`null`、`none`、`-`、`unknown`、`no data`、`#N/A`）被统一替换为`NaN`。基于解析成功率（阈值>85%），将2个字段从字符串类型转换为数值型或日期时间型。本数据集以固定随机种子（42）按照80/20的比例划分为训练集与测试集，并以Snappy压缩格式保存为Parquet文件。

---

## 数据集局限性
- 本数据源自HDX人道主义API数据集，未经过Electric Sheep Africa（ESA）的独立验证。
- 自动化清洗流程无法修正原始数据收集中的错报值、定义不一致或抽样偏差问题。
- 如需了解发布方的方法论说明与免责声明，请参阅[原始HDX数据集页面](https://data.humdata.org/dataset/hdx-hapi-sdn)。

---

## 引用格式
bibtex
@dataset{hdx_africa_climate_sudan,
title = {HDX HAPI Data for Sudan},
author = {HDX Humanitarian API Data},
year = {2026},
url = {https://data.humdata.org/dataset/hdx-hapi-sdn},
note = {Repackaged for machine learning by Electric Sheep Africa (https://huggingface.co/electricsheepafrica)}
}

---

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