Virtual soil project

Welcome to the VSoil project!

VSoil is a modelling software platform supported by the "Agroécosystèmes" division of INRAE and developed and hosted by EMMAH laboratory. It is a tool to help develop numerical models describing the physical, chemical and biological processes of the soil in interaction with the climate, plants and anthropic actions. By facilitating the coupling between these processes, the platform makes it possible to develop complex models from assemblies of existing or new codes.

You can find below all the news about the VSoil project: new stable versions of VSoil software suite, new collaborations (projects, thesis, ...), ...

Look also at the left of this page to access more informations about the VSoil project: description of the project and the software platform, informations about the project life, procedures to download the VSoil software suite (on Linux and Windows), access to documentations of the VSoil software suite (including some tutorials) and how to contact us.

News

  • A new stable version of VSoil software suite (VSoil 20240206) is available. The main features introduced in this version are: (1) for Linux: a button appears in common introduction dialog box in case a new version of VSoil is available; user can choose VSoil repository branch (stable or testing version of VSoil) in preferences dialog box; (2) support of Windows Subsystem for Linux (WSL) is improved; (3) some functions were added to define internode distances and compartment sizes of dynamic meshes; (4) user can now save/load its grid definition in/from a separate file; (5) syntax highlighting in code editor is improved for C++, Fortran and R languages; (6) user can choose different Singularity containers (remotely and locally). See the Technical news page for more details about this version and the Download page to download and install it. 06/02/2024
  • The inventory tool carried out by Enzo Dos Santos during his intership for listing official VSoil modules and models, presenting their characteristics and filtering them according to various criteria is now available here (this tool is also accessible from 'Software platform' > 'Official pools' section on the left part of the current page). See below for more details about Enzo's work. 26/10/2023
  • Bastien Billiot (Groupe Roullier, Saint-Malo) came 2 days in EMMAH to: (1) attend a training session on the use of the VSoil platform, (2) discuss a future collaboration involving VSoil with 3 researchers from EMMAH (Annette Bérard, Claude Doussan and Stéphane Ruy). 26/10/2023
  • Emma Schmitt (AgroParisTech, Nancy) joined the VSoil project as a new modeler during her master's internship at the ONF in Chambéry (March - September 2023). Her objective was to test the climate service prototype developed in the VSoilForOAD project. Emma attended a training session on the use of the VSoil platform and the model developed in the context of the VSoilForOAD project. Using rut depths and soil textures measured on the field and moisture conditions predicted by the climate service prototype, Emma showed it is possible to predict trafficability on the designated paths with a simple field setup and meteorological data. To assess the reliability of weather forecasts in terms of practicability, Shell scripts were developed to launch for 35 sites a series of simulations using both observed and previsional meteo data from ECMWF. To significantly shorten model runtimes, the « stop and resume » mecanism was developed in the VSoil platform allowing to stop a simulation, save its complete state and restart the simulation using this saved state. Using this mecanism, the moisture conditions of each day of the 35 work sites were simulated several times with increasing reliability. The use of the « stop and resume » mecanism and of a multi-processor computing server reduced the total simulation time from over one week to less than one hour. 10/10/2023
  • A new stable version of VSoil software suite (VSoil 20230607) is available. The main features introduced in this version are: (1) for modules: molar masses are now calculated using a dedicated function available in the "utility" section of the code editor; a document template in LaTeX format is available in the "auxiliary user documentation" section; (2) for model execution: management of processor load and parallel computing has been improved on cluster; outputs can be saved after a change of day or year; geographical coordinates (latitude, longitude, altitude and time zone) can be specified; (3) for statistical calculation: an "average run" option has been created and a level of log messages specific to R scripts has been added. See the Technical news page for more details about this version and the Download page to download and install it. 07/06/2023
  • Théo Baudet (Reims Champagne-Ardenne University) joined the VSoil project as a new modeler during his master's internship carried out in INRAE, FARE, Reims (February - September 2023). Within the framework of the COLLECT-OR project, Théo will study and model the decomposition of plant biomass with the STICS residue module which is integrated into the VSoil platform. He will then evaluate the predictive capabilities of the module by launching simulations of the collection project data set. At the beginning of his internship, Théo and Hugues Clivot (INRAE, FARE, Reims) attended a training session on the use of the VSoil platform. 12/04/2023
  • Nicolas Beudez and Nicolas Moitrier (VSoil team, INRAE, EMMAH, Avignon) and 3 modellers of the VSoil project - Claude Doussan (INRAE, EMMAH, Avignon), Eric Michel (INRAE, EMMAH, Avignon) and Hamza Chaïf (INRAE, CEREGE, Aix-en-Provence) participated in the IMAE (Initiative for AgroEcosystems Modelling) workshop that took place in Lyon from 4 to 6 April 2023. The IMAE mission was launched by Agroecosystems and MathNum divisions of INRAE in January 2022 to propose and implement a federation for agroecosystems modelling based initially on 6 founding software systems: OpenAlea, OpenFLUID, RECORD, VSoil, Maelia and STICS. This workshop was the opportunity for Nicolas Beudez and Nicolas Moitrier to make a presentation and animate a demonstration session of the VSoil modelling platform. 06/04/2023
  • Emma Schmitt (AgroParisTech, Nancy) joined the VSoil project as a new modeler during her master's internship at the ONF in Chambéry (March - September 2023). She will improve and test the climate service prototype developed in the VSoilForOAD project for predicting in real-time the practicability of forest traffic lanes. Her work is a continuation of the work done by Manon Martin and Mostafa Moradzadeh (see below). At the beginning of her internship, Emma attended a training session on the use of the VSoil platform and the model developed in the context of the VSoilForOAD project. 28/03/2023
  • Mostafa Moradzadeh (INRAE, EMMAH, Avignon) joined the VSoil project as a new modeler. He works on the VSoilForOAD project since April 2022 until the end of April 2023 in replacement of Manon Martin who found a new job. Mostafa more precisely carries out some sensitivity analysis in order to identify the relative influence of some parameters of the model developed in this project (climatic, soil, vegetation, phenological and mulch parameters, and boundary conditions) on a set of model outputs produced by the module implementing the "soil praticability" process (saturation index, praticability index and drying slope). To do that, two methods implementing the Monte Carlo estimation of the Sobol' indices, named soboljansen and sobolSalt (from "sensitivity" R package), were added in the list of R sensitivity analysis methods available in VSoil. 25/08/2022
  • Julien Ardouin (Savoie Mont Blanc University) joined the VSoil project as a new modeler during his master internship (February - August 2022) for a topic entitled "Sensitivity analysis and inversion of a coupled hydro-geophysical model". This internship is the continuation of the work started by Ismaïl Djellouli (see here). Julien improved the module implementing the "petrophysics" process by adding an option allowing to correct the true resistivity by the temperature provided by a module solving the heat transport equation. Julien then used the Morris sensitivity analysis method available in the VSoil platform to estimate the relative importance of hydraulic and geophysics parameters on electrical apparent resisitivity and water volumetric content values. Julien also used and improved the SCE-UA optimization algorithm available in the VSoil platform to infer hydraulic and geophysics parameters from reference or measured values of electrical apparent resistivitiy and water volumetric content. Julien launched his simulations on the Linux VSoil calculation server available in EMMAH (INRAE, Avignon). At least, Julien developed a Python script allowing to create easily the files (electrical mesh and configuration of electrodes) to be read by the module implementing the "electrical transport" process. 18/08/2022
  • A new stable version of VSoil software suite (VSoil 20220810) is available. The main features introduced in this version are: (1) make official several processes, modules and models, (2) module parameters can be conditionally disabled, depending on the values of other parameters, (3) replace subroutine_succedeed variable by stop_simulation in "initialization", "compute", "interpolate outputs", "validate" and "end" sections of modules, (4) add a tool allowing to identify graphically differences between outputs of models, (5) add the Sobol sensitivity method, (6) add a free section to add the R source code of the user. See the Technical news page for more details about this version and the Download page to download and install it. 10/08/2022
  • A presentation and a demonstration of the VSoil platform and of the model being developed as part of the VSoilForOAD project took place in Avignon on 4 May 2022. 5 persons participated in this day coming from INRAE and ONF. 04/05/2022
  • Manon Martin recently developed several modules that have been integrated to the model she is developing for the VSoilForOAD project: (1) a C++ module that implements the "climate" process and reads climatic data from different sources: SAFRAN, Météo-France or local data, (2) a C++ module that implements the "evapotranspiration" process and has the capacity to read hourly PET (potential evapotranspiration) data or calculate PET values from climatic data using the ASCE standardized Penman-Monteith formulation, (3) a Fortran module that implements the "crop development" process and calculates a leaf area index profile (using read or calculated phenological dates) and root lengths, and (4) a C++ module that implements the new created "soil praticability" process and that calculates several soil saturation and soil praticability indexes. Moreover, the Sobol sensitivity analysis method (from "sensitivity" R package) was added in the list of R sensitivity analysis methods available in VSoil in order Manon can run sensitivity analysis with experimental design built with both continuous and discrete parameters (an example of discrete parameter is the origin of climatic data: SAFRAN, Météo-France or local). 03/05/2022
  • Enzo Dos Santos joined the VSoil project from 28/03/2022 to 19/06/2022 as part of a second year internship at the University Institute of Technology in Computer Science in Aix-Marseille. The subject of his internship is: "Implementation of a database for the VSoil project models inventory". As the number of modules and models within the VSoil project grew, it became important to implement a mechanism to enable their inventory. Enzo will work on the following tasks: (1) Collect information on modules and models from several sources. (2) Complement these sources with additional, more volatileinformation. (3) Format and present the relevant information online on the project website. (4) Add filters and search functions. 28/03/2022
  • A new stable version of VSoil software suite (VSoil 20220127) is available. The main features introduced in this version are: (1) make official several models and modules, (2) replace subroutine_succedeed variable by reduce_dt in compute section of modules, (3) modules can now use external libraries Blas and Lapack on Windows, (4) introduce "stop and resume" capability for models, (5) add SCE-UA and DreamZS parameter optimization methods, (6) enable parallel run for Morris method (sensitivity analysis). See the Technical news page for more details about this version and the Download page to download and install it. 27/01/2022
  • Hamza Chaif (INRAE, EMMAH, Avignon) joined the VSoil Project as a new modeler. He started his post-doctorate in September 2021 as part of the SmartFertiReuse project. In order to model the transfer in the soil of contaminants present in the treated wastewater, Hamza uses a 1D mechanistic soil transfer model based on the PASTIS model and implemented in the VSoil platform. Both pedotransfer functions and colloids retention parameters need to be determined. To do so, the DREAMzs bayesian parameter estimation method was added in the list of R parameter estimation methods available in VSoil. More details on Hamza's work here. 14/12/2021
  • Manon Martin (INRAE, EMMAH, Avignon) started a new collaboration with the VSoil project. She started her post-doctorate in January 2020 as part of the VSoilForOAD project which aims to develop a prototype of a climate service capable of predicting the practicability of the traffic routesfor logging machinery. For this, she uses a 1D mechanistic soil transfer model based on the PASTIS model, implemented in the VSoil platform and adapted to the forestry context. The objective of Manon is to simplify the parameterisation of this model and to use easily accessible data. For this purpose, Manon created a VSoil module implementing several pedotransfer functions to identify the one that is most adapted to forest soils and she will use the Fast99 sensitivity analysis method available in VSoil to evaluate the key parameters for predicting water dynamics of forest soils. A new feature is being developed by the VSoil team to stop and resume a simulation in order Manon can use VSoil to provide real-time water dynamics. More details on Manon's work here. 17/11/2021
  • Elisabeth Fries (Gustave Eiffel University, Champs-sur-Marne) joined the VSoil project as a new modeler. She started in January 2021 her PhD thesis entitled "Transport and retention of fluorinated pollutants in soils: small scale experiments, magnetic resonance imaging and computer simulations". Elisabeth started using the official CDE_column model from VSoil platform to simulate the transport of fluorinated pollutants in a soil column. During her PhD she will improve this model by taking into account different mechanisms of adsorption of these pollutants onto soil. To calibrate some parameters of the model, she will use the Levenberg-Marquardt's and DREAM optimisation algorithms available in VSoil. More details on Elisabeth's work here. 30/07/2021
  • Ismaïl Djellouli (Sorbonne University, Paris) joined the VSoil project as a new modeler. He used the VSoil platform during his master internship (March - August 2021) for a topic entitled "Inversion of soil hydraulic properties with a coupled modelling of soil water transfers and electrical resistivity tomography survey". He added in VSoil two processes named "petrophysics" and "electrical transport" and two C++ modules implementing these processes. The module implementing the "electrical transport" process used Gimli, a library for geophysical modelling and inversion. In order to estimate hydraulic and petrophysical parameters, the SCE-UA (Shuffle Complex Evolution - University of Arizona) optimization algorithm was added in the list of R parameter estimation methods available in VSoil. The Morris sensitivity analysis method available in VSoil was previously used to determine the least sensitive parameters which are thus fixed in the parameter estimation. More details on Ismaïl's work here. 20/07/2021
  • A new stable version of VSoil software suite (VSoil 20210527) is available. The main features introduced in this version are: (1) make official several models and modules, (2) make official a C++ module running a Python script with an embedded Python interpreter), (3) add the possibility to duplicate inputs/outputs, (4) add physical subroutines to be used in Fortran modules, (5) add an utility function calculating the 1D integral of the product of two functions (Fortran only). See the Technical news page for more details about this version and the Download page to download and install it. 27/05/2021
  • A new stable version of VSoil software suite (VSoil 20210115) is available. The main features introduced in this version are: (1) make official several models and modules, (2) improve API on exported models, (3) introduce an external diff tool (Linux only) to compare modules source codes, (4) add 3 biological functions (Andren, q10 and Vanthoff) available from modules (Fortran only), (5) allow iterations between modules when they are strongly coupled by their inputs/outputs. See the Technical news page for more details about this version and the Download page to download and install it. 15/01/2021
  • Nicolas Beudez (INRAE, EMMAH, Avignon) joined the laboratory and the VSoil project as a permanent member. He left AMAP laboratory (Montpellier) within the scope of an internal INRAE mobility. He is a scientific computing engineer and will take over part of the activities of the current scientific manager of the VSoil project (François Lafolie, INRAE, EMMAH) who will soon retire. 01/10/2020
  • A new stable version of VSoil software suite (VSoil 20200907) is available. The main features introduced in this version are: make official several models and modules. See the Technical news page for more details about this version and the Download page to download and install it. 07/09/2020
  • A new stable version of VSoil software suite (VSoil 20200609) is available. The main features introduced in this version are: (1) make official several models, modules and processes, (2) new remote connection to Meso@LR cluster in Montpellier, (3) add a template for module user documentation. See the Technical news page for more details about this version and the Download page to download and install it. 09/06/2020
  • A new stable version of VSoil software suite (VSoil 20200330) is available. The main features introduced in this version are: (1) make official several modules, (2) update some modules to manage grid change (interpolate of profile outputs), (3) new save frequency "after nb iterations" replaces "save each validate", (4) improve runtime performance of some modules and vsoil utility functions, (5) new CPU management for parallel run to improve multiple concurrent jobs on the same computer. See the Technical news page for more details about this version and the Download page to download and install it. 30/03/2020
  • A new stable version of VSoil software suite (VSoil 20200113) is available. The main features introduced in this version are: (1) make official several models, modules and processes, (2) general filter is now usable, (3) allow save frequency in years, (4) add batch (multi-run) capabilty. See the Technical news page for more details about this version and the Download page to download and install it. 13/01/2020
  • Manon Martin (Avignon University) will defend her PhD entitled "Development of a water balance model in forest soil partly compacted using parsimonious data" on 16 October 2019. You can find here an abstract (in french and in english) of this thesis. 14/10/2019