HarvestStat Africa v1.2
Harmonized subnational crop statistics for 33 Sub-Saharan African countries.
This is the current recommended version.
Archived version of record (citable):
https://doi.org/10.5061/dryad.vq83bk42w
The assets attached to this release are byte-identical to the Dryad v1.2 deposit.
The same files are tracked in
public/,
which holds only the latest stable release; earlier versions are available via
tags and
releases.
On v1.1 — v1.1 (2026-01-09) was an internal consistency release and was never
published to GitHub Releases or Dryad. Its changes are folded into v1.2 and
documented in the
CHANGELOG.
Summary of changes since v1.0
- Rows: 203,125 → 217,487 | net +14,362
(36,800 added · 22,438 removed · 2,939 revised by >5%) - Admin units: 1,109 → 1,128 | net +19
- Countries affected (13): Angola, Benin, Burkina Faso, Ethiopia, Kenya,
Lesotho, Malawi, Mozambique, Somalia, South Africa, South Sudan, Sudan, Zambia
Breaking changes — read before updating
Ethiopia FNIDs re-keyed. The 2014 delineation (ET2014A…) is replaced by the
2021 delineation (ET2021R…): 77 units removed, 96 added. The regions are the same
but subdivided more finely — Sidama is split out from SNNPR, several Oromia and
SNNPR zones are disaggregated, and zone names are updated throughout
(e.g. Bench Maji → Bench Sheko, Gamo Gofa → Gamo / Gofa, Argoba →
Argoba Special Woreda). Both the crop statistics and boundary files use the 2021
keys in v1.2. Code joining on Ethiopia FNIDs from v1.0 will silently drop rows.
Country names standardized to ISO 3166-1 short names.
DRC → Congo, The Democratic Republic of the;
Tanzania → Tanzania, United Republic of. FNIDs and admin names are unchanged.
Somalia fully re-ingested. Prior rows are replaced across all affected crops.
Pepper is superseded by Chili Pepper, and the harvest-year encoding is corrected.
Coverage now extends to 2026 (Deyr planted October 2024, harvested March 2026);
treat years beyond 2024 as potentially incomplete seasons.
Series removed without replacement.
Ethiopia: Avocado, Lemon, Mango, Orange, Papaya, Pineapple.
Mozambique: Ginger, Jute, Macadamia, Tea, plus scattered years lost across
2002–2022 — Mozambique has removals only, with no additions.
Notable additions
- Kenya 2006–2011 subnational annual record recovered (+1,275 rows, no removals).
The gap arose from data tied to theKE2007A2/KE2009A2delineations, now
linked and harmonized onto the 47-unitKE2013A1structure, consistent with the
source data (#94,
#96). - Zambia backfilled to 1990 for most crops; Maize extends to 1980, the earliest
coverage in the dataset. New series include Bambara groundnut, Pineapple,
Sugarcane, and Velvet Bean. - Ethiopia rebuilt across 1993–2022 under a revised production-system
classification, spanning cereals, pulses, oilseeds, cash crops, and vegetables. - South Africa extended to 2023–2025, plus a new Oats series (2013–2025).
Shared rows show systematic yield corrections of 6–25% for Maize, Soybean, and
Wheat. - Benin extended to 2023, with new Chili Pepper, Cotton, and Tobacco series and
new Cashew and Coffee crops. - Angola adds horticultural crops (2015–2017) and staples (2007–2017).
- Burkina Faso extended back to 1984 for all major crops.
- Lesotho (2023–2024), Malawi (Maize 2024), and South Sudan (Cereal
Crops aggregate, 2013–2022) receive smaller updates. - Shapefile distribution of the boundary file is included for the first time
(introduced in the unpublished v1.1).
Changes that are not corrections
Burkina Faso's very large percentage changes for 1984–2000 are artifacts of a
production-system reclassification, not revisions to the underlying statistics.
Sudan's ~5% changes for 1975–2010 are within rounding tolerance and are not
material corrections.
Country-by-country detail:
CHANGELOG.md
Contents
| File | Description |
|---|---|
hvstat_africa_data_v1.2.csv |
Harmonized subnational crop statistics |
hvstat_africa_boundary_v1.2.gpkg |
FEWS NET-aligned administrative boundaries, joined via fnid |
hvstat_africa_boundary_v1.2_shp.zip |
Same boundaries as ESRI Shapefile (.shp, .shx, .dbf, .prj, .cpg) |
fdw_raw_data_v1.2.zip |
Raw FEWS NET Data Warehouse (FDW) extracts for 33 countries |
Readme.md |
Dataset documentation and column definitions |
Crop statistics — column definitions
| Column | Description |
|---|---|
fnid |
FEWS NET unique geographic unit identifier |
country |
Country name (ISO 3166-1 short name) |
country_code |
ISO 3166-1 alpha-2 country code |
admin_1 |
First-level administrative unit name |
admin_2 |
Second-level administrative unit name (if applicable) |
product |
Crop product name |
season_name |
Growing season name |
planting_year / planting_month |
Start of planting |
harvest_year / harvest_month |
End of harvest |
crop_production_system |
Production system (e.g. irrigated, rainfed) |
qc_flag |
Quality control flag (0 = none, 1 = outlier, 2 = low variance) |
area |
Cropped area (ha) |
production |
Production volume (mt) |
yield |
Yield (mt/ha) |
The boundary files carry fnid, country, country_code, admin_1, admin_2,
and geometry. The Shapefile distribution truncates country_code to
country_co under the 10-character DBF field-name limit; the GeoPackage uses the
full name.
Raw FDW files are named by ISO 3166-1 alpha-2 code (adm_crop_data_raw_{CC}.csv);
SDSS covers Sudan and South Sudan jointly.
Source data note
HarvestStat Africa is a derived, harmonized product built from multiple original
source documents and data products. It is not a direct redistribution of the
original source files or database records. Original sources are listed in Table S1
of the paper's Supplementary Information.
Citation
Lee, D., Anderson, W., Chen, X., Davenport, F., Shukla, S., Sahajpal, R., Budde, M.,
Rowland, J., Verdin, J., You, L., Ahouangbenon, M., Davis, K. F., Kebede, E.,
Ehrmann, S., Justice, C., & Meyer, C. (2025).
HarvestStat Africa – Harmonized Subnational Crop Statistics for Sub-Saharan Africa.
Scientific Data. https://doi.org/10.1038/s41597-025-05001-z