SAGA 9.4.2 | Tool Library Documentation

Soil Water Capacity


Description

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, input, optionalSAND[%]-
Siltgrid, input, optionalSILT[%]-
Claygrid, input, optionalCLAY[%]-
Soil Organic Carbongrid, input, optionalCORG[permille]-
Bulk Densitygrid, input, optionalBULK[kg/m_]-
Cation Exchange Capacitygrid, input, optionalCEC[cmol/kg]-
pHgrid, input, optionalPH--
OutputField Capacitygrid, outputFC--
Permanent Wilting Pointgrid, outputPWP--
Water Capacity at Saturationgrid, output, optionalTHETA_S--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Defaultfloating point numberSAND_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Maximum: 100.000000 Default: 15.000000
Defaultfloating point numberSILT_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Maximum: 100.000000 Default: 37.000000
Defaultfloating point numberCLAY_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Maximum: 100.000000 Default: 48.000000
Defaultfloating point numberCORG_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Maximum: 1000.000000 Default: 15.000000
Defaultfloating point numberBULK_DEFAULTdefault value if no grid has been selectedMinimum: 100.000000 Maximum: 2650.000000 Default: 1350.000000
Defaultfloating point numberCEC_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Default: 45.000000
Defaultfloating point numberPH_DEFAULTdefault value if no grid has been selectedMinimum: 0.000000 Maximum: 14.000000 Default: 6.400000
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

Command Line


Usage: saga_cmd grid_analysis 27 [-SAND ] [-SAND_DEFAULT ] [-SILT ] [-SILT_DEFAULT ] [-CLAY ] [-CLAY_DEFAULT ] [-CORG ] [-CORG_DEFAULT ] [-BULK ] [-BULK_DEFAULT ] [-CEC ] [-CEC_DEFAULT ] [-PH ] [-PH_DEFAULT ] [-FC ] [-PWP ] [-THETA_S ] [-UNIT ] [-FUNCTION ] [-PSI_FC ] [-PSI_PWP ] [-ADJUST ] [-USERDEF ] [-COEFFICIENTS ]
  -SAND:           	Sand
	grid, input, optional
  -SAND_DEFAULT:	Default
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 15.000000
  -SILT:           	Silt
	grid, input, optional
  -SILT_DEFAULT:	Default
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 37.000000
  -CLAY:           	Clay
	grid, input, optional
  -CLAY_DEFAULT:	Default
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 48.000000
  -CORG:           	Soil Organic Carbon
	grid, input, optional
  -CORG_DEFAULT:	Default
	floating point number
	Minimum: 0.000000
	Maximum: 1000.000000
	Default: 15.000000
  -BULK:           	Bulk Density
	grid, input, optional
  -BULK_DEFAULT:	Default
	floating point number
	Minimum: 100.000000
	Maximum: 2650.000000
	Default: 1350.000000
  -CEC:            	Cation Exchange Capacity
	grid, input, optional
  -CEC_DEFAULT: 	Default
	floating point number
	Minimum: 0.000000
	Default: 45.000000
  -PH:             	pH
	grid, input, optional
  -PH_DEFAULT:  	Default
	floating point number
	Minimum: 0.000000
	Maximum: 14.000000
	Default: 6.400000
  -FC:             	Field Capacity
	grid, output
  -PWP:            	Permanent Wilting Point
	grid, output
  -THETA_S:        	Water Capacity at Saturation
	grid, output, optional
  -UNIT:           	Output Unit
	choice
	Available Choices:
	[0] cubic-meter per cubic-meter
	[1] percentage of volume
	Default: 1
  -FUNCTION:       	Pedo-Transfer Function
	choice
	Available Choices:
	[0] Hodnett & Tomasella 2002
	[1] Toth et al. 2015
	Default: 0
  -PSI_FC:      	Soil Moisture Potential
	floating point number
	Minimum: 0.000000
	Default: 316.000000
  -PSI_PWP:     	Soil Moisture Potential
	floating point number
	Minimum: 0.000000
	Default: 15850.000000
  -ADJUST:         	Adjustments
	boolean
	Default: 1
  -USERDEF:        	User Defined Coefficients
	boolean
	Default: 0
  -COEFFICIENTS:   	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