Spatial average

13. Spatial average#

This file is used to write spatial average results of variables computed by the FEST model. The file contains a table of map that defines the spatial extent to compute the average and the keyword epsg that define the reference system of maps, as in the example below.

Example of table of spatial extents in spatial average configuration file

epsg = 32632

Table Start
Title: mask grids for output
Id: masks  
Columns:    [count]  [id]       [name]       [file]    
Units:       [-]     [-]         [-]           [-]
             1       01        lago      "./bacino_lago.asc"
             2       02     gavardo      "./gavardo.asc"
             3       03     mezzane      "./bacino_mezzane.asc"
             4       04       asola      "./bacino_asola.asc"
Table End

For every spatial extent, the average is computed and exported on file of the variables chosen by user in the configuration file. There are specific sections for Meteorological input, Soil balance, Snow, Glacier, Canopy interception, Plants, and Sediment erosion and transport variables, as in the examples below. The 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 in the meteorological section but wind speed is not used in the current simulation, values of wind speed are not written in the output file.

The name of output files is the concatenation of result folder name defined in the main configuration file <folder>, the name of the spatial extent <name>, and a suffix recalling the process related to the variables, as listed in the following table.

Table 13.1 spatial average file name written by FEST#

variables

Output file name

meteorological

<folder> <name> _meteo.out

soil balance

<folder> <name> _balance.out

snow

<folder> <name> _snow.out

glaciers

<folder> <name> _glaciers.out

sediment

<folder> <name> _sediment.out

canopy

<folder> <name> _canopy.out

plants

<folder> <name> _plants.out

13.1. Meteorological input#

Example of [meteo] variables marked for exporting spatial average on file.

[meteo]
  precipitation = 1          # gross precipitation (mm)
  daily-precipitation = 0    # daily precipitation(mm)
  temperature = 1            # air temperature(°C)
  temperature-daily-mean = 1 # mean daily temperature (°C)
  temperature-daily-max = 1  # maximum daily temperature (°C)
  temperature-daily-min = 1  # minimum daily temperature (°C)
  relative-humidity = 0      # air relative humidity (% [0-1])
  solar-radiation = 0        # shortwave radiation (w/m2)
  net-radiation = 0          # net radiation (w/m2)
  wind-speed = 0             # wind speed (m/s)
  irrigation = 0             # irrigation amount (mm)

13.2. Soil balance#

Example of [soil-balance] variables marked for exporting spatial average on file.

[soil-balance]
  soil-moisture = 1  # soil moisture(m3/m3)
  runoff = 1         # runoff(mm)
  infiltration = 1   # infiltration(mm)
  percolation = 1    # percolation(mm)
  actual-ET = 1      # actual evapotranspiration(mm)
  potential-ET = 1   # potential evapotranspiration(mm)
  capillary-rise = 0 # capillary flux(mm)
  error = 1          # balance error (mm)

13.3. Snow#

Example of [snow]variables marked for exporting spatial average on file.

[snow]
  rain = 1                  # liquid precipitation(mm)
  snow-water-equivalent = 1 # snow water equivalent(mm)
  melt-coefficient = 1      # snow melt coefficient (mm/day/°C)
  snow-covered-area = 1     # percentage of snow cover (0-1)
  water-in-snow = 1         # water in snowpack (mm)
  snow-melt = 1             # snow melt (mm)

13.4. Glacier#

Example of [glaciers] variables marked for exporting spatial average on file.

[glacier]
  ice-water-equivalent = 1 # snow water equivalent(mm)
  ice-covered-area = 1     # percentage of glacial cover (0-1)
  water-in-ice = 1         # water in glaciers (mm)
  ice-melt = 1             # ice melt (mm)

13.5. Sediment erosion and transport#

Example of [sediment] variables marked for exporting spatial average on file.

[sediment]
  detachment-rate = 0  # eroded sediment amount (kg)

13.6. Canopy interception#

Example of [canopy] variables marked for exporting spatial average on file.

[canopy]
  canopy-storage = 0   # canopy water storage (mm)
  throughfall = 0      # canopy throughfall (mm)
  transpiration = 0    # canopy transpiration (mm)

13.7. Plants#

Example of [plants] variables marked for exporting spatial average on file.

[plants]
  lai = 0        # leaf area index (m2/m2)
  gpp = 0        # gross primary production (t)
  npp = 0        # net primary production (t)
  stem = 0       # stem mass (t)
  root = 0       # root mass (t)
  leaf = 0       # leaf mass (t)
  cover = 0      # canopy cover (0-1)
  dbh = 0        # plant diameter at brest height (cm)
  height = 0     # plant heigth (m)
  density = 0    # plant density (tree/hectare)
  stem-yield = 0 # stem yield (t)
Contents