Sample data for training EPIC-IIASA global gridded crop model emulators

This repository provides intermediary and output data required to reproduce the study Folberth et al. (submitted) "CROMES v1.0: A flexible CROp Model Emulator Suite for climate impact assessment". Associated code is provided in a separate repository at https://doi.org/10.5281/zenodo.14901127. Raw data can be obtained from the references.

The below folder structure shows how the project should be orgainzed to match the code repository. Herein, we provide separate zipped folders for the lowest level, e.g., processed, auxiliary.

project_name/                        ### Main folder, by default labelled cromes in the associated code repository
+-- data/                                ## All input and auxiliary data
¦   +-- raw/                             # Immutable raw data. Not included here but referenced in the publication
¦   +-- processed/                   # Cleaned and processed data. I.e., explanatory and target features for
¦   +-- auxiliary/                      # Data required for evaluations and visualization
¦   +-- temp/                          # Temporary storage of train/predict-ready feature files
+-- src/                                  ## All code required for training and evaluating emulators
¦   +-- features/                      # Feature engineering scripts (included in separate repository)
¦   +-- models/                       # Model training and evaluation scripts (included in separate repository)
¦   +-- visualization/               # Scripts for generating visualizations  (included in separate repository)
+-- output/                            ## Target folder for all outputs, here pre-populated
    +-- models/                       # Emulator model files
    +-- feature_importance     # Feature importances for pre-trained emulator models
    +-- figures/                        # Generated plots and figures (selected plots from the publication)
    +-- tables/                         # Generated tables (performance metrics, etc.)
    +-- predictions/                 # Generated crop yield predictions
    +-- evals/                           # Evaluations