HarvestStat/HarvestStat-Africa

HarvestStat-Africa: Open Access Harmonized Subnational Crop Statistics # HarvestStat-Africa: Open-Access Harmonized Subnational Crop Statistics ## Overview The HarvestStat-Africa is a repository that contains cleaned and harmonized subnational global crop production data for Africa from various sources, including the Famine Early Warning Systems Network (FEWS NET) of the U.S. Department of State Office of Global Food Security and the Food and Agriculture Organization (FAO). This repository provides access to a comprehensive crop dataset that allows researchers, policymakers, and stakeholders to explore trends and patterns from the subnational to the global level, enabling better-informed decisions related to food security, trade, and development. ## Data sources The data in this repository are compiled from the following sources: - **Famine Early Warning Systems Network (FEWS NET)** (primary source) - FEWS NET Data Warehouse (FDW) - **Food and Agriculture Organization of the United Nations (FAO)** - FAOSTAT - National agricultural agencies ## Repository structure The repository is organized as follows: - `data/` – Raw and intermediate crop statistics generated during internal processing - `docs/` – Documentation related to the dataset - `figures/` – Figures generated during data processing and analysis - `notebooks/` – Jupyter notebooks and Python scripts for country-level data processing - `public/` – Semi-final and final processed datasets (CSV, Parquet, and GeoPackage formats) intended for public use ## Setting up the environment This project uses uv to manage Python dependencies. uv is a fast, cross-platform package manager that works identically on macOS, Windows, and Linux. ### 1. Install uv **macOS / Linux:** ```bash curl -LsSf astral.sh | sh ``` **Windows (PowerShell):** ```powershell powershell -ExecutionPolicy ByPass -c "irm astral.sh | iex" ``` Or via Homebrew (macOS), winget (Windows), or pipx — see the uv install guide. ### 2. Clone and sync ```bash git cl …