food-opt Documentation

A global food systems optimization model that explores trade-offs between environmental sustainability and nutritional outcomes using linear programming.

Note

🚧 This project is currently under construction! 🚧

Documentation is kept up to date at a best effort basis. Certain model elements are still missing. Validation of model results has not yet been conducted. Expect frequent breaking changes.

Contents:

• Introduction
  • Overview
  • Key Features
  • Getting Started
  • Quick Start
  • Project Structure
• Model Framework
  • Mathematical Structure
  • PyPSA Implementation
  • Resource Flow Structure
  • Units and Conversions
  • Solver Configuration
  • Model Scale
• Land Use & Resource Classes
  • Overview
  • Spatial Aggregation
  • Resource Classes
  • Land Area Aggregation
  • Grazing-only Land
  • Irrigated vs. Rainfed Land
  • Land Use Change
  • Configuration Parameters
  • Workflow Rules
  • Visualization
• Crop Production
  • Overview
  • Crop Coverage
  • GAEZ Yield Data
  • Yield Aggregation
  • Production Constraints
  • Production Costs
  • Water Constraints
  • Fertilizer
  • Growing Seasons
  • Multiple Cropping
  • Crop-Specific Data Files
  • Workflow Rules
  • References
• Livestock & Grazing
  • Overview
  • Animal Products
  • Production Systems
  • Grassland Yields
  • Feed Conversion
  • Model Implementation
  • Emissions from Livestock
  • Production Costs
  • Configuration Parameters
  • Workflow Rules
  • References
• Food Processing & Trade
  • Food Processing
  • Trade
  • Model Implementation
• Nutrition
  • Overview
  • Macronutrients
  • Food Groups
  • Population Data
  • Nutritional Content Data
  • Per-Capita vs. Total Consumption
  • Dietary Patterns
  • Workflow Integration
• Current Diets
  • Overview
  • Data Sources
  • GDD to Food Group Mapping
  • Data Processing
  • Country Coverage
  • Workflow Integration
  • References
• Health Impacts
  • Overview
  • Data Inputs
  • Dietary Risk Factors
  • Preparation Workflow
  • From Diet to Risk Exposure
  • Objective Contribution
  • Configuration Highlights
  • Outputs
  • References
• Environmental Impacts
  • Overview
  • Greenhouse Gas Emissions
  • Land Use Change
• Production Costs
  • Overview
  • Cost Categories
  • What Costs Include and Exclude
  • Data Sources
  • Cost Processing Methodology
  • Application in the Optimization Model
  • Model Units and Conversions
  • Configuration
  • See Also
• Configuration
  • Overview
  • Configuration sections
• Data Sources
  • Overview
  • Agricultural Production Data
  • Spatial and Administrative Data
  • Population Data
  • Health and Epidemiology Data
  • Water Resources Data
  • Food Processing Data
  • Nutritional Data
  • Mock and Placeholder Data
  • Data License Summary
• Workflow & Execution
  • Overview
  • Validation Hook
  • Key Snakemake Rules
  • Execution Commands
  • Memory Management
  • Parallelization
  • Incremental Development
• Results & Visualization
  • Overview
  • PyPSA Network Results
• API Reference
  • Core Scripts
  • Utility Modules
  • Visualization Scripts
• Development & Contributing
  • Overview
  • Development Setup
  • Code Conventions
  • Configuration Validation
  • Repository Structure
  • Adding New Features
  • Version Control
  • Documentation
  • Contributing Guidelines

Indices and tables

• Index

• Module Index

• Search Page