Planned intervention: On Thursday 19/09 between 05:30-06:30 (UTC), Zenodo will be unavailable because of a scheduled upgrade in our storage cluster.
Published March 1, 2024 | Version v1.0.0
Software Open

Python version of RothC Official Rothamsted Research Release

  • 1. Rothamsted Research

Description

The Rothamsted carbon model Python version (RothC_Py)

Purpose

RothC models the turnover of organic carbon in non-waterlogged top-soil. It accounts for the effects of soil texture, temperature, moisture content and plant cover on the turnover process. It uses a monthly time step to calculate total organic carbon (t ha-1), microbial biomass carbon (t ha-1) and Δ14C (from which the equivalent radiocarbon age of the soil can be calculated).

Development history

The first version of RothC created by David Jenkinson and James Rayner in 1977 (Jenkinson and Rayner, 1977).

In 1987 an updated version was published, see Jenkinson et al. (1987). This version included the prediction of the radiocarbon age of the soil, the pools POM (physically stabilized organic matter) and COM (chemically stabilized organic matter) were replaced with Hum (humified organic matter) and IOM (inert organic matter), and the microbial biomass pool was split into BioA (autochthonous biomass) and BioZ (zymogenous biomass).

In 1990, the two biomass pools were combined into a single pool (Jenkinson, 1990) this version is the standard version of the model, that this code refers to.

Other published developments of the model include:

Farina et al. (2013) modified the soil water dynamics for semi-arid regions.

Giongo et al. (2020) created a daily version and modified the soil water dynamics, for Caatinga shrublands, in the semiarid region, North-East Brazil.

Description of files included

RothC_description.pdf

This file contains the description of the model.

RothC_Py.py

This file contains the RothC code in Python language. Details of the inputs required, pools modelled, and units are in the code.

RothC_input.dat

This file contains input variables for the model.

At the start of the file values for clay (%), soil depth (cm), inert organic matter (IOM, t C ha-1) and number of steps (nsteps) are recorded.
Following that there is a table which records monthly data on yearmonthpercentage of modern carbon (%), mean air temperature (Tmp, °C), total monthly rainfall (Rain, mm), total monthly open-pan evaporation (Evap, mm), all carbon input entering the soil (from plants, roots, root exudates) (C_inp, t C ha-1), carbon input from farmyard manure (FYM, t C ha-1), plant cover (PC, 0 for no plants e.g. bare or post-harvest, 1 for plants e.g. crop or grass), and the DPM/RPM ratio (DPM_RPM) of the carbon inputs from plants.

year_results.csv

This file contains the yearly values of the SOC (both the pools and Total) and the delta 14-carbon.

The pools are:
Year
Month - Always December for the yearly output
DPM - Decomposable plant material (t C ha-1)
RPM - Resistant plant material (t C ha-1)
BIO - Microbial biomass (t C ha-1)
HUM - Humified organic matter (t C ha-1)
IOM - Inert organic matter (t C ha-1)
SOC - Total soil organic carbon (t C ha-1)
deltaC - delta 14C (‰)

The total organic carbon (soil organic carbon) is equal to the sum of the 5 pools.

TOC or SOC = DRM + RPM + BIO + HUM + IOM

month_results.csv

This file contains the monthly inputs, rate modifying factors, SOC pools.

Year
Month
DPM_t_C_ha - Decomposable plant material (t C ha-1)
RPM_t_C_ha - Resistant plant material (t C ha-1)
BIO_t_C_ha - Microbial biomass (t C ha-1)
HUM_t_C_ha - Humified organic matter (t C ha-1)
IOM_t_C_ha - Inert organic matter (t C ha-1)
SOC_t_C_ha - Total soil organic carbon (t C ha-1)

Requirements

The code was written in Python 3.9.7.

Installation/set-up

A directory path will need to be provided as indicated in the code ([“INPUT DIRECTORY PATH”]), to read in RothC_input.dat.

Example of how to run the model
The file RothC_input.dat contains all the inputs data needed to run the model. The month results (month_results.csv) and year results (year_results.csv) files correspond to this input file as an example. The model is normally run to equilibrium using average temperature, rainfall, open pan evaporation, an average carbon input to the soil, the equilibrium run is to initialise the soil carbon pools. Once the soil carbon pools have been initialised, the model is run for the period of interest. The met data (temperature, rainfall and evaporation) can be average or actual weather data. The carbon input to the soil can be: 1) adjusted so the modelled output matches the measured data, or 2) can be estimated from yield data (Bolinder et al., 2007), or NPP data.

References

Bolinder MA, Janzen HH, Gregorich EG, Angers DA, VandenBygaart AJ. An approach for estimating net primary productivity and annual carbon inputs to soil for common agricultural crops in Canada. Agriculture, Ecosystems & Environment 2007; 118: 29-42.
Farina R, Coleman K, Whitmore AP. Modification of the RothC model for simulations of soil organic C dynamics in dryland regions. Geoderma 2013; 200: 18-30.
Giongo V, Coleman K, Santana MD, Salviano AM, Olszveski N, Silva DJ, et al. Optimizing multifunctional agroecosystems in irrigated dryland agriculture to restore soil carbon - Experiments and modelling. Science of the Total Environment 2020; 725.
Jenkinson DS. The Turnover of Organic-Carbon and Nitrogen in Soil. Philosophical Transactions of the Royal Society of London, Series B: Biological Sciences 1990; 329: 361-368.
Jenkinson DS, Hart PBS, Rayner JH, Parry LC. Modelling the turnover of organic matter in long-term experiments at Rothamsted. INTECOL Bulletin 1987; 15: 1-8.
Jenkinson DS, Rayner JH. Turnover of soil organic matter in some of the Rothamsted classical experiments. Soil Science 1977; 123: 298-305.

Files

RothC_Py-1.0.0.zip

Files (1.0 MB)

Name Size Download all
md5:05c0cce53e2674e518bfc1ba1dffc7ad
503.3 kB Download
md5:50ab29b45cec7f0d02bc356a3efa2c49
504.7 kB Preview Download

Additional details

Funding

Growing Health BB/X010953/1; BBS/E/RH/230003C
Biotechnology and Biological Sciences Research Council
Resilient Farming Futures BB/X010961/1; BBS/E/RH/230004A; BBS/E/RH/230004C
Biotechnology and Biological Sciences Research Council
AgZero+ NE/W005050/1
Natural Environment Research Council

Software

Repository URL
https://github.com/Rothamsted-Models/RothC_Py
Programming language
Python
Development Status
Active