15. Basin average

This file is used to write variables computed by the FeST model averaged over a list of river basins defined by outlet section. The file contains a list of keywords, one for each variable the user can export. The optional keyword raster-export set to 1 enables the FeST model to write basin mask in esri-ascii format (see example below).

Example of basin-average configuration file

raster-export = 1  # OPTIONAL default = 0
raster-export-folder = ./results/basin_mask/  # OPTIONAL

#meteo
precipitation = 1
daily-precipitation = 0
temperature = 1
temperature-daily-mean = 0
temperature-daily-max = 0
temperature-daily-min = 0
relative-humidity = 0
solar-radiation = 0
net-radiation = 0
wind-speed = 1
irrigation = 0

#snow
snow-water-equivalent = 1

#soil balance
soil-moisture = 1
delta-soil-moisture = 1
runoff = 1
infiltration = 1
percolation = 1
actual-ET = 1
potential-ET = 0

The optional keyword raster-export-folder defines the folder where to save basin mask files. When raster-export-folder is not set, basin mask files are saved in the current folder where the FeST executable is launched. Basin mask files are saved with name basin_mask_id_<basin-id>.asc where <basin-id> is the id label of river basin set in the coordinate list file.

The average value is computed for all variables marked with 1. When one variable is marked by 1 but it is not allocated because not computed by the FeST model according to options defined in the configuration files, value is not exported. For example, if user set to export wind-speed but windspeed is not used in the current simulation, values of windspeed are not written in the output file. One output file is created for each variable. So average temperature values for all points are written in a file, precipitation values are written in a different file, and so on.

Variables that can be exported, description, and unit are listed in the following table.

Table 15.1 Basin average variable description and unit

variable	Description	Unit
precipitation	Precipitation fallen in the current time step	mm
daily-precipitation	Precipitation fallen in 24 hours	mm
temperature	Air temperature of the current time step fallen in 24 hours	Celsius degree
temperature-daily-mean	Mean daily air temperature	Celsius degree
temperature-daily-max	Maximum daily air temperature	Celsius degree
temperature-daily-min	Maximum daily air temperature	Celsius degree
relative-humidity	Air relative humidity of the current time step	% (0-100)
solar-radiation	Solar radiation of the current time step	w/m²
net-radiation	Net radiation of the current time step	w/m²
wind-speed	Wind speed of the current time step	m/s
irrigation	Irrigation amount of the current time step	mm
snow-water-equivalent	Snow water equivalent of the current time step	mm
soil-moisture	Soil moisture of the current time step	-
runoff	Runoff of the current time step	mm
infiltration	Infiltration into soil of the current time step	mm
percolation	Deep percolation out of transmission zone of the current time step	mm
actual-ET	Actual evapotranspiration of the current time step	mm
potential-ET	Potential evapotranspiration of the current time step	mm
delta-soil-moisture	Change in soil water storage of the current time step	mm

The name of output files is the concatenation of result folder name defined in the main configuration file <folder>, and a suffix that reminds the name of variable, as listed in the following table.

Table 15.2 Basin average file name written by FeST

variable	Output file name
precipitation	<folder> mean_precipitation.fts
daily-precipitation	<folder> mean_pdaily.fts
temperature	<folder> mean_temperature.fts
temperature-daily-mean	<folder> mean_tmean.fts
temperature-daily-max	<folder> mean_tmax.fts
temperature-daily-min	<folder> mean_tmin.fts
relative-humidity	<folder> mean_rh.fts
solar-radiation	<folder> mean_rad.fts
net-radiation	<folder> mean_netrad.fts
wind-speed	<folder> mean_windspeed.fts
irrigation	<folder> mean_irrigation.fts
snow-water-equivalent	<folder> mean_swe.fts
soil-moisture	<folder> mean_soil-moisture.fts
runoff	<folder> mean_runoff.fts
infiltration	<folder> mean_infiltration.fts
percolation	<folder> mean_percolation.fts
actual-ET	<folder> mean_et.fts
potential-ET	<folder> mean_pet.fts
delta-soil-moisture	<folder> mean_delta-soil-moisture.fts