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)
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}