# Configuration file keywords¶

PATH DEFINITION SECTION
Keyword Type Units Description
Maps_Folder System Path N/A Path to folder with land surface information
Clim_Maps_Folder System Path N/A Path to folder with Climate information
Output_Folder System Path N/A Path to folder where outputs will be written
OPTIONS
Keyword Type Units Description
MapTypes option N/A Format of maps. In this version the format is csf (PCRaster)
Species_State _Variable_Input_Method option N/A Specifies the input format of the vegetation state variables. Options are textit{table} or textit{maps}
Reinfiltration option N/A Switch 1/0 to turn reinfiltration on (1) or off (0)
Channel option N/A Switch 1/0 to turn channel routing on (1) or off (0)
Vegetation_dynamics option N/A Switch 1/0 to turn vegetation growth on (1) or off (0)
Aerodyn_resist_opt option N/A Switches between different aerodynamic resistance formulations. 0: Penman; 1: Thom and Oliver (1977)
Soil_resistance_opt option N/A Switches between different soil resistance formulations. 0: Passerat de Silans et al 1989; 1: Ivanov et al (2008)
TIME CONTROLS
Keyword Type Units 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 textit{Simul_tstep} but can be larger (i.e. climate inputs are daily but we are using an hourly integration time step). textit{Clim_input_tstep} cannot be smaller than textit{Simul_tstep}
Report_interval Integer Seconds Intervals between outputs. textit{Report_interval} cannot be smaller than textit{Simul_tstep} and typically it is equal to textit{Simul_tstep}
Climate information (maps and binary files must be placed in Clim_Maps_Folder
Keyword Type Units Description
Snow_rain_temp_threshold scalar $$^{\circ}C$$ Air temperature threshold for snow/rain transition
ClimateZones Map file name integers Map identifying the climate zones
Isohyet_map Map file name
This map allows to redistribute rainfall within a climate zone. It is a map with multiplication factors for rain in a given pixel. A map containing 1 over the domain has the effect of overriding this input (does not modify the precipitation input)
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
MinAirTemp Binary climate file $$^{\circ}C$$ Maximum air temperature
RelativeHumidity Binary climate file $$kPakPa^{-1}$$ Average air temperature
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
Drainage network (Files must be located in Maps_Folder)
Keyword Type Units Description
local_drain_direc Map file name
D8 steepest descent ldd
channel_width Map file name $$m$$ mask with width of channel network. Pixels with no channel must be 0 or nodata. Positive numbers indicate the width of the channel in the pixel
channel_gw_transfer_param Map file name  m^{-1} Coefficient controlling transfers of water from the subsurface system to the channel
mannings_n Map file name  sm^{-1/3} Manning’s n roughness coefficient for channel
Initial conditions for soil states (Files must be located in Maps\_Folder)
Keyword Type Units Description
Streamflow Map file name $$m^3s^{-1}$$ Streamflow
snow_water_equivalent Map file name $$m$$ Snow water equivalent
Soil_moisture_1 Map file name $$m^3m^{-3}$$ Volumetric soil water content for topmost soil layer
Soil_moisture_2 Map file name $$m^3m^{-3}$$ Volumetric soil water content for layer 3
Soil_moisture_3 Map file name $$m^3m^{-3}$$ Volumetric soil water content of bottommost layer
Soil_temperature Map file name $$^{\circ}C$$ Soil temperature at boundary of thermal layer
Soil parameters (Files must be located in Maps_Folder)
Keyword Type Units Description
DEM Map file name $$m$$ Digital elevation model
Slope Map file name $$mm^{-1}$$ Local terrain slope. Rise over run
Horiz_Hydraulic_Conductivity Map file name $$ms^{-1}$$ Effective soil hydraulic conductivity
Vert_Horz_Anis_ratio Map file name $$[-]$$ Ratio of vertical to horizontal hydraulic conductivity
Terrain_Random_Roughness Map file name $$m$$ Local surface roughness
Porosity Map file name
Soil porosity
Air_entry_pressure Map file name $$m$$ Soil air entry pressure
Brooks_Corey_lambda Map file name
Pore size distribution
Residual_soil_moisture Map file name $$m^{3}m^{-3}$$ Minimum allowed volumetric soil water content
Soil_depth Map file name $$m$$ Soil depth
Depth_soil_layer_1 Map file name $$m$$ Depth of topmost soil layer
Depth_soil_layer_2 Map file name $$m$$ Depth of second soil layer
Veget_water_use_param1 Map file name $$m$$ Vegetation water use parameter as per Landsberg and Waring (1997)
Veget_water_use_param2 Map file name $$m$$ Vegetation water use parameter as per Landsberg and Waring (1997)
Fraction_roots_soil_layer_1 Map file name
Fraction of roots in topmost soil layer. Sum of fraction of roots in soil layer 1 and 2 must be less than 1
Fraction_roots_soil_layer_2 Map file name
Fraction of roots in second soil layer. Sum of fraction of roots in soil layer 1 and 2 must be less than 1
Albedo Map file name
Surface albedo
Surface_emissivity Map file name
Surface emissivity/absorptivity
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_Melt_Coeff Map file name $$m^{\circ}C^{-1}$$ Snowmelt coefficient factor
Forest parameters (Files must be located in Maps_Folder)
Keyword Type Units Description
ForestPatches Map file name integers Map identifying forest categories (patches)
Number_of_Species Integer
Number of vegetation types included in the simulation
Species_Parameters Parameter table
Table containing parameter information for each simulated vegetation type
Tables needed only if Species_State_Variable_Input_Method=tables
Keyword Type Units Description
Species_Proportion_Table Variable table $$m^{2}m^{-2}$$ Table with initial proportion of covered area (canopy cover) for each vegetation type with respect to cell area
Species_StemDensity_Table Variable table $$trees m^{-2}$$ Table with initial tree density per cell for each vegetation type
Species_LAI_Table Variable table $$m^{2}m^{-2}$$ Table with initial leaf area index for each vegetation type
Species_AGE_Table Variable table $$years$$ Table with initial average age each vegetation type
Species_BasalArea_Table Variable table $$m^{2}$$ Table with initial total basal area per vegetation type
Species_Height_table Variable table $$m$$ Table with initial effective height per vegetation type
Species_RootMass_table Variable table $$gm^{-3}$$ Table with initial root mass per volume of soil for each vegetation type
Map report switches
Keyword Type Units Description
Report_Long_Rad_Down switch $$Wm^{-2}$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Ldown}
Report_Short_Rad_Down switch $$Wm^{-2}$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Sdown}
Report_Precip switch $$ms^{-1}$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Pp}
Report_Rel_Humidity switch $$Pa^{1}Pa^{-1}$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{RH}
Report_Wind_Speed switch $$ms^{-1}$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{WndSp}
Report_AvgAir_Temperature switch $$^{\circ}C$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Tp}
Report_MinAir_Temperature switch $$^{\circ}C$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{TpMin}
Report_MaxAir_Temperature switch $$^{\circ}C$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{TpMax}
Report_SWE switch $$m$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{SWE}
Report_Infilt_Cap switch $$ms^{-1}$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{If}
Report_Infilt_Cap switch $$ms^{-1}$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{If}
Report_Streamflow switch $$m^{3}s^{-1}$$ 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Q}
Report_Soil_Water_Content_Average switch $$m^{3}m^{-3}$$ 1: Average volumetric water content for entire soil profile. Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Theta}
Report_Soil_Water_Content_L1 switch $$m^{3}m^{-3}$$ 1: Volumetric water content for topmost soil layer. Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Theta}
Report_Soil_Water_Content_L2 switch $$m^{3}m^{-3}$$ 1: Volumetric water content for second soil layer. Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Theta}
Report_Soil_Water_Content_L3 switch $$m^{3}m^{-3}$$ 1: Volumetric water content for bottommost soil layer. Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Theta}
Report_Soil_Sat_Deficit switch $$m$$ Meters of water needed to saturate soil. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{SatDef}
Report_Soil_ETP switch $$ms^{-1}$$ Soil evaporation. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Evap}
Report_Soil_Net_RadReport switch $$Wm^{-2}$$ Soil net radiation. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{NetR}
Report_Soil_LESoil switch $$Wm^{-2}$$ Latent heat for surface layer. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{LE}
Report_Sens_Heat switch $$Wm^{-2}$$ Sensible heat for surface layer. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{SensH}
Report_Grnd_Heat switch $$Wm^{-2}$$ Ground heat. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{GrndH}
Report_Snow_Heat switch $$Wm^{-2}$$ Turbulent heat exchange with snowpack. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{SnowH}
Report_Soil_Temperature switch $$^{\circ}C$$ Soil temperature at the bottom of first thermal layer. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Ts}
Report_Skin_Temperature switch $$^{\circ}C$$ Soil skin temperature. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Tskin}
Report_Veget_frac switch $$m^{2}m^{-2}$$ Fraction of cell covered by canopy of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{p[textit{n}]}
Report_Stem_Density switch $$stems m^{-2}$$ Density of individuals of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{ntr[textit{n}]}
Report_Leaf_Area_Index switch :math: m^{2}m^{-2}` Leaf area index of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{lai[textit{n}]}
Report_Stand_Age switch $$years$$ Age of stand of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{age[textit{n}]}
Report_Canopy_Conductance switch $$ms^{-1}$$ Canopy conductance for vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{gc[textit{n}]}
Report_GPP switch $$gCm^{-2}$$ Gross primary production for vegetation type textit{n} during the time step. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{gpp[textit{n}]}
Report_NPP switch $$gC^{-1}m^{-2}$$ Net primary production for vegetation type textit{n} during the time step. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{npp[textit{n}]}
Report_Basal_Area switch $$m^{2}$$ Total basal area of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{bas[textit{n}]}
Report_Tree_Height switch $$m$$ Height of stand of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{hgt[textit{n}]}
Report_Root_Mass switch $$gm^{-3}$$ Root mass per volume of soil vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{root[textit{n}]}
Report_Canopy_Temp switch $$^{\circ}C$$ Canopy temperature of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Tc[textit{n}]}
Report_Canopy_NetR switch $$Wm^{-2}$$ Canopy temperature of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Tc[textit{n}]}
Report_Canopy_LE switch $$Wm^{-2}$$ Latent heat for canopy layer of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{LEc[textit{n}]}
Report_Canopy_Sens_Heat switch $$Wm^{-2}$$ Sensible heat for canopy layer of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Hc[end{appendix}textit{n}]}
Report_Canopy_Water_Stor switch $$m$$ Water storage in canopy layer of vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Cs[textit{n}]}
Report_Transpiration switch $$ms^{-1}$$ Transpiration from vegetation type textit{n}. 1: Report map for this variable - 0: Switch off reporting for this variable. Root name textsf{Trp[textit{n}]}
Time series report switches
Keyword Type Units Description
Ts_OutletDischarge switch $$m^{3}s^{-1}$$ 1: Turns on reporting of discharge at cells with textit{ldd} value = 5 (outlets and sinks) - 0: Turns off report. File name textsf{Discharge.tab}
TS_mask Map file name nominal Map identifying cells for which state variables will be reported. Map should be zero every=where expect for target cells. which are identified with integer IDs (geq 1). A maximum of 32 cells can be reported.
Ts_Long_Rad_Down Time series table $$Wm^{-2}$$ Time series of incoming long wave radiation to the surface layer for cells identified in textsf{TS_mask}. File name textsf{Ldown.tab}
Ts_Short_Rad_Down Time series table $$Wm^{-2}$$ Time series of incoming short wave radiation to the surface layer for cells identified in textsf{TS_mask}. File name textsf{Sdown.tab}
Ts_Precip Time series table $$ms^{-1}$$ Time series of atmospheric long wave radiation for cells identified in textsf{TS_mask}. File name textsf{Precip.tab}
Ts_Rel_Humidity Time series table $$PaPa^{-1}$$ Time series of relative humidity at the reference height for cells identified in textsf{TS_mask}. File name textsf{RelHumid.tab}
Ts_Wind_Speed Time series table $$ms^{-1}$$ Time series of wind speed at reference height for cells identified in textsf{TS_mask}. File name textsf{WindSpeed.tab}
Ts_AvgAir_Temperature Time series table $$^{\circ}C$$ Time series of average temperature at reference height for cells identified in textsf{TS_mask}. File name textsf{AvgTemp.tab}
Ts_MinAir_Temperature Time series table $$^{\circ}C$$ Time series of minimum temperature at reference height for cells identified in textsf{TS_mask}. File name textsf{MinTemp.tab}
Ts_MaxAir_Temperature Time series table $$^{\circ}C$$ Time series of maximum temperature at reference height for cells identified in textsf{TS_mask}. File name textsf{MaxTemp.tab}
Ts_SWE Time series table $$m$$ Time series of soil water equivalent at cells identified in textsf{TS_mask}. File name textsf{SWE.tab}
Ts_Infilt_Cap Time series table $$ms^{-1}$$ Time series of infiltration capacity at cells identified in textsf{TS_mask}. File name textsf{InfiltCap.tab}
Ts_Streamflow Time series table $$m^{3}s^{-1}$$ Time series of streamflow at cells identified in textsf{TS_mask}. File name textsf{Streamflow.tab}
Ts_Soil_Water_Content_Average Time series table $$m^{3}m^{-3}$$ Times series of Average volumetric water content for entire soil profile at cells identified in textsf{TS_mask}. File name textsf{Theta.tab}
Ts_Soil_Water_Content_L1 Time series table $$m^{3}m^{-3}$$ Times series of Average volumetric water content for topsoil at cells identified in textsf{TS_mask}. File name textsf{ThetaL1.tab}
Ts_Soil_Water_Content_L2 Time series table $$m^{3}m^{-3}$$ Times series of Average volumetric water content for second soil layer at cells identified in textsf{TS_mask}. File name textsf{ThetaL2.tab}
Ts_Soil_Water_Content_L3 Time series table $$m^{3}m^{-3}$$ Times series of Average volumetric water content for bottommost soil layer at cells identified in textsf{TS_mask}. File name textsf{ThetaL3.tab}
Ts_Soil_Sat_Deficit Time series table $$m$$ Time series of soil water deficit defined as the water depth needed to saturate cells identified in textsf{TS_mask}. File name textsf{SoilSatDef.tab}
Ts_Soil_ETP Time series table $$ms^{-1}$$ Time series of soil evaporation at cells identified in textsf{TS_mask}. File name textsf{Evap.tab}
Ts_Soil_Net_Rad Time series table $$Wm^{-2}$$ Time series of net radiation for surface layer at cells identified in textsf{TS_mask}. File name textsf{NetRad.tab}
Ts_Soil_LE Time series table $$Wm^{-2}$$ Time series of latent heat for surface layer at cells identified in textsf{TS_mask}. File name textsf{LatHeat.tab}
Ts_Sens_Heat Time series table $$Wm^{-2}$$ Time series of sensible heat for surface layer at cells identified in textsf{TS_mask}. File name textsf{SensHeat.tab}
Ts_Grnd_Heat Time series table $$Wm^{-2}$$ Time series of ground heat at cells identified in textsf{TS_mask}. File name textsf{GrndHeat.tab}
Ts_Snow_Heat Time series table $$Wm^{-2}$$ Time series of heat exchanges with snowpack at cells identified in textsf{TS_mask}. File name textsf{SnowHeat.tab}
Ts_Soil_Temperature Time series table $$^{\circ}C$$ Time series of soil temperature at cells identified in textsf{TS_mask}. File name textsf{SoilTemp.tab}
Ts_Skin_Temperature Time series table $$^{\circ}C$$ Time series of soil skin temperature at cells identified in textsf{TS_mask}. File name textsf{SkinTemp.tab}
Ts_Veget_frac Time series table $$m^{2}m^{-2}$$ Time series of fractions occupied by vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{p[textit{n}].tab}
Ts_Stem_Density Time series table $$stems m^{-2}$$ Time series of stem density of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{num_of_trees[textit{n}].tab}
Ts_Leaf_Area_Index Time series table $$m^{2}m^{-2}$$ Time series of leaf area index of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{lai[textit{n}].tab}
Ts_Canopy_Conductance Time series table $$ms^{-1}$$ Time series of canopy conductance of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{CanopyConduct[textit{n}].tab}
Ts_GPP Time series table $$gCm^{-2}$$ Time series of gross primary production of vegetation type textit{n} during the current time step at cells identified in textsf{TS_mask}. File name textsf{GPP[textit{n}].tab}
Ts_NPP Time series table $$gCm^{-2}$$ Time series of net primary production of vegetation type textit{n} during the current time step at cells identified in textsf{TS_mask}. File name textsf{NPP[textit{n}].tab}
Ts_Basal_Area Time series table $$m^{-2}$$ Time series of total basal area of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{BasalArea[textit{n}].tab}
Ts_Tree_Height Time series table $$m$$ Time series of effective tree height of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{TreeHeight[textit{n}].tab}
Ts_Root_Mass Time series table $$gm^{-3}$$ Time series of root density (mass per volume of soil) of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{RootMass[textit{n}].tab}
Ts_Canopy_Temp Time series table $$^{\circ}C$$ Time series of canopy temperature of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{CanopyTemp[textit{n}].tab}
Ts_Canopy_NetR Time series table $$Wm^{-2}$$ Time series of net radiation at canopy layer of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{CanopyNetRad[textit{n}].tab}
Ts_Canopy_LE Time series table $$Wm^{-2}$$ Time series of latent heat at canopy layer of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{CanopyLatHeat[textit{n}].tab}
Ts_Canopy_Sens_Heat Time series table $$Wm^{-2}$$ Time series of sensible heat at canopy layer of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{CanopySensHeat[textit{n}].tab}
Ts_Canopy_Water_Stor Time series table $$m$$ Time series of water storage at canopy layer of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{CanopyWaterStor[textit{n}].tab}
Ts_Transpiration Time series table $$ms^{-1}$$ Time series of transpiration for canopy layer of vegetation type textit{n} at cells identified in textsf{TS_mask}. File name textsf{Transpiration[textit{n}].tab}