PotentialEvapotranspiredWaterVolume

The second step of the Seasonal Water Yield workflow: the potential evapotranspiration of each month, the crop coefficient of the land use of each cell times the reference evapotranspiration.

The reference evapotranspiration of the sample data is given as maps. Where only temperatures and precipitation are available, the module calculates it with the modified Hargreaves equation, from the maximum, minimum and mean temperature, the extraterrestrial radiation and the precipitation of the month, with pDaysInTimestep the days of the month (30 if not set).

Details

The potential evapotranspiration of each cell is its crop coefficient (Kc) times the reference evapotranspiration. The reference evapotranspiration can be given as a map, or calculated with the modified Hargreaves equation of Droogers and Allen (2002), as suggested by InVEST when only temperatures and precipitation are available:

ET0 = 0.0013 · 0.408 · RA · (Tavg + 17) · (Tmax - Tmin - 0.0123 · P)^0.76 · days

with RA the mean daily extraterrestrial radiation in MJ/m2/day (0.408 converts it to mm of water), the mean daily temperatures in °C, P the precipitation of the timestep in mm and days the days of the timestep. In wet timesteps with a small temperature range, where the precipitation term exceeds the range, the reference evapotranspiration is 0.

Parameters

The potential evapotranspiration of a crop or land cover, as crop coefficient times the reference evapotranspiration, given or calculated with the modified Hargreaves equation (as in InVEST).

Toolbox folder: Hydro-Geomorphology
Status: Experimental
Keywords: potential, evapotranspiration
Authors: The klab team.
Class: org.hortonmachine.modules.PotentialEvapotranspiredWaterVolume

Inputs

Parameter

Type

Unit

Default

Description

inCropCoefficient

raster file

The map of the crop coefficient (Kc).

inMaxTemp

raster file

°C

The map of the mean daily maximum temperature of the timestep, for the Hargreaves equation.

inMinTemp

raster file

°C

The map of the mean daily minimum temperature of the timestep, for the Hargreaves equation.

inAtmosphericTemp

raster file

°C

The map of the mean daily temperature of the timestep, for the Hargreaves equation.

inSolarRadiation

raster file

MJ/m2/day

The map of the mean daily extraterrestrial radiation of the timestep, for the Hargreaves equation.

inRainfall

raster file

mm

The map of the precipitation of the timestep, for the Hargreaves equation.

inReferenceEtp

raster file

mm

The map of the reference evapotranspiration of the timestep (if set, only the crop coefficient is needed).

pDaysInTimestep

Double

The days of the timestep, used with the Hargreaves equation (if not set, 30, for a month).

Outputs

Parameter

Type

Unit

Description

outputPet

output file

mm

The potential evapotranspiration of the timestep.

References

  • Droogers, P., Allen, R. G. (2002). Estimating reference evapotranspiration under inaccurate data conditions. Irrigation and Drainage Systems, 16(1), 33-45.

  • Natural Capital Project. InVEST User’s Guide, Seasonal Water Yield. Stanford University, University of Minnesota, Chinese Academy of Sciences, The Nature Conservancy, World Wildlife Fund, Stockholm Resilience Centre and the Royal Swedish Academy of Sciences. https://releases.naturalcapitalproject.org/invest-userguide/latest/

Example

import org.hortonmachine.modules.PotentialEvapotranspiredWaterVolume

// the folder with the gura folder of the sample data: change it to yours
var folder = "/data/"
var monthly = folder + "gura/monthly/"

// the potential evapotranspiration of each month: crop coefficient times reference evapotranspiration
for (month in 1..12) {
    var pet = new PotentialEvapotranspiredWaterVolume()
    pet.inCropCoefficient = monthly + "kc_" + month + ".tif"
    pet.inReferenceEtp = monthly + "et0_" + month + ".tif"
    pet.outputPet = monthly + "pet_" + month + ".tif"
    pet.process()
}
The potential evapotranspiration of January, in mm.

The potential evapotranspiration of January, in mm: the lines and patches of lower values are the roads and the urban areas, with a crop coefficient of 0.4.

The values

The potential evapotranspiration is a depth of water in the month, in mm: what the cell would evapotranspire with all the water it needs. The actual evapotranspiration of SWYRechargeRouting is at most this much, and less where the water is not enough.

On the sample data it goes from about 23 to 148 mm in a month, around 1200 mm in the year:

  • the reference evapotranspiration is between 65 and 140 mm in a month, the lowest in the cloudy months of the long rains, April and May, and the highest in the dry, sunny months from January to March. In the year it goes from about 1350 mm in the lower east of the basin to 1090 mm on the highest cells. It comes from the modified Hargreaves method; at the Nyeri station the Penman-Monteith method gives about 1490 mm in the year (see how the values compare with measures);

  • the crop coefficients of the sample are between 0.3 and 1.15. Those of the forest (1.0), the tea (0.95) and the coffee (1.05) are near the values of FAO for the same covers (Allen et al., 1998): 1.0 for large forests of conifers, 1.0 for tea without shade and 1.15 with shade, 0.95 for coffee on bare ground and 1.1 with weeds. The coefficient of the general agriculture changes in the year, from 0.3 when the fields are bare to 1.15 in July and August. The urban areas and the roads have 0.4.

Where the land use is novalue, the potential evapotranspiration is novalue too.

References

  • Allen, R. G., Pereira, L. S., Raes, D., Smith, M. (1998). Crop evapotranspiration: guidelines for computing crop water requirements. FAO Irrigation and Drainage Paper 56, Table 12. https://www.fao.org/4/x0490e/x0490e0b.htm