LandInG: Land Input Generator

---

Main contact: Sebastian Ostberg, ostberg@pik-potsdam.de

Affiliation: Potsdam Institute for Climate Impact Research (PIK), Potsdam, Germany

This project contains a collection of scripts to derive basic input datasets for terrestrial ecosystem models from diverse and partially conflicting data sources. It has been developed with a focus on the open-source dynamic global vegetation, hydrology and crop growth model LPJmL (Lund-Potsdam-Jena with managed Land) and complements the LPJmL model code release. This toolbox does not cover climate inputs.

LandInG version 1.0 has been documented in detail in the following publication: Ostberg, S., Müller, C., Heinke, J., and Schaphoff, S.: LandInG 1.0: a toolbox to derive input datasets for terrestrial ecosystem modelling at variable resolutions from heterogeneous sources, Geosci. Model Dev., 16, 3375–3406, https://doi.org/10.5194/gmd-16-3375-2023, 2023

Changes in subsequent versions are documented in the Changelog.

All source code, configuration and parameter files are subject to Copyright (C) by the Potsdam Institute for Climate Impact Research (PIK), see the file COPYRIGHT, and are licensed under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3, see the file LICENSE.

LandInG uses functionality provided by the lpjmlkit package to work with the LPJmL file format. To install the up-to-date lpjmlkit version an additional repository needs to be added in R:

options(repos = c(CRAN = "@CRAN@", pik = "https://rse.pik-potsdam.de/r/packages"))
install.packages("lpjmlkit")

Users running LandInG on the PIK 2024 high-performance cluster may use source R_env_PIK.sh in the base directory to load required software modules and set up R to use a library with pre-installed R packages.

Structure:

• elevation: subdirectory containing scripts to derive an elevation input
• fertilizer: subdirectory containing scripts to derive fertilizer and manure inputs from various sources
• gadm: subdirectory containing scripts to process GADM data (grid, country/region/district codes, land fraction in each cell etc.)
• lakes_rivers: subdirectory containing scripts to process GLWD data and extract cell fractions covered by lakes and rivers
• landuse: subdirectory containing scripts to generate a landuse dataset from various sources
• river_routing: subdirectory containing scripts to derive inputs related to river routing
• reservoirs: subdirectory containing scripts to derive dam/reservoir input
• soil: subdirectory containing scripts to derive soil inputs
• CHANGELOG.md: documentation of changes between LandInG versions
• COPYRIGHT: copyright information
• LICENSE: license information
• README.md: this file
• VERSION: current version number for LandInG
• landing_setup.R: script defining a LandInG_setup environment used across most R scripts in LandInG
• R_env_PIK.sh: bash script that sets up the software environment to run LandInG R scripts on the PIK 2024 high-performance cluster

How to use

• Normally, you will run the scripts in the gadm directory first, which generate a grid file that is used by all the other input generating scripts.
• In order to run LPJmL with the most basic settings, you will also need a soil input, which is generated by the script in soil, and a lake input, which is generated by the scripts in lakes_rivers.
• In order to use LPJmL with river routing, you will also need to run the scripts in river_routing.
• In order to use LPJmL with reservoirs, you will need data generated by the scripts in river_routing and need to run the scripts in reservoirs and elevation.
• Scripts in landuse require not only the grid, but also grid-to-country and grid-to-region data generated by the scripts in gadm.
• Scripts in fertilizer require a grid and data generated by the scripts in gadm and landuse.

README files in each subdirectory provide additional information.