SAGA-GIS Tool Library Documentation (v9.2.0)

Tool Soil Water Capacity (Grid Collections)

This tool derives the soil water capacity for the given soil moisture potentials (psi) based on pedo-transfer functions.
Suggested psi values for field capacity estimation range between 60 hPa (pF=1.8) and 316 hPa (pF=2.5). For permanent wilting point estimation take a psi value of about 15850 hPa (pF=4.2). This tool re-implements the R-script AWCPTF by Hengl as well as the regression approach by Toth et al. (2015). See Hengl et al. (2017), Woesten & Verzandvoort (2013) and Toth et al. (2015) for more details.


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputSandgrid collection, inputSAND[%]-
Siltgrid collection, inputSILT[%]-
Claygrid collection, inputCLAY[%]-
Soil Organic Carbongrid collection, inputCORG[permille]-
Bulk Densitygrid collection, inputBULK[kg/m³]-
Cation Exchange Capacitygrid collection, inputCEC[cmol/kg]-
pHgrid collection, inputPH--
OutputField Capacitygrid collection, outputFC--
Permanent Wilting Pointgrid collection, outputPWP--
Water Capacity at Saturation (*)grid collection, output, optionalTHETA_S--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Output UnitchoiceUNIT-Available Choices:
[0] cubic-meter per cubic-meter
[1] percentage of volume
Default: 1
Pedo-Transfer FunctionchoiceFUNCTION-Available Choices:
[0] Hodnett & Tomasella 2002
[1] Toth et al. 2015
Default: 0
Soil Moisture Potentialfloating point numberPSI_FC[hPa]Minimum: 0.000000
Default: 316.000000
Soil Moisture Potentialfloating point numberPSI_PWP[hPa]Minimum: 0.000000
Default: 15850.000000
AdjustmentsbooleanADJUSTSpecifies whether to correct values of textures and bulk density to avoid creating nonsensical values.Default: 1
User Defined CoefficientsbooleanUSERDEF-Default: 0
User Defined Coefficientsstatic tableCOEFFICIENTS-4 Fields:
- 1. [8 byte floating point number] ln(alpha)
- 2. [8 byte floating point number] ln(n)
- 3. [8 byte floating point number] theta s
- 4. [8 byte floating point number] theta r
(*) optional

Command-line

Usage: saga_cmd grid_analysis 28 [-SAND <str>] [-SILT <str>] [-CLAY <str>] [-CORG <str>] [-BULK <str>] [-CEC <str>] [-PH <str>] [-FC <str>] [-PWP <str>] [-THETA_S <str>] [-UNIT <str>] [-FUNCTION <str>] [-PSI_FC <double>] [-PSI_PWP <double>] [-ADJUST <str>] [-USERDEF <str>] [-COEFFICIENTS <str>]
  -SAND:<str>        	Sand
	grid collection, input
  -SILT:<str>        	Silt
	grid collection, input
  -CLAY:<str>        	Clay
	grid collection, input
  -CORG:<str>        	Soil Organic Carbon
	grid collection, input
  -BULK:<str>        	Bulk Density
	grid collection, input
  -CEC:<str>         	Cation Exchange Capacity
	grid collection, input
  -PH:<str>          	pH
	grid collection, input
  -FC:<str>          	Field Capacity
	grid collection, output
  -PWP:<str>         	Permanent Wilting Point
	grid collection, output
  -THETA_S:<str>     	Water Capacity at Saturation
	grid collection, output, optional
  -UNIT:<str>        	Output Unit
	choice
	Available Choices:
	[0] cubic-meter per cubic-meter
	[1] percentage of volume
	Default: 1
  -FUNCTION:<str>    	Pedo-Transfer Function
	choice
	Available Choices:
	[0] Hodnett & Tomasella 2002
	[1] Toth et al. 2015
	Default: 0
  -PSI_FC:<double>   	Soil Moisture Potential
	floating point number
	Minimum: 0.000000
	Default: 316.000000
  -PSI_PWP:<double>  	Soil Moisture Potential
	floating point number
	Minimum: 0.000000
	Default: 15850.000000
  -ADJUST:<str>      	Adjustments
	boolean
	Default: 1
  -USERDEF:<str>     	User Defined Coefficients
	boolean
	Default: 0
  -COEFFICIENTS:<str>	User Defined Coefficients
	static table
	4 Fields:
	- 1. [8 byte floating point number] ln(alpha)
	- 2. [8 byte floating point number] ln(n)
	- 3. [8 byte floating point number] theta s
	- 4. [8 byte floating point number] theta r