WheatFspm is a Functional Structural Plant Model (FSPM) of wheat which fully integrates shoot morphogenesis and the metabolism of carbon (C) and nitrogen (N) at organ scale within a 3D representation of plant architecture. Plants are described as a collection of tillers, each consisting in individual shoot organs (lamina, sheath, internode, peduncle, chaff), a single root compartment, the grains, and a phloem.
WheatFspm simulates:
- Organ photosynthesis, temperature and transpiration from light distribution within the 3D canopy which is provided by Caribu and Adel-Wheat models ((Chelle and Andrieu, 1998) ; (Fournier et al., 2003), respectively)
- Leaf and internode elongation
- Leaf, internode and root growth in mass
- N acquisition, synthesis and allocation of C and N metabolites at organ level and among tiller organs
- Senescence of shoot organs and roots
Model inputs are the climatic conditions (temperature, light, humidity, CO2, wind, soil NO3-) and initial dimensions, mass and metabolic composition of individual organs.
WheatFspm consists in a set of sub-models (named submodules in git) which share inputs/outputs through an MTG object:
Adapted from Gauthier et al. (2020)
- Farquhar-Wheat: Farquhar-based model of photosynthesis, stomatal conductance, organ temperature and transpiration.
- Elong-Wheat: regulation of leaf and internode elongation by C and N metabolites, temperature and coordination rules.
- Growth-Wheat: growth in biomass of leaves, internodes and roots ; related consumption in C and N metabolites.
- CN-Wheat: synthesis and degradation of C and N metabolites at organ level and allocation between tillers' organs. See doc at https://cn-wheat.readthedocs.io/
- Respi-Wheat: respiratory-costs related to the main biological processes.
- Senesc-Wheat: organ senescence and consequences in organ biomass, green area and remoblisation of C and N metabolites.
- Fspm-Wheat: is the submodule containing the interfaces (facades) for reading/updating information between each sub-model and the MTG. Also includes the scripts to be run for using all sub-models.
WheatFspm has been tested on Windows 10 64 bit and Linux Fedora 24 64 bit. WheatFspm is now developed in Python 3.
WheatFspm has the following dependencies (see documentation in the links provided, instructions for their installation are given in Installing):
-
To run the model:
- Python >= 3.7
- NumPy >= 1.7.2
- SciPy >= 0.12.1
- Pandas >= 0.14.0
- Openalea.MTG
- Openalea.Plantgl
- Openalea.Lpy
- Alinea.Caribu
- Alinea.Adel
- Alinea.Astk
-
To run the tools: Matplotlib >= 1.3.1
-
To build the documentation: Sphinx >= 1.1.3
-
To run the tests: Nose >= 1.3.0
- Install Miniforge: https://github.com/conda-forge/miniforge
- Create a conda environment:
mamba create -n wheatfspm openalea.wheatfspm -c conda-forge -c openalea3- activate the environment:
mamba activate wheatfspm
- To clone the project, please use:
git clone https://github.com/openalea/WheatFspm
- create and activate a conda environment with dependencies:
mamba env create -n wheatfspm -f conda/environment.yml
activate wheatfspm
- under the root directory of WheatFspm install the package in editable mode
cd WheatFspm
pip install -e .
To date, WheatFspm has been used in four main contexts described below.
The scripts to run WheatFSPM are located in:
WheatFspm\fspm-wheat\example\NEMAWheatFspm\fspm-wheat\example\Papier_FSPMA2016WheatFspm\fspm-wheat\example\Vegetative_stagesWheatFspm\fspm-wheat\example\Scenarii_monoculms
This example deals with the post-flowering stages of wheat developement under 3 nitrogen fertilisation regies (H0, H3 and H15). The main processes described are leaf senescence, C and N remobilisation, grain filling). During that stages, all vegetative organs have completed their growth. This work led to the research articles Barillot et al. (2016a) and Barillot et al. (2016b). This example has been maintained in the current version ; results of above papers were generated using the tag release-1.0 of CN-Wheat.
To run the example:
- Open a command line interpreter in
WheatFspm\fspm-wheat\example\NEMA - Run each script called main.py located in NEMA_H0, NEMA_H3, NEMA_H15:
python main.py
This example deals with the effects of leaf inclination, radiations regimes, plant density and sowing patterns on plant metabolism and grain filling during the post-flowering stages.
This work led to the research article Barillot et al. (2019).
The scripts have not been maintained in the current version but are available using tags paper_FSPMA16 or each submodule listed in Description.
To run the example:
- Open a command line interpreter in
WheatFspm\fspm-wheat\example\Papier_FSPMA2016 - Run each script called main.py located in the different sub-directories:
python main.py
This example deals with the early vegetative stages of wheat development. It mainly covers the processes of leaf, internode and roots growth.
Tillering is simplified: tiller emergence is a model input while tiller metabolism and growth is approximated from that of the main stem.
This work led to the research article Gauthier et al. (2020). Results were obtained from the tag paper_JXBot_2020.
To run the model used for the paper, please download the code archives at
To run the example:
- Open a command line interpreter in
WheatFspm\fspm-wheat\example\Vegetative_stages - Run script main.py:
python main.py
This example deals with the plasticity of leaf growth during the vegetative stages of wheat development. The growth of wheat monoculms was simulated for highly contrasting conditions of soil nitrogen concentration, incident light and planting density. This work led to the research article Gauthier et al. (2021). Results were obtained from the following sources: cn-wheat, elong-wheat, growth-wheat, farquhar-wheat, senesc-wheat, respi-wheat and fspmwheat-wheat.
To run the model used for the paper, please download the code archives at
To run the example:
- Open a command line interpreter in
WheatFspm\fspm-wheat\example\Scenarios_monoculms - For a single scenraio, run the script main.py:
python main.py - The whole set of scenarios was run in the high-performance computing center MESO@LR (Université de Montpellier, France)
- Romain BARILLOT - model designing, development and validation - rbarillot
- Marion GAUTHIER - model designing, development and validation - mngauthier
- Camille CHAMBON - software designing, development, deployment and optimization - cachambon
- Bruno ANDRIEU - model designing and validation, scientific project management - bandrieu
- Christian FOURNIER - christian34
- Christophe PRADAL - pradal
- INRAE: salaries of permanent staff
- French Research National Agency: projects Breedwheat (ANR-10-BTBR-03) and Wheatamix (ANR-13-AGRO0008): postdoctoral research of R.Barillot
- itk company and ANRT: funded the Cifre PhD thesis of M.Gauthier
This project is licensed under the CeCILL-C License - see file LICENSE for details