R3DFEM: an R package for running the 3D-CMCC-FEM model

Elia Vangi,Daniela Dalmonech,Alessio Collalti

DOI: https://doi.org/10.1101/2024.10.07.616968

2024-10-11

Abstract:Forest ecosystems account for about one-third of the Earth's land area, and monitoring their structure and dynamics is essential for understanding the land's carbon cycle and their role in the greenhouse gas balance. In this framework, process-based forest models (PBFMs) allow studying, monitoring and predicting forest growth and dynamics, capturing spatial and temporal patterns of carbon fluxes and stocks. The Three Dimensional-Coupled Model Carbon Cycle - Forest Ecosystem Module (3D-CMCC-FEM) is a well-known eco-physiological, biogeochemical, biophysical process-based model, able to simulate energy, carbon, water and nitrogen fluxes and their allocation in homogeneous and heterogenous forest ecosystem. The model is specifically designed to represent forest stands, from simple ones to those with complex structures, involving several cohorts competing for light and other resources in a prognostic way. Currently, the model is implemented in C-language, which can be challenging for the broad public to use, and thus limiting its applications. In this paper, we present the open-source R package R3DFEM which introduces efficient methods for: i) generating and handling input data needed for the model initialization; ii) running model simulations with different set up and exploring input; and iii) plotting output data. The functions in the R-package are designed to be user-friendly and intended for all R users with little to advanced coding skills, who aim to perform simulations using the 3D-CMCC-FEM. Here we present the package and its functionalities using some real case study and model applications.

Bioinformatics

What problem does this paper attempt to address?

The paper aims to address the following issues:

1. **Improving the accessibility and usability of forest models**: Although the existing 3D-CMCC-FEM model is powerful, it is written in C language, which poses a high barrier to entry for ordinary users. Therefore, this paper introduces an R package named R3DFEM, making it easier for more users to utilize this model.

2. **Simulating complex forest structures**: The paper mentions that the 3D-CMCC-FEM model is specifically designed to simulate forest structures ranging from simple to complex, including scenarios of multi-species competition for light and other resources. With the R3DFEM package, users can more easily conduct such simulations.

3. **Providing comprehensive functional support**: The R3DFEM package not only offers the functionality to run the model but also provides features for generating and processing input data, and plotting output results. This allows users to complete the entire process from data preparation to result analysis within a unified environment.

In summary, this paper primarily addresses how to lower the barrier to using complex forest ecological models by developing a user-friendly R package, enabling more researchers to utilize this tool for forest ecosystem research.