Configuration file keywords¶
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 |
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) |
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} |
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 |
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 |
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 |
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 |
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 |
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 |
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}]} |
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} |