Soil Water

1 The APSIM SoilWater Model

The SoilWater module is a cascading water balance model that owes much to its precursors in CERES (Jones and Kiniry, 1986) and PERFECT(Littleboy et al, 1992). The algorithms for redistribution of water throughout the soil profile have been inherited from the CERES family of models.

The water characteristics of the soil are specified in terms of the lower limit (ll15), drained upper limit(dul) and saturated(sat) volumetric water contents. Water movement is described using separate algorithms for saturated or unsaturated flow. It is notable that redistribution of solutes, such as nitrate and urea N, is carried out in this module.

Modifications adopted from PERFECT include:

  • the effects of surface residues and crop cover on modifying runoff and reducing potential soil evaporation,
  • small rainfall events are lost as first stage evaporation rather than by the slower process of second stage evaporation, and
  • specification of the second stage evaporation coefficient(cona) as an input parameter, providing more flexibility for describing differences in long term soil drying due to soil texture and environmental effects.

The module is interfaced with SurfaceOrganicMatter and crop modules so that simulation of the soil water balance responds to change in the status of surface residues and crop cover(via tillage, decomposition and crop growth).

Enhancements beyond CERES and PERFECT include:

  • the specification of swcon for each layer, being the proportion of soil water above dul that drains in one day
  • isolation from the code of the coefficients determining diffusivity as a function of soil water (used in calculating unsaturated flow).Choice of diffusivity coefficients more appropriate for soil type have been found to improve model performance.
  • unsaturated flow is permitted to move water between adjacent soil layers until some nominated gradient in soil water content is achieved, thereby accounting for the effect of gravity on the fully drained soil water profile.

SoilWater is called by APSIM on a daily basis, and typical of such models, the various processes are calculated consecutively. This contrasts with models such as SWIM that solve simultaneously a set of differential equations that describe the flow processes.

2 Evaporation

Experiment Name Design (Number of Treatments)
ABlock_Residues Cover (4)

This experiment was conducted in Plant and Food Researches A Block field near Lincoln, New Zealand. A uniformly managed, unirrigated barley crop was grown and harvested prior to the estastablishment of this experiment. A randomised complete block was layed out with 5 x 15 m plots laid out to avoid harvester wheel tracks with 4 replicates of 4 treatments:

  • StandingStubble where the stubble that was left by the combine harvester remained standing and any residue that
  • HarvesterWindrow where the residue mown from the other two treatments was piled ontop of the standing stubble to simulate a harvester windrow with the residue from approximately 2 times the area applied
  • MownStubble where stubble was mown at 5cm height and removed from the plots
  • BareSoil where stubble was mown and removed and then plots were ploughed and cultivated to leave a bare soil.

Following the establishment of treatments CS616 soil moisture sensors were installed in each plot at 0-20, 20-40 and 40-60 cm depth and logged at 1 hourly intervals from establishment in Autumn through until the following spring.

2.1 Wellcamp

This dataset was developed as part of work by Huth et al., 2008. Evaporation from a Black Vertosol over a period of 6 months was measured using a Neutron Moisture Meter at Wellcamp, near Toowoomba in Queensland, Australia. Rainfall was excluded from the soil. Drainage was unlikely during the study period and so all changes in water content should be due to evaporation alone.

Experiment Name Design (Number of Treatments)
WellCamp Surface (1)

2.2 TorStreet

Evaporation from a Grey Vertosol over a period of 7 months was measured using weighing lysimeters in Toowoomba, Queensland, Australia.

Experiment Name Design (Number of Treatments)
TorStreet Surface (2)

2.3 Norwin

This dataset was developed as part of work by Huth et al., 2008. Evaporation from a Black Vertosol over a period of 6 months was measured using a Neutron Moisture Meter at Wellcamp, near Toowoomba in Queensland, Australia. Rainfall was excluded from the soil. Drainage was unlikely during the study period and so all changes in water content should be due to evaporation alone.

Experiment Name Design (Number of Treatments)
Norwin Surface (1)

2.4 Gatton

Evaporation from a Grey Vertosol over a period of 7 months was measured using weighing lysimeters in Toowoomba, Queensland, Australia.

Experiment Name Design (Number of Treatments)
Gatton Surface (3)

2.5 BondAndWillis

This dataset reproduces the evaporation experiment by Bond et al., 1970 in which microlysimeters were used to measure evaporation under varying residue levels and evaporative demands within controled environments. Note that evaporation parameters may be higher than under natural systems as evaporative conditions were maintained for 24 hours per day. The soil type was a fine sandy loam and the residue was clean bright wheat straw cut into 1.3 cm lengths.

Experiment Name Design (Number of Treatments)
BondAndWillis Residue (7)

3 Drainage

3.1 Libardi

Data used here were collected during an internal drainage experimentLibardi et al., 2001, carried out on a sandy–loam Red Yellow Latosol (Typic Hapludox) near Piracicaba, SP, Brazil. The soil had a fairly homogeneous profile down to the depth of 2 m. Soil water content values were calculated from tensiometer readings, through the use of laboratory established soil water retention curves and of soil water potential heads, measured with the same mercury manometer tensiometers.

Experiment Name Design (Number of Treatments)
Libardi Surface (1)

4 WaterExtraction

Experiment Name Design (Number of Treatments)
Lincoln2015 Nit x Irr (6)
LandP Irrigation x CoverType (8)

Lincoln2015 (Rain-Shelter Trail)

This dataset demonstrates the impact of three N (0, 50 and 250 kg/ha N) and two water regimes (dryland and fully irrigated) using a rain-shelter structure at Lincoln, New Zealand. A crop of 'Discovery' wheat was sown in October and managed as a typical spring wheat crop. Soil water content was measured with CS650 soil moisture probes positioned at 7 depths in each plot (192 probes in total) and logged at 15 min intervals for the duration of the experiment. Total cover was measured using linear PAR sensors in each plot logged for the duration of the experiment and green cover was measured ever 3-4 days with NDVI and interpolated to daily values. Slurp is used to represent the crop in this test so it can focus on soil water and not be blured by the performance of the crop model. To do this observed values for green and total cover, LAI, and Height were set in Slurp each day using a manager script.

This experiment was run over 3 years in Lincoln, New Zealand on a shallow stony soil. Treatments of Lucerne and Pasture (Ryegrass) were established in the Autumn of 2011 and irrigtion treatments were installed in the spring of 2011 and applied for three years. Treatments were:

  • None where no irrigation was applied
  • TwoPerWeek where irrigation was applied twice per week during spring/summer/autumn to replace water use measured by neutron probe
  • OnePerWeek where the same amout of irrigation was applied as the above treatment but at weekly frequency (i.e fewer, larger irrigations)
  • ThreeWeekly where the same amount of irrigation was applied as abouve but at a 3 weekely frequency (i.e fewer, larger irrigations)

Lucerne and pasture were defoliated at differing frequiencies following best mananagment practice resulting in 8-10 regrowth period per year for pasture and 5-6 for lucerne. Neutron probes were installed to 1.6 m depth using a 20T digger with a pnumatic plate on its boom to drive and extract a pilot rod into the stony sub soil and then an aluminum access tube was installed into the resultant hole. Neutron probes measurements were tatken at 7 - 10 day intervals during the irrigation season. CS616 probes were also installed in the top soil at 0-15 and 15-30 cm depths in each plot and logged hourly. Slurp is used to represent the crop in this test so it can focus on soil water and not be blured by the performance of the crop model. To do this observed values for green cover, LAI, and Height were set in Slurp each day using a manager script.

5 SensibilityTests

Experiment Name Design (Number of Treatments)
ResidueEvaporationTest Residue (6)

6 Interface

6.1 SoilWater

Parameters (Inputs)

Name Description Units Type Value
X double
Y double
FixedValue double
Units String
tillageCnCumWater double
tillageCnRed double

Properties (Outputs)

Name Description Units Type Settable?
Structure IStructure True
SummerDate dd-mmm String True
SummerU mm double True
SummerCona double True
WinterDate dd-mmm String True
WinterU mm double True
WinterCona double True
DiffusConst mm2/day double True
DiffusSlope /mm double True
Salb double True
CN2Bare double True
CNRed double True
CNCov double True
DischargeWidth m double True
CatchmentArea m2 double True
PSIDul cm double True
Depth Models.Core.SummaryAttribute mm String True
Thickness double True
Water double True
SW double True
PSI cm double False
K cm/h double True
PoreInteractionIndex - double True
Runon double True
PotentialInfiltration double True
LateralFlow double False
LateralOutflow double False
Runoff double True
Infiltration double True
Drainage double False
SubsurfaceDrain double False
Evaporation double False
WaterTable double True
Flux double True
Flow double True
PotentialRunoff double False
Properties Soil False
SWmm double False
ESW double False
Eos double False
Es double False
T double False
Eo double True
SWCON Models.Core.SummaryAttributeBetween (SAT and DUL) soil water conductivity constant for each soil layer.At thicknesses specified in "SoilWater" node of GUI.Use Soil.SWCON for SWCON in standard thickness /d double True
KLAT Models.Core.SummaryAttributeLateral flow soil water conductivity constant for each soil layer.At thicknesses specified in "SoilWater" node of GUI.Use Soil.KLAT for KLAT in standard thickness mm/d double True
LeachNO3 double False
LeachNH4 double False
LeachUrea double False
LeachCl double False
PrecipitationInterception double True
Pond double False
PAW mm/mm double False
PAWmm mm double False

Links (Dependencies)

Name Type IsOptional?
soil Soil False
soilPhysical IPhysical False
water Water False
summary ISummary False
lateralFlowModel LateralFlowModel False
runoffModel RunoffModel False
saturatedFlow SaturatedFlowModel False
unsaturatedFlow UnsaturatedFlowModel False
evaporationModel EvaporationModel False
waterTableModel WaterTableModel False

Methods (callable from manager)

Name Description
RemoveWater void RemoveWater(double amountToRemove)Remove water from the profile
SetWaterTable void SetWaterTable(double InitialDepth)Sets the water table.
Reset void Reset()
Tillage void Tillage(TillageType Data)Perform tillage
Tillage void Tillage(String tillageType)Perform tillage
SetPhysical void SetPhysical(Physical physical)Set the physical node.I'm not sure why this is necessary

7 References

Bond, JJ, Willis, WO, 1970. Soil Water Evaporation: First Stage Drying as Influenced by Surface Residue and Evaporation Potential. Soil Science Society of America Proceedings 34, 924-928.

Huth, N. I., Carberry, P. S., Cocks, B., Graham, S., McGinness, H. M., O'Connell, D. A., 2008. Managing drought risk in eucalypt seedling establishment: An analysis using experiment and model. Forest Ecology and Management 255 (8-9), 3307-3317.

Libardi, PL, Reichardt, Klaus, 2001. Libardi's method refinement for soil hydraulic conductivity measurement. Australian Journal of Soil Research 39, 851-860.