Skip to main content
ARS Home » Northeast Area » Beltsville, Maryland (BARC) » Beltsville Agricultural Research Center » Adaptive Cropping Systems Laboratory » Docs » Models » 2DSoil Model

2DSoil Model
headline bar

2DSoil model is a 2 dimensional finite element simulator of soil processes including heat, water, solute and roots.  It is used on all the ACSL models and recent modifications include:


Soil surface water flow as runoff has been recognized as an important component in agricultural water management. Surface flow has the potential to carry extra fertilizer to nearby water bodies, can be a critical factor for soil erosion, and affects the water balance. 

A new 2DSoil module was developed for soil surface water flow with the following three components:

  • Movement of water along the soil surface
  • Accumulation of water in depressions
  • Water fluxes across the soil-water interface, i.e., the infiltration.

The advantages of the new soil surface water module are:

  • Heavyside function and its derivative, Dirac delta function, are used to present the water boundary conditions on soil surface
  • Overland flow was simulated using a kinetic wave approximation.

Root Growth

maize root density distribution and associated soil water content  Knowledge of root density and its spatial distribution can enhance our understanding of plant adaption to the soil environment and the impacts of agricultural management. A new method in 2DSoil was developed to simulate the root system of a corn plant. A diffusive root growth model is applied to represent corn root distributions. Soil water content, temperature, soil density and aeration are considered as the ambient factors for root growth. The program can estimate the effects of water and nutrients on root growth and crop yield. 


Knowledge of the impacts on residue mulch and surface runoff on surface soil is important for agricultural field management. We developed a new method to simulate the moisture and thermal regimes on soil surface with residue mulch and/or surface runoff using a computer program. The computer program can also present the surface runoff and residue decomposition. The program can estimate the nitrogen and carbon (organic matter) exchanges between residue mulch and surface soil. This information will be useful to scientists, agricultural managers and consultants. Corn plantation with mulch

 Soil Vapor

 Water content and temperature distribution on soil.

In soil, water can evaporate in warm regions, move to colder zones in vapor phase, and then condense. Such a process can be a predominant component of soil water transfer when the soil is relatively dry. A new vapor transfer is developed in 2DSOIL to compensate the vapor effects on soil water and heat dynamics. With this update, liquid water, water vapor and heat transfer in 2DSOIL are coded into three separate modules, which enables a flexible control on each transfer component. This research is useful to soil scientists, hydrologists, agronomists, and agricultural managers interested in quantifying evaporation, plant water uptake and drainage of water input into soil as irrigation or rainfall.

Source Code
The source code for 2DSoil integrated with a corn model (MAIZSIM) can be found at GitHub.
Documentation for 2DSOIL is here


  1. Wang, Z., D. Timlin, M. Kouznetsov, D. Fleisher, S. Li, K. Tully and V. R. Reddy. 2020. Coupled model of surface runoff and surface-subsurface water movement. Adv. Water Resour.
  2. Wang, Z., D. Timlin, S. Li, D. Fleisher, A. Dathe, C. Luo, L. Dong, V. R. Reddy and K. Tully. 2021. Numerical simulations of maize root growth in MAIZSIM based on the spatially continuous model. Agric. Water Manage.
  3. Wang, Z., R. Thapa, D. Timlin, S. Li, W. Sun, S. Beegum, D. Fleisher, S. Mirsky, M. Cabrera, V.R. Reddy, T. Sauer, R. Horton and K. Tully. 2021. Simulations of moisture and thermal dynamics on soil Surface with Residue Mulch and Surface Runoff. Water Resour. Res.
  4. Wang, Z., D. Timlin, D. Fleisher, W. Sun, S. Beegum, S. Li, Y. Chen, V. R. Reddy, K. Tully and R. Horton. 2022. Modeling vapor transfer in soil water and heat simulations: a modularized, partially-coupled approach. J. Hydrol.