Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

Recent Releases of HarvestStat

HarvestStat - v1.2 (official)

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 the KE2007A2 / KE2009A2 delineations, now
    linked and harmonized onto the 47-unit KE2013A1 structure, 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

Dataset: https://doi.org/10.5061/dryad.vq83bk42w

Consumption - Agriculture and Nutrition - Jupyter Notebook
Published by gnodnooh 11 days ago

HarvestStat - v1.0 (official)

HarvestStat Africa v1.0 – Official Release

This is the official release of HarvestStat Africa v1.0, which includes 574,204 records across 33 Sub-Saharan African countries.

Please download the dataset from:
doi_10_5061_dryad_vq83bk42w__v20250327.zip

This is the same file hosted on Dryad – HarvestStat Africa.

Contents of the ZIP Archive

1. hvstat_africa_data_v1.0.csv

A harmonized dataset of subnational crop statistics.

Data Structure:

Column Name Description
fnid FEWS NET's unique geographic unit identifier
country Country 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 Name of the growing season
planting_year Planting start year
planting_month Planting start month
harvest_year Harvest end year
harvest_month Harvest end month
crop_production_system Crop production system (e.g., irrigated, rainfed)
qc_flag Quality control flag (0 = none, 1 = outlier, 2 = low variance)
area Cropped area (hectares)
production Production volume (metric tonnes)
yield Yield (metric tonnes per hectare)

2. hvstat_africa_boundary_v1.0.gpkg

A GeoPackage file containing FEWS NET-aligned administrative boundaries, linked to crop data via fnid.

3. Readme.md

A markdown file containing information about the dataset.

4. fdw_raw_data_v1.0.zip

A zipped archive of raw country-level FEWS NET Data Warehouse (FDW) data for all 33 countries. Includes:

  • adm_crop_data_raw_AO.csv – Angola
  • adm_crop_data_raw_BF.csv – Burkina Faso
  • adm_crop_data_raw_BI.csv – Burundi
  • adm_crop_data_raw_BJ.csv – Benin
  • adm_crop_data_raw_CD.csv – DR Congo
  • adm_crop_data_raw_CF.csv – Central African Republic
  • adm_crop_data_raw_CM.csv – Cameroon
  • adm_crop_data_raw_ET.csv – Ethiopia
  • adm_crop_data_raw_GH.csv – Ghana
  • adm_crop_data_raw_GN.csv – Guinea
  • adm_crop_data_raw_KE.csv – Kenya
  • adm_crop_data_raw_LR.csv – Liberia
  • adm_crop_data_raw_LS.csv – Lesotho
  • adm_crop_data_raw_MG.csv – Madagascar
  • adm_crop_data_raw_ML.csv – Mali
  • adm_crop_data_raw_MR.csv – Mauritania
  • adm_crop_data_raw_MW.csv – Malawi
  • adm_crop_data_raw_MZ.csv – Mozambique
  • adm_crop_data_raw_NE.csv – Niger
  • adm_crop_data_raw_NG.csv – Nigeria
  • adm_crop_data_raw_RW.csv – Rwanda
  • adm_crop_data_raw_SDSS.csv – South Sudan and Sudan
  • adm_crop_data_raw_SL.csv – Sierra Leone
  • adm_crop_data_raw_SN.csv – Senegal
  • adm_crop_data_raw_SO.csv – Somalia
  • adm_crop_data_raw_TD.csv – Chad
  • adm_crop_data_raw_TG.csv – Togo
  • adm_crop_data_raw_TZ.csv – Tanzania
  • adm_crop_data_raw_UG.csv – Uganda
  • adm_crop_data_raw_ZA.csv – South Africa
  • adm_crop_data_raw_ZM.csv – Zambia
  • adm_crop_data_raw_ZW.csv – Zimbabwe

Citation

(To be updated following the publication of our paper.)

Lee, D., Anderson, W., Chen, X., Davenport, F., Shukla, S., Sahajpale, R., Budde, M., Rowland, J., Verdin, J., You, L., Ahouangbenoni, M., Davis, K., Kebede, E., Ehrmannk, S., Justice, C., & Meyer, C. (2024).
HarvestStat Africa – Harmonized Subnational Crop Statistics for Sub-Saharan Africa. EarthArXiv.
https://doi.org/10.31223/X5M123

Consumption - Agriculture and Nutrition - Jupyter Notebook
Published by gnodnooh over 1 year ago

HarvestStat - v1.0 (Official)

HarvestStat Africa v1.0 – Official Release

This is the official release of HarvestStat Africa v1.0, which includes 574,204 records across 33 Sub-Saharan African countries.

Please download the dataset from:
doi_10_5061_dryad_vq83bk42w__v20250324.zip
This is the same file hosted on Dryad – HarvestStat Africa (Version: March 24, 2025).

Contents of the ZIP Archive

1. hvstat_africa_data_v1.0.csv

A harmonized dataset of subnational crop statistics.

Data Structure:

Column Name Description
fnid FEWS NET's unique geographic unit identifier
country Country 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 Name of the growing season
planting_year Planting start year
planting_month Planting start month
harvest_year Harvest end year
harvest_month Harvest end month
crop_production_system Crop production system (e.g., irrigated, rainfed)
qc_flag Quality control flag (0 = none, 1 = outlier, 2 = low variance)
area Cropped area (hectares)
production Production volume (metric tonnes)
yield Yield (metric tonnes per hectare)

2. hvstat_africa_boundary_v1.0.gpkg

A GeoPackage file containing FEWS NET-aligned administrative boundaries, linked to crop data via fnid.

3. Readme.md

A markdown file containing information about the dataset.

4. fdw_raw_data_v1.0.zip

A zipped archive of raw country-level FEWS NET Data Warehouse (FDW) data for all 33 countries. Includes:

  • adm_crop_data_raw_AO.csv – Angola
  • adm_crop_data_raw_BF.csv – Burkina Faso
  • adm_crop_data_raw_BI.csv – Burundi
  • adm_crop_data_raw_BJ.csv – Benin
  • adm_crop_data_raw_CD.csv – DR Congo
  • adm_crop_data_raw_CF.csv – Central African Republic
  • adm_crop_data_raw_CM.csv – Cameroon
  • adm_crop_data_raw_ET.csv – Ethiopia
  • adm_crop_data_raw_GH.csv – Ghana
  • adm_crop_data_raw_GN.csv – Guinea
  • adm_crop_data_raw_KE.csv – Kenya
  • adm_crop_data_raw_LR.csv – Liberia
  • adm_crop_data_raw_LS.csv – Lesotho
  • adm_crop_data_raw_MG.csv – Madagascar
  • adm_crop_data_raw_ML.csv – Mali
  • adm_crop_data_raw_MR.csv – Mauritania
  • adm_crop_data_raw_MW.csv – Malawi
  • adm_crop_data_raw_MZ.csv – Mozambique
  • adm_crop_data_raw_NE.csv – Niger
  • adm_crop_data_raw_NG.csv – Nigeria
  • adm_crop_data_raw_RW.csv – Rwanda
  • adm_crop_data_raw_SDSS.csv – South Sudan and Sudan
  • adm_crop_data_raw_SL.csv – Sierra Leone
  • adm_crop_data_raw_SN.csv – Senegal
  • adm_crop_data_raw_SO.csv – Somalia
  • adm_crop_data_raw_TD.csv – Chad
  • adm_crop_data_raw_TG.csv – Togo
  • adm_crop_data_raw_TZ.csv – Tanzania
  • adm_crop_data_raw_UG.csv – Uganda
  • adm_crop_data_raw_ZA.csv – South Africa
  • adm_crop_data_raw_ZM.csv – Zambia
  • adm_crop_data_raw_ZW.csv – Zimbabwe

Citation

(To be updated following the publication of our paper.)

Lee, D., Anderson, W., Chen, X., Davenport, F., Shukla, S., Sahajpale, R., Budde, M., Rowland, J., Verdin, J., You, L., Ahouangbenoni, M., Davis, K., Kebede, E., Ehrmannk, S., Justice, C., & Meyer, C. (2024).
HarvestStat Africa – Harmonized Subnational Crop Statistics for Sub-Saharan Africa. EarthArXiv.
https://doi.org/10.31223/X5M123

Consumption - Agriculture and Nutrition - Jupyter Notebook
Published by gnodnooh over 1 year ago

HarvestStat - HarvestStat Africa v1.0

This release includes the HarvestStat_Africa_v1.0.zip, which contains the repository codes corresponding to the submitted HarvestStat Africa manuscript (https://doi.org/10.31223/X5M123). Please be aware that there may be discrepancies between these codes and the current version in the HarvestStat repository.

Consumption - Agriculture and Nutrition - Jupyter Notebook
Published by gnodnooh almost 2 years ago