Configuration (main) file keywords¶
Path definitions¶
Keyword |
Type |
Description |
|---|---|---|
Maps_Folder |
System Path |
Path to folder with land surface information |
Clim_Maps_Folder |
System Path |
Path to folder with Climate information |
Output_Folder |
System Path |
Path to folder where outputs will be written |
Tracking¶
Keyword |
Type |
Description |
|---|---|---|
Tracking |
option |
Boolean switch to turn water tracking (isotopes and/or ages) on (1) or off (0) |
TrackingConfig |
System Path |
Location and name of the tracking configuration file |
Options¶
Keyword |
Description |
|---|---|
MapTypes |
Format of maps, in this version it is csf (PCRaster) |
Species_State_Variable_Input_Method |
Specifies the input format of the vegetation state variables. Options are table or maps |
Reinfiltration |
Boolean switch: reinfiltration during lateral routing on (1) or off (0) |
Channel |
Boolean switch: channel routing and specific processes on (1) or off (0) |
Channel_infiltration |
Boolean switch: channel bed infiltration on (1) or off (0) |
Lateral_Exit |
Boolean switch: lateral output (surface and subsurface) at the drainage outlet(s) (= 1, usual case) or not (= 0) |
Hydraulic_Conductivity_profile |
Switches between different ways to prescribe horizontal saturated hydraulic conductivity maps. 0: vertically uniform; 1: exponentially-decreasing (surface value and shape factor maps); 2: one map for each subsurface layer. Corresponding maps are defined in a later section. |
Porosity_profile |
Switches between different ways to prescribe total porosity maps. 0: vertically uniform; 1: exponentially-decreasing (surface value and shape factor maps); 2: one map for each subsurface layer. Corresponding maps are defined in a later section. |
Pedotransfer_Parameters_profile |
Switch to either uniform (= 0) or layer-dependent (= 1) peodtransfer parameters (Brooks-Corey air entry pressure and pore size distribution “lambda”). Corresponding maps are defined in a later section. |
Aerodyn_resist_opt |
Switches between different aerodynamic resistance formulations. 0: Penman; 1: Thom and Oliver (1977) |
Soil_resistance_opt |
Switches between different soil resistance formulations. 0: No resistance; 1: Passerat de Silans et al. (1989); 2: Sellers et al. (1992); 3: Sakaguchi and Zeng (2009). |
Uptake_Profile_opt |
Switch between ways to define root uptake profile. 0: reliant on structural root profile (exponential shape parameter Kroot in m-1). 1: Dynamic root uptake based on potential-based “easing” function from Fan et al (2017), only limited by a maximum uptake depth (depth Kroot in m). Kroot defined in SpeciesParams file. |
Time controls¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
Simul_start |
Integer |
Seconds |
Time of simulation start. In the current version this value must be 0 |
Simul_end |
Integer |
Seconds |
Time when simulation ends in seconds. This value indicates the total simulated time |
Simul_tstep |
Integer |
Seconds |
Size of the integration time step |
Clim_input_tstep |
Integer |
Seconds |
Time step of climate forcing. Typically it is the same as Simul_tstep but can be larger (i.e. climate inputs are daily but we are using an hourly integration time step). Clim_input_tstep cannot be smaller than Simul_tstep |
Report_interval |
Integer |
Seconds |
Intervals between time series outputs. Report_interval cannot be smaller than Simul_tstep, typically it is equal to Simul_tstep (but can be larger) |
ReportMap_interval |
Integer |
Seconds |
Intervals between maps outputs. ReportMap_interval cannot be smaller than Simul_tstep, but can be larger to save disk space and I/O time |
ReportMap_starttime |
Integer |
Seconds |
First time step for maps outputs (e.g. after spinup time), from which ReportMap_interval is counted |
Vegetation dynamics¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
Vegetation_dynamics |
option |
\([-]\) |
Switches between different approaches to vegetation dynamics: 0 assumes constant LAI (equal to initial value); 1 turns on vegetation allocation and growth module to calculate LAI; and 2 allows for externally forcing LAI. |
TimeSeries_LAI |
Binary file |
\(m^2.m^{-2}\) |
if Vegetation_dynamics = 2, template name of binary files giving LAI dynamics, one for each species. Files name format: template + ‘_’ + species # + ‘.bin’ |
Climate information¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
Precipitation |
Binary climate file |
\(ms^{-1}\) |
Precipitation input |
AirTemperature |
Binary climate file |
\(^{\circ}C\) |
Average air temperature |
MaxAirTemp |
Binary climate file |
\(^{\circ}C\) |
Maximum air temperature (for snow melt) |
MinAirTemp |
Binary climate file |
\(^{\circ}C\) |
Minimum air temperature (for snow melt) |
RelativeHumidity |
Binary climate file |
\(kPa~kPa^{-1}\) |
Relative air humidity |
WindSpeed |
Binary climate file |
\(ms^{-1}\) |
Wind speed |
IncomingLongWave |
Binary climate file |
\(Wm^{-2}\) |
Incoming long wave radiation |
IncomingShortWave |
Binary climate file |
\(Wm^{-2}\) |
Incoming solar radiation |
ClimateZones |
Map file name |
\([-]\) |
Map identifying the climate zones |
Isohyet_map |
Map file name |
\([-]\) |
This map redistributes precipitation within the domain (including climate zones), using multiplication factors in each pixel. A map containing 1 over the domain does not modify the precipitation inputs |
Irrigation¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
Irrigation_Input |
option |
\([-]\) |
Switch to activate (1) or deactivate (0) irrigation inputs |
Irrigation |
Binary file |
\(ms^{-1}\) |
if Irrigation_Input = 1, irrigation inputs |
Spatial domain geometry¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
DEM |
Map file name |
\(m\) |
Digital elevation model. It also defines the lateral extent and resolution of the simulation domain |
Slope |
Map file name |
\(m m^{-1}\) |
Local terrain slope. Rise over run |
local_drain_direc |
Map file name |
\([-]\) |
Drain network: D8 steepest descent local drainage direction |
S(ubs)urface parameters¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
Soil_depth |
Map file name |
\(m\) |
Total domain depth |
Depth_soil_layer_1 |
Map file name |
\(m\) |
Depth of first hydrological layer |
Depth_soil_layer_2 |
Map file name |
\(m\) |
Depth of 2nd hydrological layer |
Vert_Horz_Anis_ratio |
Map file name |
\([-]\) |
Ratio of vertical to horizontal hydraulic conductivity |
Soil_bedrock_leakance |
Map file name |
\([-]\) |
Factor between 0 and 1 setting the vertical hydraulic conductivity at the bottom of simulation domain (in fraction of Kv in layer 3) |
if Hydraulic_Conductivity_profile = 0 |
|||
Horiz_Hydraulic_Conductivity |
Map file name |
\(ms^{-1}\) |
Saturated horizontal hydraulic conductivity |
if Hydraulic_Conductivity_profile=1 |
|||
Horiz_Hydraulic_Conductivity |
Map file name |
\(ms^{-1}\) |
Surface’s saturated horizontal hydraulic conductivity |
Horiz_Hydraulic_Conductivity_Profile_Coeff |
Map file name |
\(m\) |
Exponential depth decay shape factor for sat. horizontal hydraulic conductivity |
if Hydraulic_Conductivity_profile = 2 |
|||
Horiz_Hydraulic_Conductivity |
Map file name |
\(ms^{-1}\) |
Layer 1’s saturated horizontal hydraulic conductivity |
Horiz_Hydraulic_Conductivity_Layer2 |
Map file name |
\(ms^{-1}\) |
Layer 2’s saturated horizontal hydraulic conductivity |
Horiz_Hydraulic_Conductivity_Layer3 |
Map file name |
\(ms^{-1}\) |
Layer 3’s saturated horizontal hydraulic conductivity |
if Porosity_profile = 0 |
|||
Porosity |
Map file name |
\([-]\) |
Total porosity |
Residual_soil_moisture |
Map file name |
\(m^{3}~m^{-3}\) |
Minimum allowed volumetric water content |
if Porosity_profile = 1 |
|||
Porosity |
Map file name |
\([-]\) |
Surface-level total porosity |
Porosity_Profile_Coeff |
Map file name |
\([-]\) |
Exponential depth decay shape factor for porosity |
Residual_soil_moisture |
Map file name |
\(m^{3}~m^{-3}\) |
Minimum allowed volumetric water content |
if Porosity_profile = 2 |
|||
Porosity |
Map file name |
\([-]\) |
Layer 1’s total porosity |
Porosity_Layer2 |
Map file name |
\([-]\) |
Layer 2’s total porosity |
Porosity_Layer3 |
Map file name |
\([-]\) |
Layer 3’s total porosity |
Residual_soil_moisture |
Map file name |
\(m^{3}~m^{-3}\) |
Layer 1’s minimum allowed volumetric water content |
Residual_soil_moisture_Layer2 |
Map file name |
\(m^{3}~m^{-3}\) |
Layer 2’s minimum allowed volumetric water content |
Residual_soil_moisture_Layer3 |
Map file name |
\(m^{3}~m^{-3}\) |
Layer 3’s minimum allowed volumetric water content |
if Pedotransfer_Parameters_profile = 0 |
|||
Air_entry_pressure |
Map file name |
\(m\) |
Soil air entry pressure |
Brooks_Corey_lambda |
Map file name |
\([-]\) |
Pore size distribution |
if Pedotransfer_Parameters_profile = 1 |
|||
Air_entry_pressure |
Map file name |
\(m\) |
Layer 1’s soil air entry pressure |
Brooks_Corey_lambda |
Map file name |
\([-]\) |
Layer 1’s pore size distribution |
Air_entry_pressure_Layer2 |
Map file name |
\(m\) |
Layer 2’s soil air entry pressure |
Brooks_Corey_lambda_Layer2 |
Map file name |
\([-]\) |
Layer 2’s pore size distribution |
Air_entry_pressure_Layer3 |
Map file name |
\(m\) |
Layer 3’s soil air entry pressure |
Brooks_Corey_lambda_Layer3 |
Map file name |
\([-]\) |
Layer 3’s pore size distribution |
Veget_water_use_param1 |
Map file name |
\(m\) |
Vegetation water use parameter from Landsberg & Waring (1997) |
Veget_water_use_param1 |
Map file name |
\(m\) |
Vegetation water use parameter from Landsberg & Waring (1997) |
Albedo |
Map file name |
\([-]\) |
Surface albedo |
Surface_emissivity |
Map file name |
\([-]\) |
Surface emissivity/absorptivity |
Terrain_Random_Roughness |
Map file name |
\(m\) |
Local surface roughness |
Dry_Soil_Heat_Capacity |
Map file name |
\(Jm^{-3}K^{-1}\) |
Heat capacity of soil solid particles |
Dry_Soil_Therm_Cond |
Map file name |
\(Wm^{-1}K^{-1}\) |
Thermal conductivity of soil solid particles |
Damping_depth |
Map file name |
\(m\) |
Depth of bottom of second soil thermal layer |
Temp_at_damp_depth |
Map file name |
\(^{\circ}C\) |
Soil temperature at damping depth |
Snow parameters¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
Snow_rain_temp_threshold |
Map file name |
\(^{\circ}C\) |
Air temperature threshold for snow/rain transition |
Snow_Melt_Coeff |
Map file name |
\(m^{\circ}C^{-1}s^{-1}\) |
Snowmelt rate coefficient factor |
Channel parameters¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
channel_width |
Map file name |
\(m\) |
Mask with width of channel network. Pixels with no channel must be <= 0. Positive numbers indicate the width of the channel in the pixel |
channel_gw1_transfer_param |
Map file name |
\(m^{-1}\) |
Coefficient controlling transfers of water from subsurface layer 1 to the channel |
channel_gw2_transfer_param |
Map file name |
\(m^{-1}\) |
Coefficient controlling transfers of water from subsurface layer 2 to the channel |
channel_gw3_transfer_param |
Map file name |
\(m^{-1}\) |
Coefficient controlling transfers of water from subsurface layer 3 to the channel |
mannings_n |
Map file name |
\(sm^{-1/3}\) |
Manning’s n roughness coefficient in the channel |
Initial (sub)surface states¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
Streamflow |
Map file name |
\(m^3 s^{-1}\) |
Stream discharge |
snow_water_equivalent |
Map file name |
\(m\) |
Snow water equivalent |
Soil_moisture_1 |
Map file name |
\(m^3 m^{-3}\) |
Volumetric water content (hydro layer 1) |
Soil_moisture_2 |
Map file name |
\(m^3 m^{-3}\) |
Volumetric water content (hydro layer 2) |
Soil_moisture_3 |
Map file name |
\(m^3 m^{-3}\) |
Volumetric water content (hydro layer 3) |
Soil_temperature |
Map file name |
\(^{\circ}C\) |
Temperature atop the top thermal layer |
Temp_at_damp_depth |
Map file name |
\(^{\circ}C\) |
Average temp. of bottom thermal layer |
Vegetation parameters¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
ForestPatches |
Map file name |
integers |
Map identifying land cover categories (patches) |
Number_of_Species |
Integer |
\([-]\) |
Number of species included in the simulation |
Species_Parameters |
Parameter table |
\([-]\) |
Table containing the parameters values (up to 40) for each simulated species. Only the first |
Initial vegetation states *¶
Keyword |
Type |
Unit |
Description |
|---|---|---|---|
Species_Proportion_Table |
Variable table |
\(m^{2} m^{-2}\) |
Table with initial fraction (<=1) of covered area (canopy cover) for each species |
Species_LAI_Table |
Variable table |
\(m^{2} m^{-2}\) |
Table with initial leaf area index for each species. Overriden if Vegetation_dynamics= 2. |
Below variables are mostly for biomass allocation routines |
|||
Species_StemDensity_Table |
Variable table |
\(trees.m^{-2}\) |
Table with initial stem density for each species. Values only used for ligneous species |
Species_AGE_Table |
Variable table |
\(years\) |
Table with initial average age for each species |
Species_BasalArea_Table |
Variable table |
\(m^{2}\) |
Table with initial total basal area per species. |
Species_Height_table |
Variable table |
\(m\) |
Table with initial effective height per species. |
Species_RootMass_table |
Variable table |
\(g m^{-3}\) |
Table with initial root mass per volume of soil for each species. |
Initial vegetation states **¶
Default map name (\(k\) is the species number, starting at 0) |
Unit |
Description |
|---|---|---|
p_ \(k\).map |
\(m^{2} m^{-2}\) |
fraction (<=1) of covered area (canopy cover) for \(k\)-th species |
lai_ \(k\).map |
\(m^{2} m^{-2}\) |
Leaf area index for \(k\)-th species. Overriden if Vegetation_dynamics=2 |
Below variables are mostly for biomass allocation routines |
||
ntr_ \(k\).map |
\(trees.m^{-2}\) |
for stem density for \(k\)-th species |
age_ \(k\).map |
\(years\) |
initial average age for \(k\)-th species |
bas_ \(k\).map |
\(m^{2}\) |
Total basal area for \(k\)-th species |
hgt_ \(k\).map |
\(m\) |
effective height for \(k\)-th species |
root_ \(k\).map |
\(g m^{-3}\) |
root mass per volume of soil for \(k\)-th species. |
Simulation outputs: map report switches¶
Keyword |
Unit |
Description |
File root |
|---|---|---|---|
Inputs |
|||
Report_Long_Rad_Down |
\(W m^{-2}\) |
Downwelling long wave (infrared) radiation at the top of the canopy (climate input) |
LDown |
Report_Short_Rad_Down |
\(W m^{-2}\) |
Incoming shortwave (visible) radiation at the top of the canopy (climate input) |
Sdown |
Report_Precip |
\(m~s^{-1}\) |
Input precipitation |
Pp |
Report_Irrig |
\(m~s^{-1}\) |
Input irrigation (only if Irrigation_Input = 1) |
Irg |
Report_Rel_Humidity |
\(Pa^{1}~Pa^{-1}\) |
Relative humidity in the atmosphere (climate input) |
RH |
Report_Wind_Speed |
\(m~s^{-1}\) |
Horizontal wind speed (climate input) |
WndSp |
Report_AvgAir_Temperature |
\(^{\circ}C\) |
Average air temperature (climate input) |
Tp |
Report_MinAir_Temperature |
\(^{\circ}C\) |
Minimum air temperature (climate input) |
TpMin |
Report_MaxAir_Temperature |
\(^{\circ}C\) |
Maximum air temperature (climate input) |
TpMax |
Water storage |
|||
Report_Canopy_Water_Stor_sum |
\(m\) |
Intercepted water storage (summed over species fractions) |
Cs |
Report_Canopy_Water_Stor |
\(m\) |
Intercepted water storage of species \(k\) |
Cs_ \(k\) |
Report_SWE |
\(m\) |
Snow water equivalent |
SWE |
Report_Saturation_Area |
\(-\) |
Fraction of water-saturared area |
SatA |
Report_Ponding |
\(m\) |
Surface (non-channel) water height |
PndS |
Report_Channel_Storage |
\(m\) |
Channel water height |
ChnS |
Report_Soil_Water_Content_Average |
\(m^{3}~m^{-3}\) |
Average volumetric water content for entire subsurface domain |
SWCav |
Report_Soil_Water_Content_Up |
\(m^{3}~m^{-3}\) |
Average volumetric water content for the two upper subsurface layers |
SWCup |
Report_Soil_Water_Content_L1 |
\(m^{3}~m^{-3}\) |
Volumetric water content for topmost subsurface layer |
SWC1 |
Report_Pore_Relative_Humidity_L1 |
\(-\) |
Relative humidity of air in the soil pore in L1 |
RHL1 |
Report_Soil_Water_Content_L2 |
\(m^{3}~m^{-3}\) |
Volumetric water content for second subsurface layer |
SWC2 |
Report_Soil_Water_Content_L3 |
\(m^{3}~m^{-3}\) |
Volumetric water content for third subsurface layer |
SWC3 |
Report_WaterTableDepth |
\(m\) |
Depth to the equivalent water table using the vertically-averaged water content |
WTD |
Report_WaterTableDepth_Perched |
\(m\) |
Depth to the equivalent water table, considering the shallowest saturated storage in layers |
WTDp |
Report_Soil_Sat_Deficit |
\(m\) |
Meters of water needed to saturate soil |
SatDef |
Report_Ground_Water |
\(m\) |
Meters of water above field capacity all layers combined |
GW |
Time constant |
|||
Report_Field_Capacity_L1 |
\(m^3~m^{-3}\) |
Field capacity in hydrological layer 1 (if Porosity_profile > 0) or in the whole subsurface (if Porosity_profile = 0) |
FCap1 or FCap |
Report_Field_Capacity_L2 |
\(m^3~m^{-3}\) |
Field capacity in hydrological layer 2 (if Porosity_profile > 0) |
FCap2 |
Report_Field_Capacity_L3 |
\(m^3~m^{-3}\) |
Field capacity in hydrological layer 3 (if Porosity_profile > 0) |
FCap3 |
Hydro fluxes |
|||
Report_Streamflow |
\(m^{3}~s^{-1}\) |
Channel discharge |
Q |
Report_Total_ET |
\(m~s^{-1}\) |
Total evapotranspiration |
Evap |
Report_Transpiration_sum |
\(m~s^{-1}\) |
Transpiration integrated over the grid cell using species cover fractions |
EvapT |
Report_Transpiration_Layer1 |
\(m~s^{-1}\) |
Transpiration integrated using species cover fractions, from uptake in layer 1 |
EtL1 |
Report_Transpiration_Layer2 |
\(m~s^{-1}\) |
Transpiration integrated using species cover fractions, from uptake in layer 2 |
EtL2 |
Report_Transpiration_Layer3 |
\(m~s^{-1}\) |
Transpiration integrated using species cover fractions, from uptake in layer 3 |
EtL3 |
Report_Einterception_sum |
\(m~s^{-1}\) |
Evaporation of intercepted water integrated over the grid cell using species fractions |
EvapI |
Report_Esoil_sum |
\(m~s^{-1}\) |
Soil evaporation integrated over subcanopy and bare soil fractions |
EvapS |
Report_species_ET |
\(m~s^{-1}\) |
Evapotranspiration for species \(k\) |
ETc\(k\)_ |
Report_Transpiration |
\(m~s^{-1}\) |
Transpiration from species \(k\) |
Et\(k\)_ |
Report_Einterception |
\(m~s^{-1}\) |
Evaporation of intercepted water for the species \(k\) |
Ei\(k\)_ |
Report_Esoil |
\(m~s^{-1}\) |
Soil evaporation under the species \(k\) |
Es\(k\)_ |
Report_Leakage_Out_of_System |
\(m~s^{-1}\) |
Vertical drainage at the bottom of the subsurface domain |
Leak |
Hydro fluxes |
(internal) |
||
Report_Throughfall |
\(m~s^{-1}\) |
Throughfall summed over speceis fractions |
ThFall |
Report_Snowmelt |
\(m~s^{-1}\) |
Snow melt rate |
Melt |
Report_Infiltration |
\(m~s^{-1}\) |
Water (re)infiltrated water in the first hydrological layer |
Inf |
Report_Percolation_to_Layer2 |
\(m~s^{-1}\) |
Water transfer from the 1st to the 2nd hydrological layer |
PrcL2 |
Report_Percolation_to_Layer3 |
\(m~s^{-1}\) |
Water transfer from the 2nd to the 3rd hydrological layer |
PrcL3 |
Report_Groundwater_Recharge |
\(m~s^{-1}\) |
Incoming water in the saturated part (above field capacity) in all layers |
Rchg |
Report_GWseepage_Layer1_to_Channnel |
\(m\) |
Groundwater seepage from layer 1 in stream water |
GW1Chn |
Report_GWseepage_Layer2_to_Channnel |
\(m\) |
Groundwater seepage from layer 2 in stream water |
GW2Chn |
Report_GWseepage_Layer3_to_Channnel |
\(m\) |
Groundwater seepage from layer 3 in stream water |
GW3Chn |
Report_Surface_to_Channel |
\(m~s^{-1}\) |
Surface runoff contributing to stream water |
SrfChn |
Report_Return_Flow_Surface |
\(m~s^{-1}\) |
Exfiltration rate from the first hydrological layer |
RSrf |
Report_Return_Flow_to_Layer1 |
\(m~s^{-1}\) |
Exfiltration rate from the 2nd to the 1st hydrological layer |
RL1 |
Report_Return_Flow_to_Layer2 |
\(m~s^{-1}\) |
Exfiltration rate from the 3rd to the 2nd hydrological layer |
RL2 |
Report_Overland_Inflow |
\(m~s^{-1}\) |
Surface run-on (excluding channel inflow) |
LSrfi |
Report_Stream_Inflow |
\(m~s^{-1}\) |
Incoming stream water |
LChni |
Report_Groundwater_Inflow_Layer1 |
\(m\) |
Lateral groundwater inflow in layer 1 |
LGW1i |
Report_Groundwater_Inflow_Layer2 |
\(m\) |
Lateral groundwater inflow in layer 2 |
LGW2i |
Report_Groundwater_Inflow_Layer3 |
\(m\) |
Lateral groundwater inflow in layer 3 |
LGW3i |
Report_Overland_Outflow |
\(m~s^{-1}\) |
Surface run-off (excluding channel outflow) |
LSrfo |
Report_Stream_Outflow |
\(m\) |
Outgoing stream water |
LChno |
Report_Groundwater_Outflow_Layer1 |
\(m\) |
Lateral groundwater outflow in layer 1 |
LGW1o |
Report_Groundwater_Outflow_Layer2 |
\(m\) |
Lateral groundwater outflow in layer 2 |
LGW2o |
Report_Groundwater_Outflow_Layer3 |
\(m\) |
Lateral groundwater outflow in layer 3 |
LGW3o |
Hydro fluxes (time-cumulative) |
|||
Report_Transpiration_acc |
\(m\) |
Time-cumulative, species-summed transpiration |
EtA |
Report_Transpiration_Layer1_acc |
\(m\) |
Time-cumulative, species-summed transpiration from uptake in layer 1 |
EtL1A |
Report_Transpiration_Layer2_acc |
\(m\) |
Time-cumulative, species-summed transpiration from uptake in layer 2 |
EtL2A |
Report_Transpiration_Layer3_acc |
\(m\) |
Time-cumulative, species-summed transpiration from uptake in layer 3 |
EtL3A |
Report_E_Interception_acc |
\(m\) |
Time-cumulative, species-summed evaporation of intercepted water |
EiA |
Report_Soil_Evaporation_acc |
\(m\) |
Time-cumulative soil evaporation over subcanopy and bare soil fractions |
EsA |
Report_Leakage_Out_of_System_acc |
\(m\) |
Time-cumulative vertical drainage at the bottom of the subsurface domain |
LeakA |
Report_Infiltration_acc |
\(m\) |
Time-cumulative water (re)infiltrated water in the first hydrological layer |
InfA |
Report_Percolation_to_Layer2_acc |
\(m\) |
Time-cumulative water transfer from the 1st to the 2nd hydrological layer |
PrcL2A |
Report_Percolation_to_Layer3_acc |
\(m\) |
Time-cumulative water transfer from the 2nd to the 3rd hydrological layer |
PrcL3A |
Report_GWseepage_Layer1_to_Channnel_acc |
\(m\) |
Time-cumulative groundwater seepage from layer 1 in stream water |
GW1ChnA |
Report_GWseepage_Layer2_to_Channnel_acc |
\(m\) |
Time-cumulative groundwater seepage from layer 2 in stream water |
GW2ChnA |
Report_GWseepage_Layer3_to_Channnel_acc |
\(m\) |
Time-cumulative groundwater seepage from layer 3 in stream water |
GW3ChnA |
Report_Surface_to_Channel_acc |
\(m\) |
Time-cumulative surface runoff contributing to stream water |
SrfChnA |
Report_Return_Flow_Surface_acc |
\(m\) |
Time-cumulative exfiltration from the first hydrological layer |
RSrfA |
Report_Return_Flow_to_Layer1_acc |
\(m\) |
Time-cumulative exfiltration from the 2nd to the 1st hydrological layer |
RL1A |
Report_Return_Flow_to_Layer2_acc |
\(m\) |
Time-cumulative exfiltration from the 3rd to the 2nd hydrological layer |
RL2A |
Report_Overland_Inflow_acc |
\(m\) |
Time-cumulative surface run-on (excluding channel inflow) |
LSrfiA |
Report_Stream_Inflow_acc |
\(m\) |
Time-cumulative incoming stream water |
LChniA |
Report_Groundwater_Inflow_Layer1_acc |
\(m\) |
Time-cumulative lateral groundwater inflow in layer 1 |
LGW1iA |
Report_Groundwater_Inflow_Layer2_acc |
\(m\) |
Time-cumulative lateral groundwater inflow in layer 2 |
LGW2iA |
Report_Groundwater_Inflow_Layer3_acc |
\(m\) |
Time-cumulative lateral groundwater inflow in layer 3 |
LGW3iA |
Report_Overland_Outflow_acc |
\(m\) |
Time-cumulative surface run-off (excluding channel outflow) |
LSrfoA |
Report_Stream_Outflow_acc |
\(m\) |
Time-cumulative outgoing stream water |
LChnoA |
Report_Groundwater_Outflow_Layer1_acc |
\(m\) |
Time-cumulative lateral groundwater outflow in layer 1 |
LGW1oA |
Report_Groundwater_Outflow_Layer2_acc |
\(m\) |
Time-cumulative lateral groundwater outflow in layer 2 |
LGW2oA |
Report_Groundwater_Outflow_Layer3_acc |
\(m\) |
Time-cumulative lateral groundwater outflow in layer 3 |
LGW3oA |
Energy balance |
|||
Report_Surface_Net_Rad |
\(Wm^{-2}\) |
Soil-level net radiation integrated over the grid cell (including bare soil fraction) |
NRs |
Report_Vegetation_Net_Rad |
\(Wm^{-2}\) |
Net radiation at canopy level integrated over the grid cell |
NRv |
Report_Total_Net_Rad |
\(Wm^{-2}\) |
Overall net radiation integrated over the grid cell (including bare soil fraction) |
NRt |
Report_Surface_Latent_Heat |
\(Wm^{-2}\) |
Latent heat flux of soil evaporation integrated over the grid cell (including bare soil fraction) |
LatHs |
Report_Vegetation_Latent_Heat |
\(Wm^{-2}\) |
Latent heat flux of canopy evaporation (interception+transpiration) integrated over the grid cell |
LatHv |
Report_Total_Latent_Heat |
\(Wm^{-2}\) |
Latent heat flux of ET integrated over the grid cell (including bare soil fraction) |
LatHt |
Report_Surface_Sensible_Heat |
\(Wm^{-2}\) |
Soil-level sensible flux heat integrated over the grid cell (including bare soil fraction) |
SenHs |
Report_Vegetation_Sensible_Heat |
\(Wm^{-2}\) |
Sensible heat flux at canopy level integrated over the grid cell |
SenHv |
Report_Total_Sensible_Heat |
\(Wm^{-2}\) |
Overall sensible heat flux integrated over the grid cell (including bare soil fraction) |
SenHt |
Report_Grnd_Heat |
\(Wm^{-2}\) |
Ground heat flux |
GrndH |
Report_Snow_Heat |
\(Wm^{-2}\) |
Turbulent heat exchange with snowpack |
SnowH |
Report_Soil_Temperature |
\(^{\circ}C\) |
Subsurface temperature in the bottom (2nd) thermal layer |
Ts |
Report_Skin_Temperature |
\(^{\circ}C\) |
Soil skin temperature (top of 1st thermal layer) |
Tskin |
Report_Canopy_Temp |
\(^{\circ}C\) |
Canopy temperature of species \(k\) |
Tc\(k\)_ |
Report_Canopy_NetR |
\(W m^{-2}\) |
Canopy-level net radiation above the species \(k\) |
NRc\(k\)_ |
Report_Canopy_LE_E |
\(W m^{-2}\) |
Latent heat for evaporation of canopy interception for species \(k\) |
LEEi\(k\)_ |
Report_Canopy_LE_T |
\(W m^{-2}\) |
Transpiration latent heat for species \(k\) |
LETr\(k\)_ |
Report_Canopy_Sens_Heat |
\(W m^{-2}\) |
Sensible heat, canopy layer of species \(k\) |
Hc\(k\)_ |
Vegetation state |
|||
Report_GPP_sum |
\(gC m^{-2}\) |
Timestep-cumulative gross primary production summed over species fractions |
GPP |
Report_NPP |
\(gC^{-1} m^{-2}\) |
Timestep-cumulative net primary production summed over species fractions |
NPP |
Report_Veget_frac |
\(m^{2} m^{-2}\) |
Fraction of cell covered by canopy of species \(k\) |
p\(k\)_ |
Report_Stem_Density |
\(stems m^{-2}\) |
Density of individuals of species \(k\) |
ntr\(k\)_ |
Report_Leaf_Area_Index |
\(m^{2} m^{-2}\) |
Leaf area index of species \(k\) |
lai\(k\)_ |
Report_Stand_Age |
\(years\) |
Age of stand of species \(k\) |
age\(k\)_ |
Report_Canopy_Conductance |
\(m~s^{-1}\) |
Canopy conductance for species \(k\) |
gc\(k\)_ |
Report_GPP |
\(gC m^{-2}\) |
Timestep-cumulative gross primary production for species \(k\) |
gpp\(k\)_ | |
Report_NPP |
\(gC^{-1} m^{-2}\) |
Timestep-cumulative net primary production for species \(k\) |
npp\(k\)_ |
Report_Basal_Area |
\(m^{2}\) |
Total basal area of species \(k\) |
bas\(k\)_ |
Report_Tree_Height |
\(m\) |
Height of stand of species \(k\) |
hgt\(k\)_ |
Report_Root_Mass |
\(g m^{-3}\) |
Root mass per volume of soil species \(k\) |
root\(k\)_ |
Map mask for time series locations¶
Keyword |
Type |
Description |
|---|---|---|
TS_mask |
Map file name |
Map identifying cells for which state variables will be reported. Map should be zero or NaN everywhere except for target cells. A maximum of 32 cells can be reported. |
Simulation outputs: time series report switches¶
Keyword |
Unit |
Description |
File name |
|---|---|---|---|
Inputs |
|||
Ts_Long_Rad_Down |
\(W m^{-2}\) |
Downwelling long wave (infrared) radiation at the top of the canopy (climate input) |
LDown.tab |
Ts_Short_Rad_Down |
\(W m^{-2}\) |
Incoming shortwave (visible) radiation at the top of the canopy (climate input) |
Sdown.tab |
Ts_Precip |
\(m~s^{-1}\) |
Input precipitation |
Precip.tab |
Ts_Precip |
\(m~s^{-1}\) |
Input irrigation (only if Irrigation_Input = 1) |
Irrig.tab |
Ts_Rel_Humidity |
\(Pa^{1}~Pa^{-1}\) |
Relative humidity in the atmosphere (climate input) |
RelHumid.tab |
Ts_Wind_Speed |
\(m~s^{-1}\) |
Horizontal wind speed (climate input) |
WindSpeed.tab |
Ts_AvgAir_Temperature |
\(^{\circ}C\) |
Average air temperature (climate input) |
AvgTemp.tab |
Ts_MinAir_Temperature |
\(^{\circ}C\) |
Minimum air temperature (climate input) |
MinTemp.tab |
Ts_MaxAir_Temperature |
\(^{\circ}C\) |
Maximum air temperature (climate input) |
MaxTemp.tab |
Water storage |
|||
Ts_Canopy_Water_Stor_sum |
\(m\) |
Interception storage (summed over species fractions) |
CanopyWaterStor.tab |
Ts_Canopy_Water_Stor |
\(m\) |
Interception storage of species \(k\) |
CanopyWaterStor_\(k\).tab |
Ts_SWE |
\(m\) |
Snow water equivalent |
SWE.tab |
Ts_Ponding |
\(m\) |
Surface (non-channel) water height |
Ponding.tab |
Ts_Channel_Storage |
\(m\) |
Channel water height |
ChannelStorage.tab |
Ts_Soil_Water_Content_Average |
\(m^{3} m^{-3}\) |
Average volumetric water content for entire subsurface domain |
SoilMoistureAv.tab |
Ts_Soil_Water_Content_Up |
\(m^{3} m^{-3}\) |
Average volumetric water content for the two upper subsurface layers |
SoilMoistureUp.tab |
Ts_Soil_Water_Content_L1 |
\(m^{3} m^{-3}\) |
Volumetric water content for topmost subsurface layer |
SoilMoistureL1.tab |
Ts_Pore_Relative_Humidity_L1 |
\(-\) |
Relative humidity of air in the soil pore in L1 |
PoreRelHumid_L1.tab |
Ts_Soil_Water_Content_L2 |
\(m^{3} m^{-3}\) |
Volumetric water content for second subsurface layer |
SoilMoistureL2.tab |
Ts_Soil_Water_Content_L3 |
\(m^{3}~m^{-3}\) |
Volumetric water content for third subsurface layer |
SoilMoistureL3.tab |
Ts_WaterTableDepth |
\(m\) |
Depth to the equivalent water table using the vertically-averaged water content |
WaterTableDepth.tab |
Ts_WaterTableDepth_Perched |
\(m\) |
Depth to the equivalent water table, considering the shallowest saturated storage in layers |
WaterTableDepth_p.tab |
Ts_Soil_Sat_Deficit |
\(m\) |
Meters of water needed to saturate soil |
SoilSatDef.tab |
Ts_Ground_Water |
\(m\) |
Meters of water above field capacity all layers combined |
GroundWater.tab |
Hydro fluxes |
|||
Ts_OutletDischarge |
\(m^{3} s^{-1}\) |
Stream discharge at cells where local_drain_direc map (ldd) = 5 (outlets and sinks) |
OutletDisch.tab |
Ts_Streamflow |
\(m^{3} s^{-1}\) |
Stream discharge (at TS_mask locations) |
Streamflow.tab |
Ts_Total_ET |
\(m~s^{-1}\) |
Total evapotranspiration |
Evap.tab |
Ts_Transpiration_sum |
\(m~s^{-1}\) |
Transpiration integrated over the grid cell using species cover fractions |
EvapT.tab |
Ts_Transpiration_Layer1 |
\(m~s^{-1}\) |
Transpiration integrated using species cover fractions, from uptake in layer 1 |
EvapT_L1.tab |
Ts_Transpiration_Layer2 |
\(m~s^{-1}\) |
Transpiration integrated using species cover fractions, from uptake in layer 2 |
EvapT_L2.tab |
Ts_Transpiration_Layer3 |
\(m~s^{-1}\) |
Transpiration integrated using species cover fractions, from uptake in layer 3 |
EvapT_L3.tab |
Ts_Einterception_sum |
\(m~s^{-1}\) |
Evaporation of intercepted water integrated over the grid cell using species fractions |
EvapI.tab |
Ts_Esoil_sum |
\(m~s^{-1}\) |
Soil evaporation integrated over subcanopy and bare soil fractions |
EvapS.tab |
Ts_species_ET |
\(m~s^{-1}\) |
Evapotranspiration for species \(k\) |
ETc_ \(k\).tab |
Ts_Transpiration |
\(m~s^{-1}\) |
Transpiration from species \(k\) |
EvapT_ \(k\).tab |
Ts_Einterception |
\(m~s^{-1}\) |
Evaporation of intercepted water for the species \(k\) |
EvapI_ \(k\).tab |
Ts_Esoil |
\(m~s^{-1}\) |
Soil evaporation under the species \(k\) |
EvapS_ \(k\).tab |
Ts_Leakage_Out_of_System |
\(m~s^{-1}\) |
Vertical drainage at the bottom of the subsurface domain |
Leakage.tab |
Hydro fluxes |
(internal) |
||
Ts_Throughfall |
\(m~s^{-1}\) |
Throughfall summed over speceis fractions |
Throughfall.tab |
Ts_Snowmelt |
\(m~s^{-1}\) |
Snow melt rate |
Snowmelt.tab |
Ts_Infiltration |
\(m~s^{-1}\) |
Water (re)infiltrated water in the first hydrological layer |
Infilt.tab |
Ts_Percolation_to_Layer2 |
\(m~s^{-1}\) |
Water transfer from the 1st to the 2nd hydrological layer |
PercolL2.tab |
Ts_Percolation_to_Layer3 |
\(m~s^{-1}\) |
Water transfer from the 2nd to the 3rd hydrological layer |
PercolL3.tab |
Ts_Groundwater_Recharge |
\(m~s^{-1}\) |
Incoming water in the saturated part (above field capacity) in all layers |
Recharge.tab |
Ts_GW_to_Channnel |
\(m~s^{-1}\) |
Groundwater seepage rate in stream water |
GWtoChn.tab |
Ts_Surface_to_Channel |
\(m~s^{-1}\) |
Surface runoff contributing to stream water |
SrftoChn.tab |
Ts_Return_Flow_Surface |
\(m~s^{-1}\) |
Exfiltration rate from the first hydrological layer |
ReturnSrf.tab |
Ts_Return_Flow_to_Layer1 |
\(m~s^{-1}\) |
Exfiltration rate from the 2nd to the 1st hydrological layer |
ReturnL1.tab |
Ts_Return_Flow_to_Layer2 |
\(m~s^{-1}\) |
Exfiltration rate from the 3rd to the 2nd hydrological layer |
ReturnL2.tab |
Ts_Overland_Inflow |
\(m~s^{-1}\) |
Surface run-on (excluding channel inflow) |
SrfLatI.tab |
Ts_Stream_Inflow |
\(m~s^{-1}\) |
Incoming stream water |
ChnLatI.tab |
Ts_Groundwater_Inflow_Layer1 |
\(m~s^{-1}\) |
Lateral groundwater inflow in layer 1 |
GW1LatI.tab |
Ts_Groundwater_Inflow_Layer2 |
\(m~s^{-1}\) |
Lateral groundwater inflow in layer 2 |
GW2LatI.tab |
Ts_Groundwater_Inflow_Layer3 |
\(m~s^{-1}\) |
Lateral groundwater inflow in layer 3 |
GW3LatI.tab |
Ts_Overland_Outflow |
\(m~s^{-1}\) |
Surface run-off (excluding channel outflow) |
SrfLatO.tab |
Ts_Stream_Outflow |
\(m~s^{-1}\) |
Outgoing stream water |
ChnLatO.tab |
Ts_Groundwater_Outflow_Layer1 |
\(m~s^{-1}\) |
Lateral groundwater outflow in layer 1 |
GW1LatI.tab |
Ts_Groundwater_Outflow_Layer2 |
\(m~s^{-1}\) |
Lateral groundwater outflow in layer 2 |
GW2LatI.tab |
Ts_Groundwater_Outflow_Layer3 |
\(m~s^{-1}\) |
Lateral groundwater outflow in layer 3 |
GW3LatO.tab |
Energy balance |
|||
Ts_Surface_Net_Rad |
\(Wm^{-2}\) |
Soil-level net radiation integrated over the grid cell (including bare soil fraction) |
NetRad_srf.tab |
Ts_Vegetation_Net_Rad |
\(Wm^{-2}\) |
Net radiation at canopy level integrated over the grid cell |
NetRad_veg.tab |
Ts_Total_Net_Rad |
\(Wm^{-2}\) |
Overall net radiation integrated over the grid cell (including bare soil fraction) |
NetRad_tot.tab |
Ts_Surface_Latent_Heat |
\(Wm^{-2}\) |
Latent heat flux of soil evaporation integrated over the grid cell (including bare soil fraction) |
LatHeat_srf.tab |
Ts_Vegetation_Latent_Heat |
\(Wm^{-2}\) |
Latent heat flux of canopy evaporation (interception+transpiration) integrated over the grid cell |
LatHeat_veg.tab |
Ts_Total_Latent_Heat |
\(Wm^{-2}\) |
Latent heat flux of ET integrated over the grid cell (including bare soil fraction) |
LatHeat_tot.tab |
Ts_Surface_Sensible_Heat |
\(Wm^{-2}\) |
Soil-level sensible flux heat integrated over the grid cell (including bare soil fraction) |
SensHeat_srf.tab |
Ts_Vegetation_Sensible_Heat |
\(Wm^{-2}\) |
Sensible heat flux at canopy level integrated over the grid cell |
SensHeat_veg.tab |
Ts_Total_Sensible_Heat |
\(Wm^{-2}\) |
Overall sensible heat flux integrated over the grid cell (including bare soil fraction) |
SensHeat_tot.tab |
Ts_Grnd_Heat |
\(Wm^{-2}\) |
Ground heat flux |
GrndHeat.tab |
Ts_Snow_Heat |
\(Wm^{-2}\) |
Turbulent heat exchange with snowpack |
SnowHeat.tab |
Ts_Soil_Temperature |
\(^{\circ}C\) |
Subsurface temperature in the bottom (2nd) thermal layer |
SoilTemp.tab |
Ts_Skin_Temperature |
\(^{\circ}C\) |
Soil skin temperature (top of 1st thermal layer) |
SkinTemp.tab |
Ts_Canopy_Temp |
\(^{\circ}C\) |
Canopy temperature of species \(k\) |
CanopyTemp_ \(k\).tab |
Ts_Canopy_NetR |
\(W m^{-2}\) |
Canopy-level net radiation above the species \(k\) |
NetRadC_ \(k\).tab |
Ts_Canopy_LE_E |
\(W m^{-2}\) |
Latent heat for evaporation of canopy interception for species \(k\) |
CanopyLatHeatEi_ \(k\).tab |
Ts_Canopy_LE_T |
\(W m^{-2}\) |
Transpiration latent heat for species \(k\) |
CanopyLatHeatTr_ \(k\).tab |
Ts_Canopy_Sens_Heat |
\(W m^{-2}\) |
Sensible heat, canopy layer of species \(k\) |
CanopySensHeat_ \(k\).tab |
Vegetation state |
|||
Ts_GPP_sum |
\(gC m^{-2}\) |
Timestep-cumulative gross primary production summed over species fractions |
GPP.tab |
Ts_NPP |
\(gC^{-1} m^{-2}\) |
Timestep-cumulative net primary production summed over species fractions |
NPP.tab |
Ts_Veget_frac |
\(m^{2} m^{-2}\) |
Fraction of cell covered by canopy of species \(k\) |
p_\(k\).tab |
Ts_Stem_Density |
\(stems m^{-2}\) |
Density of individuals of species \(k\) |
num_of_trees_\(k\).tab |
Ts_Leaf_Area_Index |
\(m^{2} m^{-2}\) |
Leaf area index of species \(k\) |
lai_\(k\).tab |
Ts_Stand_Age |
\(years\) |
Age of stand of species \(k\) |
age\(k\)_ |
Ts_Canopy_Conductance |
\(m~s^{-1}\) |
Canopy conductance for species \(k\) |
CanopyConduct_\(k\).tab |
Ts_GPP |
\(gC m^{-2}\) |
Timestep-cumulative gross primary production for species \(k\) |
GPP_\(k\).tab |
Ts_NPP |
\(gC^{-1} m^{-2}\) |
Timestep-cumulative net primary production for species \(k\) |
NPP_\(k\).tab |
Ts_Basal_Area |
\(m^{2}\) |
Total basal area of species \(k\) |
BasalArea_\(k\).tab |
Ts_Tree_Height |
\(m\) |
Height of stand of species \(k\) |
TreeHeight_\(k\).tab |
Ts_Root_Mass |
\(g m^{-3}\) |
Root mass per volume of soil species \(k\) |
RootMass_\(k\).tab |