electricsheepafrica/africa-faostat-food-prices-for-south-africa

---
annotations_creators:
- no-annotation
language_creators:
- found
language:
- en
license: cc-by-4.0
multilinguality:
- monolingual
size_categories:
- n<1K
source_datasets:
- original
task_categories:
- tabular-regression
task_ids: []
tags:
- africa
- humanitarian
- hdx
- electric-sheep-africa
- food-security
- indicators
- zaf
pretty_name: "South Africa - Food Prices"
dataset_info:
splits:
- name: train
num_examples: 350
- name: test
num_examples: 87
---

# South Africa - Food Prices

**Publisher:** Food and Agriculture Organization (FAO) of the United Nations · **Source:** [HDX](https://data.humdata.org/dataset/faostat-food-prices-for-south-africa) · **License:** `cc-by-igo` · **Updated:** 2026-04-06

---

## Abstract

Food Prices for South Africa.

Contains data from the FAOSTAT [bulk data service](https://fenixservices.fao.org/faostat/static/bulkdownloads/datasets_E.json) covering the following categories: Consumer Price Indices, Deflators, Exchange rates, Producer Prices

Each row in this dataset represents country-level aggregates. Temporal coverage is indicated by the `startdate`, `enddate` column(s). Geographic scope: **ZAF**.

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

---

## Dataset Characteristics

| | |
|---|---|
| **Domain** | Food security and nutrition |
| **Unit of observation** | Country-level aggregates |
| **Rows (total)** | 438 |
| **Columns** | 17 (6 numeric, 9 categorical, 2 datetime) |
| **Train split** | 350 rows |
| **Test split** | 87 rows |
| **Geographic scope** | ZAF |
| **Publisher** | Food and Agriculture Organization (FAO) of the United Nations |
| **HDX last updated** | 2026-04-06 |

---

## Variables

**Geographic** — `iso3` (ZAF), `year_code` (range 1970.0–2024.0), `year` (range 1970.0–2024.0).

**Temporal** — `startdate`, `enddate`.

**Outcome / Measurement** — `value` (range 0.9896–189.8639).

**Identifier / Metadata** — `area_code` (range 202.0–202.0), `area_code_m49` ('710), `item_code` (range 22024.0–22028.0), `element_code` (range 6179.0–62250.0), `esa_source` (HDX) and 1 others.

**Other** — `area` (South Africa), `item` (GDP Deflator, Gross Fixed Capital Formation Deflator, Value Added Deflator (Agriculture, forestry and fishery)), `element` (Value Standard Local Currency, 2015 prices, Value US$, 2015 prices), `unit` (SLC, USD), `flag` (X, E).

---

## Quick Start

```python
from datasets import load_dataset

ds = load_dataset("electricsheepafrica/africa-faostat-food-prices-for-south-africa")
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% | ZAF |
| `startdate` | datetime64[ns] | 0.0% | |
| `enddate` | datetime64[ns] | 0.0% | |
| `area_code` | int64 | 0.0% | 202.0 – 202.0 (mean 202.0) |
| `area_code_m49` | object | 0.0% | '710 |
| `area` | object | 0.0% | South Africa |
| `item_code` | int64 | 0.0% | 22024.0 – 22028.0 (mean 22025.7397) |
| `item` | object | 0.0% | GDP Deflator, Gross Fixed Capital Formation Deflator, Value Added Deflator (Agriculture, forestry and fishery) |
| `element_code` | int64 | 0.0% | 6179.0 – 62250.0 (mean 34214.5) |
| `element` | object | 0.0% | Value Standard Local Currency, 2015 prices, Value US$, 2015 prices |
| `year_code` | int64 | 0.0% | 1970.0 – 2024.0 (mean 1996.8767) |
| `year` | int64 | 0.0% | 1970.0 – 2024.0 (mean 1996.8767) |
| `unit` | object | 0.0% | SLC, USD |
| `value` | float64 | 0.0% | 0.9896 – 189.8639 (mean 68.6127) |
| `flag` | object | 0.0% | X, E |
| `esa_source` | object | 0.0% | HDX |
| `esa_processed` | object | 0.0% | 2026-04-07 |

---

## Numeric Summary

| Column | Min | Max | Mean | Median |
|---|---|---|---|---|
| `area_code` | 202.0 | 202.0 | 202.0 | 202.0 |
| `item_code` | 22024.0 | 22028.0 | 22025.7397 | 22025.0 |
| `element_code` | 6179.0 | 62250.0 | 34214.5 | 34214.5 |
| `year_code` | 1970.0 | 2024.0 | 1996.8767 | 1997.0 |
| `year` | 1970.0 | 2024.0 | 1996.8767 | 1997.0 |
| `value` | 0.9896 | 189.8639 | 68.6127 | 72.9979 |

---

## 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 Food and Agriculture Organization (FAO) of the United Nations 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/faostat-food-prices-for-south-africa) for the publisher's own methodology notes and caveats.

---

## Citation

```bibtex
@dataset{hdx_africa_faostat_food_prices_for_south_africa,
title = {South Africa - Food Prices},
author = {Food and Agriculture Organization (FAO) of the United Nations},
year = {2026},
url = {https://data.humdata.org/dataset/faostat-food-prices-for-south-africa},
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 4.0
multilinguality:
- 单语言
size_categories:
- n<1K
source_datasets:
- 原创数据集
task_categories:
- tabular-regression
task_ids: []
tags:
- 非洲
- 人道主义
- HDX（Humanitarian Data Exchange）
- Electric Sheep Africa
- 粮食安全
- 指标
- ZAF
pretty_name: "南非——食品价格"
dataset_info:
splits:
- name: train
num_examples: 350
- name: test
num_examples: 87

# 南非——食品价格

**发布方：** 联合国粮食及农业组织（Food and Agriculture Organization of the United Nations, FAO） · **来源：** [HDX（Humanitarian Data Exchange）](https://data.humdata.org/dataset/faostat-food-prices-for-south-africa) · **许可协议：** `cc-by-igo` · **更新时间：** 2026-04-06

---

## 摘要

本数据集收录南非食品价格相关数据。
数据源自FAOSTAT [批量数据服务](https://fenixservices.fao.org/faostat/static/bulkdownloads/datasets_E.json)，涵盖以下类别：消费者价格指数、平减指数、汇率、生产者价格。
数据集中每一行代表国家级汇总统计值。时间覆盖范围由`startdate`（开始日期）、`enddate`（结束日期）列标注。地理覆盖范围：**ZAF（南非）**。
*本数据集已由[Electric Sheep Africa](https://huggingface.co/electricsheepafrica)整理为适用于机器学习的Parquet格式。*

---

## 数据集特征

| | |
|---|---|
| **研究领域** | 粮食安全与营养 |
| **观测单元** | 国家级汇总统计值 |
| **总样本行数** | 438 |
| **列数** | 17列（6个数值型、9个分类型、2个日期时间型） |
| **训练集拆分** | 350行 |
| **测试集拆分** | 87行 |
| **地理覆盖范围** | ZAF（南非） |
| **发布方** | 联合国粮食及农业组织（Food and Agriculture Organization of the United Nations, FAO） |
| **HDX最后更新时间** | 2026-04-06 |

---

## 变量

**地理类变量** — `iso3`（ZAF，国家代码）、`year_code`（取值范围1970.0–2024.0）、`year`（取值范围1970.0–2024.0）。
**时间类变量** — `startdate`（开始日期）、`enddate`（结束日期）。
**结果/测量变量** — `value`（取值范围0.9896–189.8639）。
**标识符/元数据变量** — `area_code`（取值范围202.0–202.0）、`area_code_m49`（'710）、`item_code`（取值范围22024.0–22028.0）、`element_code`（取值范围6179.0–62250.0）、`esa_source`（HDX）及其他1个变量。
**其他变量** — `area`（南非）、`item`（GDP平减指数、固定资本形成总额平减指数、农林渔业增加值平减指数）、`element`（标准本位币价值、2015年不变价、美元价值、2015年不变价）、`unit`（SLC、USD）、`flag`（X、E）。

---

## 快速上手

python
from datasets import load_dataset

ds = load_dataset("electricsheepafrica/africa-faostat-food-prices-for-south-africa")
train = ds["train"].to_pandas()
test = ds["test"].to_pandas()

print(train.shape)
train.head()

---

## 数据结构

| 列名 | 数据类型 | 空值占比 | 取值范围/示例值 |
|---|---|---|---|
| `iso3` | object | 0.0% | ZAF |
| `startdate` | datetime64[ns] | 0.0% | |
| `enddate` | datetime64[ns] | 0.0% | |
| `area_code` | int64 | 0.0% | 202.0 – 202.0（均值202.0） |
| `area_code_m49` | object | 0.0% | '710 |
| `area` | object | 0.0% | 南非 |
| `item_code` | int64 | 0.0% | 22024.0 – 22028.0（均值22025.7397） |
| `item` | object | 0.0% | GDP平减指数、固定资本形成总额平减指数、农林渔业增加值平减指数 |
| `element_code` | int64 | 0.0% | 6179.0 – 62250.0（均值34214.5） |
| `element` | object | 0.0% | 标准本位币价值、2015年不变价、美元价值、2015年不变价 |
| `year_code` | int64 | 0.0% | 1970.0 – 2024.0（均值1996.8767） |
| `year` | int64 | 0.0% | 1970.0 – 2024.0（均值1996.8767） |
| `unit` | object | 0.0% | SLC、USD |
| `value` | float64 | 0.0% | 0.9896 – 189.8639（均值68.6127） |
| `flag` | object | 0.0% | X、E |
| `esa_source` | object | 0.0% | HDX |
| `esa_processed` | object | 0.0% | 2026-04-07 |

---

## 数值型变量统计摘要

| 列名 | 最小值 | 最大值 | 均值 | 中位数 |
|---|---|---|---|---|
| `area_code` | 202.0 | 202.0 | 202.0 | 202.0 |
| `item_code` | 22024.0 | 22028.0 | 22025.7397 | 22025.0 |
| `element_code` | 6179.0 | 62250.0 | 34214.5 | 34214.5 |
| `year_code` | 1970.0 | 2024.0 | 1996.8767 | 1997.0 |
| `year` | 1970.0 | 2024.0 | 1996.8767 | 1997.0 |
| `value` | 0.9896 | 189.8639 | 68.6127 | 72.9979 |

---

## 数据整理流程

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

---

## 数据集局限性

- 数据源自联合国粮食及农业组织（Food and Agriculture Organization of the United Nations, FAO），未经过Electric Sheep Africa的独立验证。
- 自动化清洗无法修正原始数据收集中的错报值、定义不一致或抽样偏差问题。
- 请参阅[原始HDX数据集页面](https://data.humdata.org/dataset/faostat-food-prices-for-south-africa)查看发布方提供的方法说明与注意事项。

---

## 引用格式

bibtex
@dataset{hdx_africa_faostat_food_prices_for_south_africa,
title = {South Africa - Food Prices},
author = {Food and Agriculture Organization (FAO) of the United Nations},
year = {2026},
url = {https://data.humdata.org/dataset/faostat-food-prices-for-south-africa},
note = {Repackaged for machine learning by Electric Sheep Africa (https://huggingface.co/electricsheepafrica)}
}

---

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