The APSIM SoilN Module

 

Description

The SoilN module describes the dynamics of both carbon and nitrogen in soil. The transformations considered in each layer are shown diagramatically in Figure 1. The major difference from the CERES model is that the soil organic matter is divided into two pools ( biom and hum ), the biom pool notionally representing the more labile, soil microbial biomass and microbial products, whilst hum comprises the rest of the soil organic matter. The flows between the different pools are calculated in terms of carbon, the corresponding nitrogen flows depending on the C:N ratio of the receiving pool. The C:N ratios of the various pools are assumed to be constant through time; C:N for biom is specified in the ini file, whilst the C:N of hum is derived from the C:N ratio of the soil which is an input.

 

 

Figure 1. Diagram of transformations occuring in each soil layer

 

Decomposition of biom and hum pools are calculated as first-order processes with the rate constants being modified by factors involving soil temperature and moisture in the layer. The fresh organic matter pool ( fom) is treated as in CERES-Maize (Jones and Kiniry, 1986), and its rate of decomposition also depends on a C:N ratio factor. Mineralisation or immobilisation of mineral-N is determined as the balance between the release of nitrogen during decomposition and immobilisation during microbial synthesis and humification. An inadequate supply of mineral-N to satisfy the immobilisation demand results in a slowing of the decomposition. Both ammonium- and nitrate-N are available for immmobilisation, though ammonium-N is used preferentially. Decomposition of any organic matter pool results in evolution of carbon dioxide to the atmosphere and transfers of carbon to the biom and hum pools. The flows are defined in terms of efficiency coefficients, representing the proportion of carbon retained in the system, and the fraction of the retained carbon that is synthesised into the biom pool (see Table 1 for parameter definitions and values). When biom decomposes there is an internal cycling of carbon (microbes feeding on microbial products).

At initialisation, the amounts of hum and biom in each layer are calculated from inputs (oc, finert, fbiom). To allow for slower rates of decomposition of soil organic matter in the deeper soil layers, part of the hum pool is considered to be non-susceptible to decomposition; this is specified as finert, which typically will increase with depth. Fbiom specifies the biom pool carbon as a fraction of the hum carbon that is subject to decomposition, i.e. fbiom = biom /(hum - inert_c)

 

Table 1. Model parameters determining the flows of carbon during the decomposition of the soil organic matter pools and surface residues

Parameter

Value

Definition

mcn

8.0

C:N ratio of biom pool

ef_fom

0.4

efficiency of carbon retention when fom decomposes

fr_fom_biom

0.9

proportion of retained carbon from fom synthesised into biom

ef_biom

0.4

efficiency of carbon retention when biom decomposes

fr_biom_biom

0.6

proportion of retained carbon from biom resynthesised into biom

ef_hum

0.4

efficiency of carbon retention when hum decomposes

ef_res

0.4

efficiency of carbon retention when residues decompose

fr_res_biom

0.9

proportion of retained carbon from residues synthesised into biom

rd_carb

0.2 day -1

maximum decomposition rate for carbohydrate-like C in fom .

rd_cell

0.05 day -1

maximum decomposition rate for cellulose-like C in fom

rd_lign

0.0095 day -1

maximum decomposition rate for lignin-like C in fom

rdbiom

0.0081 day -1

maximum decomposition rate for biom

rdhum

0.00015 day -1

maximum decomposition rate for hum

 

Decomposition of Soil Organic Matter Pools

 

fom decomposition = Fpool (carbohydrate,cellulose or lignin fraction)

X decay rate for a given fraction (rd_carb, rd_cell, rd_lign)

X Soil water factor

X Soil temperature factor

X C:N ratio factor

 

biom decomposition = biom

X rd_biom

X Soil water factor

X Soil temperature factor

 

hum decomposition = ( hum - inert_C)

X rd_hum

X Soil water factor

X Soil temperature factor

 

 

The factors affecting the individual decay rates are as follows:

 

(i) Soil Water.

Figure 2. Water factor affecting mineralisation rates of the various soil organic matter pools.

 

 

(ii) Soil Temperature

Figure 3. Temperature factor affecting mineralisation rates of the various soil organic matter pools.

 

 

•  C:N ratio

Figure 4. C:N ratio factor affecting mineralisation rate of soil FOM pools is calculated using a modified C:N ratio that includes the mineral nitrogen in the soil layer.

 

CNR = fom_C / (fom_N + min_N)

 

Nitrification

Nitrification is assumed to follow Michaelis-Menton kinetics (See Godwin and Jones 1991, though there is error in their equation 14).

 

potential rate = nitrification_pot x NH4 ppm / (NH4 ppm + NH4_at_half_pot)

 

where nitrification_pot (mg N/kg soil/ day) and NH4_at_half_pot (ppm) are specified in the SOILN ini file. Actual daily nitrification is reduced to allow for sub-optimal water, temperature and pH conditions.

 

nitrification rate = potential rate x min (water factor, temperature factor, pH factor)

 

(Unlike CERES, there is no provision for the potential rate of nitrification to change with time to represent a changing microbial population)

 

 

(i) Soil Water

Figure 5. Water factor affecting the nitrification rate of ammonium in each soil layer.

 

 

(ii) Soil Temperature

Figure 6. Temperature factor affecting the nitrification rate of ammonium in each soil layer.

 

 

Figure 7. pH factor affecting the nitrification rate of ammonium in each soil layer.

 

Denitrification

The code comes from CERES-Maize V1 and has not been modified to allow for biom_c. Under most situations, simulated denitrification rates are small. The sensibleness of the simulations where significant amounts of denitrification occur has not been verified.

denitrification rate = 0.0006

                           x NO 3

                           x active carbon ppm

                           x water factor

                           x temperature facto

r

 

where active carbon ppm = 0.0031 x (hum_C ppm + FOM_C ppm ) + 24.5

 

(i) Soil Water

Figure 8. Water factor affecting the denitrification of nitrate in each soil layer.

 

 

(ii) Soil Temperature

Figure 9. Temperature factor affecting the denitrification of nitrate in each soil layer.

 

Urea hydrolysis

potential hydrolysis fraction = -1.12 + 1.31xOC + 0.203xpH - 0.155xOCxpH

 

This fraction is bound between 0 and 1. For OC=1% and pH=7 the fraction=0.526

 

 

hydrolysis rate = Urea x potential hydrolysis fraction x min (temperature factor, water factor)

 

(i) Soil Water

Figure 10. Water factor affecting the hydrolysis of urea in each soil layer.

 

 

(ii) Soil Temperature

Figure 11. Temperature factor affecting hydrolysis of urea in each soil layer.

 

Soil Temperature

Daily average soil temperature of each soil layer is calculated based on the soil temperature model of EPIC (Williams et al., 1984). A sinusoidal function of day of year is assumed, with subsurface temperature changes lagging behind those at the soil surface. The sinusoidal function is based on mean annual air temperature (tav), annual amplitude in mean monthly air temperature (amp) and latitude (included in met file). The actual surface temperature is calculated from maximum and minimum temperatures, solar radiation and soil albedo. Changes with depth are obtained from an exponential function of the ratio of depth and a temperature damping depth. This damping depth is a function of the average bulk density of the soil and the amount of water above the lower limit.

 

Parameter File Settings

 

Name

Units

Description

oc

%

organic carbon (%)

ph

 

soil pH

nh4

ppm

initial ammonium-N (mg/kg)

no3

ppm

initial nitrate-N (mg/kg)

finert

0-1 fraction

proportion of initial organic C assumed to be inert

fbiom

0-1 fraction

initial BIOM as proportion of non-inert C

amp

o C

temperature amplitude - difference between highest and lowest mean monthly air temperatures  (Optional - often supplied by Met module)

tav

o C

mean annual air temperature  (Optional - often supplied by Met module)

soil_cn

 

C:N ratio of the soil

root_wt *

kg/ha

initial weight of root FOM in soil profile

root_cnr

 

C:N ratio of initial root residues

 

* Note that the depth to which the initial roots are distributed (in mm) can be specified using an optional parameter called ‘root_depth'. If this parameter is not supplied, then it is assumed the initial ‘root_wt' is distributed exponentially throughout the whole profile.

 

SoilN module outputs

 

Name

Units

Description

no3

kg/ha

amount of NO3 in each layer

no3ppm

ppm

concentration of NO3 in each layer

no3_min

ppm

minimum amount of NO3 allowed in each layer

nh4

kg/ha

amount of NH4 in each layer

nh4ppm

ppm

concentration of NH4 in each layer

nh4_min

ppm

minimum amount of NH4 allowed in each layer

urea

kg/ha

amount of urea in each layer

fom_n

kg/ha

amount of N in FOM in each layer

hum_n

kg/ha

amount of humic N in each layer

biom_n

kg/ha

amount of biomass N in each layer

fom_c

kg/ha

amount of C in FOM in each layer

hum_c

kg/ha

amount of humic C in each layer

biom_c

kg/ha

amount of biomass C in each layer

carbon_tot

kg/ha

Total amount of C in each layer

nit_tot

kg/ha

Total amount of N in each layer

dlt_n_min

kg/ha

Today's net N mineralisation in each layer from soil organic matter pools

dlt_n_min_res

kg/ha

Today's net N mineralisation in each layer from surface residues

dlt_n_min_tot

kg/ha

Today's net N mineralisation in each layer from soil organic matter pools and surface residues.

dnit

kg/ha

Today's denitrification loss for each layer

dlt_c_loss_in_sed

kg/ha

Loss of C in sediment due to erosion

dlt_n_loss_in_sed

kg/ha

Loss of N in sediment due to erosion

 

SoilN module actions

 

Reset

The reset action can be invoked to reset the module to the state specified within the module's input data, which includes the soil's organic carbon components (biom and hum), nitrate, ammonium and urea N, and FOM (specified as root weight). The Reset action is identical to the initialise action used by the simulation engine at the start of the simulation except that a description of the reinitialised state is not printed in the simulation summary file. Where only mineral N concentrations need to be reinitialised the 'set' action is used (See below).

 

APSIM Manager Example:

 

[sample.manager.start_of_day]

 

! reinitialise soil nitrogen at the beginning of each sowing window

 

    If day = 100 then

        soiln2 reset

    endif

 

Initialise

The initialise action has been replaced by the reset action (see above).

 

Set

The set action is used to reinitialise single mineral N pools within the module (Nitrate, Ammonium or Urea). Only the particular mineral pools are reset.

 

APSIM Manager Example:

 

[sample.manager.start_of_day]

 

! reinitialise soil mineral nitrogen at given date

 

    If day = 100 then

        soiln2 set no3 = 10 5 1 (kg/ha)

        soiln2 set nh4 = 10 5 1 (kg/ha)

    endif

 

or in terms of concentration

 

[sample.manager.start_of_day]

 

    If day = 100 then

        soiln2 set no3ppm = 1.0 1.0 1.0 (ppm)

        soiln2 set nh4ppm = 1.0 1.0 1.0 (ppm)

    endif

 

Summary Report

At initialisation, at series of tables and useful information is printed to the simulation summary file for perusal by the user. These tables can be printed to the summary file at any point during the simulation as a detailed record of the system state at a particular time.

 

APSIM Manager Example:

 

[sample.manager.start_of_day]

 

! Print out a summary of module state to the summary file

 

    If day = 100 then

        soiln2 sum_report

    endif

 

Incorporate FOM

Fresh organic matter can be incorporated into the soil using the incorp_fom action. The amounts of FOM and FON are specified on a layered basis . An optional FOM type can be specified to use any preset fractionations of FOM as specified in the module ini file. A default fractionation is used if type is not specified. FON content can be specified as either an amount or a C:N ratio.

 

APSIM Manager Example:

 

NOTE: actions must be specified as a single line in the manager file rather than as shown below.

 

    If day = 100 then

        soiln2 incorp_fom dlt_fom_type = manure

            , dlt_fom_wt = 100 50 0 (kg/ha)

            , dlt_fom_n = 4 2 0 (kg/ha)

    endif

 

or assuming that FOM is 40% carbon we can use a C:N ratio.

 

    If day = 100 then

        soiln2 incorp_fom dlt_fom_type = manure

            , dlt_fom_wt = 100 50 0 (kg/ha)

            , dlt_fom_cnr = 10 10 0 (kg/ha)

    endif