This annex presents a nearly comprehensive list of setting options, inputs, and outputs.
The content is organized in the following tables:
- lfoptions: list of available switches to activate optional modules and optional outputs (time series and map formats)
- lfuser: list of variables which are generally defined by the users.
- lfbinding: list of model variables.
- initial variables: list of variables required for model initialization. The table indicates values/maps required by the cold and warm start of both prerun and run)
Table: lfoptions section in OS LISFLOOD settings xml
The table below presents the list of available switches to activate optional modules and optional outputs (time series and map formats). For each option, 1 = ON; 0 = OFF. Default status is 0 = OFF, unless otherwise indicated in the table.
| module | KEY | Type | I/O | Description |
|---|---|---|---|---|
| SETTINGS | TemperatureInKelvin | switch (1 or 0) | nan | Use temperature data in C (=0) or in K (=1) |
| SETTINGS | gridSizeUserDefined | switch (1 or 0) | nan | Get grid size attributes (length, area) from user-defined maps (instead of using map location attributes directly) |
| INFLOW | inflow | switch (1 or 0) | nan | Use inflow hydrographs |
| SOIL | simulatePF | switch (1 or 0) | nan | Calculate pF values from soil moisture |
| LAKES | simulateLakes | switch (1 or 0) | nan | Simulate unregulated lakes |
| RESERVOIRS | simulateReservoirs | switch (1 or 0) | nan | Simulate reservoirs |
| LANDUSE CHANGE | TransientLandUseChange | switch (1 or 0) | nan | Activate reading of time changing land use description |
| WATER ABSTRACTION | TransientWaterDemandChange | switch (1 or 0) | nan | Activate reading of time changing water demand |
| WATER ABSTRACTION | useWaterDemandAveYear | switch (1 or 0) | nan | Use “average” year for water demand and loop it over years |
| TRANSMISSION LOSS | TransLoss | switch (1 or 0) | nan | Activate transmission loss |
| DOUBLE KINEMATIC WAVE | SplitRouting | switch (1 or 0) | nan | Activate double kinematic wave routing |
| MCT DIFFUSIVE WAVE | MCTRouting | switch (1 or 0) | nan | Activate MCT diffusive wave routing |
| WATER ABSTRACTION | wateruse | switch (1 or 0) | nan | Activate water use computation |
| GROUNDWATER | groundwaterSmooth | switch (1 or 0) | nan | Activate smoothing for groundwater |
| WATER ABSTRACTION | wateruseRegion | switch (1 or 0) | nan | Use water regions in water use module |
| IRRIGATION | drainedIrrigation | switch (1 or 0) | nan | Use map of drainage systems to determine return flow (if drained, all percolation to channel within day; if not, all normal soil processes) |
| IRRIGATION | riceIrrigation | switch (1 or 0) | nan | Activate computation for paddy rice irrigation and abstraction |
| EVAPO | openwaterevapo | switch (1 or 0, default = 1) | nan | Compute evaporation from open water |
| INDICATOR | indicator | switch (1 or 0) | nan | Activate computation of indicators (such as WEI, e-flow, etc) |
| SETTINGS | InitLisflood | switch (1 or 0) | nan | Run LISFLOOD initialization run |
| SETTINGS | InitLisfloodwithoutSplit | switch (1 or 0) | nan | Run LISFLOOD initialization run to compute Lzavin.map and skip completely the routing component |
| SETTINGS | ColdStart | switch (1 or 0, default = 1) | nan | Run LISFLOOD Cold Start |
| IO | readNetcdfStack | switch (1 or 0) | nan | Read meteorological data in NetCDF format (Precip, Tavg, ET0, E0,ES0) |
| IO | writeNetcdfStack | switch (1 or 0) | nan | Write NetCDF stacks for output files (the pr.nc is read to get the metadata like projection) |
| IO | writeNetcdf | switch (1 or 0) | nan | Write NetCDF files for END files (single netcdf) |
| DISCHARGE | repDischargeTs | switch (1 or 0, default = 1) rep tss | output | Report discharge time series at gauges |
| LOG | repMBTs | switch (1 or 0) rep tss | output | Report timeseries of absolute cumulative mass balance error |
| STATE | repStateSites | switch (1 or 0) rep tss | output | Report state variables at sites |
| STATE | repRateSites | switch (1 or 0) rep tss | output | Report state variables rates at sites |
| STATE | repStateUpsGauges | switch (1 or 0) rep tss | output | Report timeseries of model variables, averaged over contributing area of each gauging station |
| STATE | repRateUpsGauges | switch (1 or 0) rep tss | output | Report timeseries of model rate variables, averaged over contributing area of each gauging station |
| METEO | repMeteoUpsGauges | switch (1 or 0) rep tss | output | Report timeseries of meteo input data |
| WATER ABSTRACTION | repwateruseGauges | switch (1 or 0) rep tss | output | Report water use ts at gauges |
| WATER ABSTRACTION | repwateruseSites | switch (1 or 0) rep tss | output | Report water use ts at sistes |
| SOIL | repPFUpsGauges | switch (1 or 0) rep tss | output | Report PF ts at gauges |
| SOIL | repPFSites | switch (1 or 0) rep tss | output | Report PF ts at sistes |
| LAKES | repsimulateLakes | switch (1 or 0) rep tss | output | Report time series of lakes |
| RESERVOIRS | repsimulateReservoirs | switch (1 or 0) rep tss | output | Report time series of reservoirs |
| LOG | repBal1 | switch (1 or 0) rep tss | output | Report water balance TS |
| STATE | repStateMaps | switch (1 or 0, default =1) rep maps | output | Report maps of model state variables (as defined by “ReportSteps” variable) |
| STATE | repEndMaps | switch (1 or 0, default =1) rep maps | output | Report maps of model state variables (at last time step) |
| METEO | repPrecipitationMaps | switch (1 or 0) rep maps | output | Report precipitation |
| METEO | repTavgMaps | switch (1 or 0) rep maps | output | Report average temperature maps |
| EVAPO | repETRefMaps | switch (1 or 0) rep maps | output | Report reference evapo-transpiration |
| EVAPO | repESRefMaps | switch (1 or 0) rep maps | output | Report reference soil evaporation |
| EVAPO | repEWRefMaps | switch (1 or 0) rep maps | output | Report reference evaporation of intercepted water |
| ROUTING | repChanCrossSectionMaps | switch (1 or 0) rep maps | output | Report total cross-section area for channels |
| INTERCEPTION | repCumInterCeptionMaps | switch (1 or 0) rep maps | output | Report cumulative interception |
| DISCHARGE | repDischargeMaps | switch (1 or 0) rep maps | output | Report maps of discharge (for each time step) |
| METEO | repDSLRMaps | switch (1 or 0) rep maps | output | Report maps with number of days since the last rainfall event |
| EVAPO | repESActMaps | switch (1 or 0) rep maps | output | Report actual soil evaporation |
| EVAPO | repEWIntMaps | switch (1 or 0) rep maps | output | Report evaporation of intercepted water |
| SNOW | repFrostIndexMaps | switch (1 or 0) rep maps | output | Report frost index maps |
| GROUNDWATER | repGwLossMaps | switch (1 or 0) rep maps | output | Report groundwater loss maps and trransmission loss maps (the later if the module TransLoss is active) |
| GROUNDWATER | repGwPercUZLZMaps | switch (1 or 0) rep maps | output | Report maps of percolation from upper to lower ground water zone (for each time step) |
| INFILTRATION | repInfiltrationMaps | switch (1 or 0) rep maps | output | Report infiltration maps |
| INTERCEPTION | repInterceptionMaps | switch (1 or 0) rep maps | output | Report interception maps |
| LEAF | repLeafDrainageMaps | switch (1 or 0) rep maps | output | Report leaf drainage maps |
| GROUNDWATER | repLZAvInflowMap | switch (1 or 0) rep maps | output | Report lower groundwater zone inflow maps |
| GROUNDWATER | repLZMaps | switch (1 or 0) rep maps | output | Report maps of lower groundwater zone storage (for each time step) |
| GROUNDWATER | repLZOutflowMaps | switch (1 or 0) rep maps | output | Report lower groundwater zone outflow maps |
| PERCOLATION | repPercolationMaps | switch (1 or 0) rep maps | output | Report percolation maps |
| SOIL | repPFMaps | switch (1 or 0) rep maps | output | Report pF and vegetation stress due to low soil moisture |
| SOIL | repPFForestMaps | switch (1 or 0) rep maps | output | Report pF and vegetation stress due to low soil moisture for forest fraction |
| SOIL | repPrefFlowMaps | switch (1 or 0) rep maps | output | Report preferential flow (rapid bypass soil matrix) |
| METEO | repRainMaps | switch (1 or 0) rep maps | output | Report rain excluding snow |
| GROUNDWATER | repSeepSubToGWMaps | switch (1 or 0) rep maps | output | Report flux between sub soil and GW |
| SNOW | repSnowCoverMaps | switch (1 or 0) rep maps | output | Report maps of snow cover (for each time step) |
| SNOW | repSnowMaps | switch (1 or 0) rep maps | output | Report maps of snow (for each time step) |
| SNOW | repSnowMeltMaps | switch (1 or 0) rep maps | output | Report maps of snowmelt (for each time step) |
| SURFACE | repSurfaceRunoffMaps | switch (1 or 0) rep maps | output | Report maps of surface runoff (for each time step) |
| TRANSPIRATION | repTaMaps | switch (1 or 0) rep maps | output | Report transpiration maps |
| SOIL | repThetaMaps | switch (1 or 0) rep maps | output | Reporting of individual model state variables as maps THETA |
| SOIL | repThetaForestMaps | switch (1 or 0) rep maps | output | Reporting of individual model state variables as maps THETA FOREST |
| SOIL | repThetaIrrigationMaps | switch (1 or 0) rep maps | output | Report irrigation mapsrE |
| SOIL | repTotalRunoffMaps | switch (1 or 0) rep maps | output | Report total runoff |
| GROUNDWATER | repUZMaps | switch (1 or 0) rep maps | output | Report maps of upper groundwater zone storage (for each time step) |
| GROUNDWATER | repUZOutflowMaps | switch (1 or 0) rep maps | output | Report maps for upper groundwater zone outflow |
| ROUTING | repWaterDepthMaps | switch (1 or 0) rep maps | output | Report water depth on soil surface |
| EVAPO | ETActMaps | switch (1 or 0) rep maps | output | Report actual evapo-transpiration |
| ROUTING | repFastRunoffMaps | switch (1 or 0) rep maps | output | Report fast runoff = surface + UZ |
| WATER STRESS | repRWS | switch (1 or 0) rep maps | output | Report soil transpiration reduction factor RWP |
| WATER STRESS | repStressDays | switch (1 or 0) rep maps | output | Report soil transpiration reduction factor RWP for forest |
| SOIL | repPF1Maps | switch (1 or 0) rep maps | output | Report PF1 maps |
| SOIL | repPF2Maps | switch (1 or 0) rep maps | output | Report PF2 maps |
| WATER ABSTRACTION | repTotalAbs | switch (1 or 0) rep maps | output | Report total water abstraction |
| WATER ABSTRACTION | repTotalWUse | switch (1 or 0) rep maps | output | Report total water use |
| INDICATOR | repWIndex | switch (1 or 0) rep maps | output | Report indexes and indicators |
Table: lfuser in OS LISFLOOD settings xml
| module | KEY | Type | I/O | Description |
|---|---|---|---|---|
| SETTINGS | PathRoot | path | input | Root directory |
| SETTINGS | MaskMap | map | input | Computation area for Lisflood model |
| SETTINGS | Gauges | map | input | Nominal map with gauge locations (i.e cells for which simulated discharge is written to file(1,2,3 etc) or lat lon (lat2 lon2 …) |
| SETTINGS | netCDFtemplate | map | input | netcdf template used to copy metadata information for writing netcdf $(PathEvapo)/$(PrefixE0) |
| SETTINGS | CalendarDayStart | date | input | Reference Calendar day of the model. It is used inside LISFLOOD code as the reference date for time step id numbers. It MUST be <= first simulation start date. |
| SETTINGS | DtSec | value | input | timestep [seconds]. This is the simulation time interval (86400-day; 3600-hour) |
| SETTINGS | DtSecChannel | value | input | Sub time step used for kinematic wave channel routing [seconds] Within the model, the smallest out of DtSecChannel and DtSec is used Using a value that is smaller than DtSec may result in a better simulation of the overal shape of the calculated hydrograph |
| SETTINGS | StepStart | value/date | input | Step id number or date of the simulation start step. If number is used, it refers to “CalendarDayStart”. For dates, also HH:MM can be set. If they are not set, 00:00 are automatically used. StepStart MUST be >= Calendar DayStart and <= StepEnd |
| SETTINGS | StepEnd | value/date | input | Step id number or date of end time step in simulation. If number is used, it refers to “CalendarDayStart”. For dates, also HH:MM can be set. If they are not set, 00:00 are automatically used. StepStart MUST be <= Calendar DayStart and >= StepStart |
| SETTINGS | ReportSteps | value | input | Time steps at which to write model state maps. Use: #,#,# to specify single step numbers ; #..# to print all state files between one step and another one “endtime” to print state files for final step (to state file in NetCDF file format stack) |
| SETTINGS | NumDaysSpinUp | value | input | Number of days to be discarded when computing the average fluxes in the initialization (prerun) simulation. Recommended: 1095 |
| SETTINGS | NetCDFTimeChunks | value | input | Optimization of netCDF I/O through chunking and caching: how to load the stacks of NetCDF files (e.g. -1 load everything upfront; “auto” let xarray decide) |
| SETTINGS | MapsCaching | value | input | Optimization of netCDF I/O through chunking and caching: True/False define whether input maps are cached/NOT cached |
| SETTINGS | OutputMapsChunks | value | input | Optimization of netCDF I/O through chunking and caching: Dump outputs to disk every X steps (default 1) |
| SETTINGS | OutputMapsDataType | value | input | Optimization of netCDF I/O through chunking and caching: Output data type, may take the following values: “float64” (required for end files and warm start), “float32” |
| GROUNDWATER | UpperZoneTimeConstant | value/map | input calib par | Time constant for the upper groundwater zone [days] default: 10 $(PathParams)/params_UpperZoneTimeConstant.nc Time constant for water in upper zone [days*mm^GwAlpha] Note that units are days if GwAlpha=0 (linear reservoir] |
| GROUNDWATER | LowerZoneTimeConstant | value/map | input calib par | Time constant for the lower groundwater zone [days] This is the average time a water ‘particle’ remains in the reservoir if we had a stationary system (average inflow=average outflow) default: 100 |
| GROUNDWATER | GwPercValue | value/map | input calib par | Maximum rate of percolation going from the upper to the lower groundwater zone [mm day-1] default: 0.5 $(PathParams)/params_GwPercValue.nc |
| GROUNDWATER | GwLoss | value/map | input calib par | Rate of percolation from the lower groundwater zone (groundwater loss) zone [mm day-1]. A value of 0 (closed lower boundary) is recommended as a starting value; default: 0.0 |
| GROUNDWATER | LZThreshold | value/map | input calib par | threshold value below which there is no outflow to the channel |
| INFILTRATION | b_Xinanjiang | value/map | input calib par | Power in Xinanjiang distribution function. [-] It is the power in the infiltration equation. Default: 0.7 |
| INFILTRATION | PowerPrefFlow | value/map | input calib par | Power that controls increase of proportion of preferential flow with increased soil moisture storage. It s the power in the preferential flow equation [-] default: 3.5 $(PathParams)/params_PowerPrefFlow.nc |
| KINEMATIC WAVE | CalChanMan | value/map | input calib par | It is a multiplier that is applied to the Manning’s roughness map of the channel system default: 2.0 $(PathParams)/params_CalChanMan1.nc |
| SNOW | SnowMeltCoef | value/map | input calib par | Snowmelt coefficient [mm/deg C /day]. It is the degree-day factor that controls the rate of snowmelt default: 4.0 $(PathParams)/params_SnowMeltCoef.nc SRM: 0.45 cm/C/day ( = 4.50 mm/C/day), Kwadijk: 18 mm/C/month (= 0.59 mm/C/day) See also Martinec et al., 1998. |
| DOUBLE KINEMATIC WAVE | CalChanMan2 | value/map | input calib par | Multiplier applied to Channel Manning’s n for second routing line default: 3.0 $(PathParams)/params_CalChanMan2.nc |
| DOUBLE KINEMATIC WAVE | QSplitMult | value/map | input calib par | Multiplier applied to average Q to split into a second line of routing |
| MCT DIFFUSIVE WAVE | CalChanMan3 | value/map | input calib par | Multiplier [-] applied to Channel Manning’s n for MCT diffusive wave routing default: 3.0 $(PathParams)/params_CalChanMan3.nc |
| LAKES | LakeMultiplier | value/map | input calib par | Multiplier applied to the lake parameter A |
| RESERVOIRS | ReservoirFloodStorage | value/map | input calib par | default: 0.75. Fraction of the total reservoir storage above which the reservoirs enters the flood control zone. |
| RESERVOIRS | ReservoirFloodOutflowFactor | value/map | input calib par | default: 0.3. Factor of the 100-year return inflow (ReservoirFloodOutflow) that defines the inflow value that switches the reservoir routine to flood control mode, when exceeded. |
| TRANSMISSION LOSSES | TransSub | value/map | input calib par | Transmission loss function parameter |
| ROUTING | ChanBottomWMult, ChanDepthTMult, ChanSMult | value/map | input | Multipliers used to adjust channel geometry. Default = 1.0 (not included in calibration) . |
| SETTINGS | AvWaterRateThreshold | value | input | It defines a critical amount of water that is used as a threshold for resetting the variable Dslr. The threshold is defined as an equivalent intensity in [mm day-1] . Default: 5.0 (not included in calibration) |
| SETTINGS | PathOut | path | input | Directory where all output files are written. It must be an existing directory (if not you will get an error message). |
| SETTINGS | PathInit | path | input | Path of the initial value maps e.g. lzavin.map (org=$(PathRoot)/outPo) It is the directory where the initial files are located, to initialize a “warm” start. It can be also the PathOut directory. |
| SETTINGS | PathMaps | path | input | Maps path it is the directory where all input base maps are located |
| INFLOW | PathInflow | path | input | Inflow path |
| SETTINGS | PathParams | path | input | Calibration parameter path |
| TABLE | PathTables | path | input | Tables path |
| TABLE | PathMapsTables | path | input | Legacy terminology: path to folder where input maps are stored (some of these input maps used to be tables in legacy versions of the code) |
| SOIL | PathSoilHyd | path | input | Maps instead tables for soil hydraulics path Directory where the soil hydraulic property maps are located |
| LANDUSE | PathMapsLandUseChange | path | input | Maps for transient land use changes every 5 years |
| LANDUSE | PathMapsLanduse | path | input | Maps for land use fractions and related land use maps |
| WATER USE | PathWaterUse | path | input | Water use maps path |
| METEO | PathMeteo | path | input | Meteo path Directory where all maps with meteorological input are located (rain, evapo(transpi)ration, temperature) |
| LAI | PathLAI | path | input | Leaf Area Index maps path Directory where you Leaf Area Index maps are located |
| SETTINGS | timestepInit | value/date | input initial | If initial conditions are stored as netCDF stack, this variable sets which time step to use as initial step. It can be either a date (e.g. 1/1/2010) or a number (e.g. 5). If a number is used, it refers to “CalendarDayStart”. It is generally one step back compared to StepStart). timestepInit is ignored if netCDF file is a single netCDF file.. |
| SURFACE | OFDirectInitValue | value/map | input initial/internal | Initial water volume for direct fraction on catchment surface [m3] |
| SURFACE | OFOtherInitValue | value/map | input initial/internal | Initial water volume for other fraction on catchment surface [m3] |
| SURFACE | OFForestInitValue | value/map | input initial/internal | Initial water volume for forest fraction on catchment surface [m3] |
| SNOW | SnowCoverAInitValue | value/map | input initial/internal | It is the initial snow cover on the soil surface in elevation zone A [mm] |
| SNOW | SnowCoverBInitValue | value/map | input initial/internal | It is the initial snow cover on the soil surface in elevation zone B [mm] |
| SNOW | SnowCoverCInitValue | value/map | input initial/internal | It is the initial snow cover on the soil surface in elevation zone C [mm] |
| SNOW | FrostIndexInitValue | value/map | input initial/internal | initial Frost Index value [C day-1] |
| INTERCEPTION | CumIntInitValue | value/map | input initial/internal | cumulative interception [mm] Initial interception storage |
| GROUNDWATER | UZInitValue | value/map | input initial/internal | It is the initial storage in the upper groundwater zone [mm] , other fraction |
| SOIL | DSLRInitValue | value/map | input initial/internal | initial number of days since the last rainfall event [days], , other fraction |
| GROUNDWATER | LZInitValue | value/map | input initial/internal | It is the initial storage in the lower groundwater zone [mm] -9999: use steady-state storage |
| KINEMATIC WAVE | TotalCrossSectionAreaInitValue | value/map | input initial/internal | initial cross-sectional area of flow in channel[m2] -9999: use half bankfull It is the initial cross-sectional area [m2] of the water in the river channels (a substitute for initial discharge, which is directly dependent on this). |
| SOIL | ThetaInit1Value | value/map | input initial/internal | initial soil moisture content layer 1 -9999: use field capacity values It is the initial moisture content [mm3 mm-3] of the supercificial soil layer. Other fraction. |
| SOIL | ThetaInit2Value | value/map | input initial/internal | initial soil moisture content layer 2 -9999: use field capacity values It is the initial moisture content [mm3 mm-3] of the upper soil layer. Other fraction. |
| SOIL | ThetaInit3Value | value/map | input initial/internal | initial soil moisture content layer 3 -9999: use field capacity values It is the initial moisture content [mm3 mm-3] of the lower soil layer. Other fraction. |
| DOUBLE KINEMATIC WAVE | CrossSection2AreaInitValue | value/map | input initial/internal | initial channel cross-sectional area [m2] of the water in the river channels for 2nd routing channel -9999: use 0 |
| DOUBLE KINEMATIC WAVE | PrevSideflowInitValue | value/map | input initial/internal | initial inflow from each pixel to the channel [mm]. A value of -9999 sets the initial amount of sideflow to thye channel to 0 |
| MCT DIFFUSIVE WAVE | PrevCmMCTInitValue | value/map | input initial/internal | Courant number at previous step for MCT diffusive routing [-]. A value of -9999 sets the initial value to 0 |
| MCT DIFFUSIVE WAVE | PrevDmMCTInitValue | value/map | input initial/internal | Reynolds number at previous step for MCT diffusive routing [-]. A value of -9999 sets the initial value to 1 |
| LAKES | LakeInitialLevelValue | value/map | input initial/internal | Initial lake level [m] -9999 sets initial value to steady-state level |
| KINEMATIC WAVE | PrevDischarge | value/map | input initial/internal | initial discharge from previous run only needed for MCT diffusive routing -9999: use 0 It is the initial discharge from previous run [m3s-1] used for MCT diffusive routing. Note that PrevDischarge is the instantaneous discharge referred to the end of the time step. |
| KINEMATIC WAVE | PrevDischargeAvg | value/map | input initial/internal | initial discharge from previous run for lakes, reservoirs and transmission loss only -9999: use 0 It is the initial discharge from previous run [m3s-1] used for lakes, reservoirs and transmission loss Note that PrevDischargeAvg is the average discharge for the last routing sub-step. |
| INTERCEPTION | CumIntForestInitValue | value/map | input initial/internal | cumulative interception forest [mm] |
| GROUNDWATER | UZForestInitValue | value/map | input initial/internal | Initial water storage water in upper groundwater zone for forest [mm] |
| SOIL | DSLRForestInitValue | value/map | input initial/internal | initial number of days since the last rainfall event for forest [days] |
| SOIL | ThetaForestInit1Value | value/map | input initial/internal | initial soil moisture content layer 1 -9999: use field capacity values Forest fraction |
| SOIL | ThetaForestInit2Value | value/map | input initial/internal | initial soil moisture content layer 2 -9999: use field capacity values Forest fraction |
| SOIL | ThetaForestInit3Value | value/map | input initial/internal | initial soil moisture content layer 3 -9999: use field capacity values Forest fraction |
| INTERCEPTION | CumIntIrrigationInitValue | value/map | input initial/internal | cumulative interception irrigation [mm] It is the initial value of the interception storage for the irrigation part of a pixel [mm] |
| GROUNDWATER | UZIrrigationInitValue | value/map | input initial/internal | Initial water storage water in upper groundwater zone for irrigation [mm] |
| SOIL | DSLRIrrigationInitValue | value/map | input initial/internal | initial number of days since the last rainfall event for irrigation [days] |
| SOIL | ThetaIrrigationInit1Value | value/map | input initial/internal | initial soil moisture content layer 1 for irrigation -9999: use field capacity values Irrigated fraction |
| SOIL | ThetaIrrigationInit2Value | value/map | input initial/internal | initial soil moisture content layer 2 for irrigation -9999: use field capacity values Irrigated fraction |
| SOIL | ThetaIrrigationInit3Value | value/map | input initial/internal | initial soil moisture content layer 3 for irrigation -9999: use field capacity values Irrigated fraction |
| SOIL | CumIntSealedInitValue | value/map | input initial/internal | cumulative depression storage [mm] depression storage for surface runoff from imperious surface |
| SOIL | cumSeepTopToSubBOtherEnd | map | input initial/internal | Cumulative flux from second to third soil layer, other land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| SOIL | cumSeepTopToSubBForestEnd | map | input initial/internal | Cumulative flux from second to third soil layer, forest land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| SOIL | cumSeepTopToSubBIrrigatedEnd | map | input initial/internal | Cumulative flux from second to third soil layer, irrigated land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| GROUNDWATER | CumQEnd | map | input initial/internal | Cumulative inflow to the lower groundwater zone. Required for the warm start of the pre-run. |
| GROUNDWATER | TimeSinceStartPrerunChunkEnd | map | input initial/internal | Cumulative discharge. Required for the warm start of the pre-run. |
| GROUNDWATER | LZInflowCumEnd | map | input initial/internal | Cumulative number of days from the start of the prerun. Required for the warm start of the pre-run. |
| METEO | PrefixPrecipitation | prefix | input forcings | prefix precipitation maps |
| METEO | PrefixTavg | prefix | input forcings | prefix average temperature maps |
| EVAPO | PrefixE0 | prefix | input forcings | prefix E0 (potential open water evaporation) maps |
| EVAPO | PrefixES0 | prefix | input forcings | prefix ES0 (potential open bare-soil evaporation)maps |
| EVAPO | PrefixET0 | prefix | input forcings | prefix ET0 (potential reference evapotranspioration) maps |
| LAI | PrefixLAIOther | prefix | input forcings | prefix LAI (Leaf Area Index) maps |
| LAI | PrefixLAIForest | prefix | input forcings | prefix LAI forest maps |
| LAI | PrefixLAIIrrigation | prefix | input forcings | prefix LAI irrigation maps |
| WATER USE | PrefixWaterUseDomestic | prefix | input forcings | prefix domestic water use maps |
| WATER USE | PrefixWaterUseLivestock | prefix | input forcings | prefix livestock water use maps |
| WATER USE | PrefixWaterUseEnergy | prefix | input forcings | prefix energy water use maps |
| WATER USE | PrefixWaterUseIndustry | prefix | input forcings | prefix industry water use maps |
| METEO | PrScaling | value | input par | Multiplier applied to potential precipitation rates. Default = 1.0, not used in calibration. |
| EVAPO | CalEvaporation | value | input par | Multiplier applied to potential evapo(transpi)ration rates. Default = 1.0, not used in calibration. |
| LEAF DRAINAGE | LeafDrainageTimeConstant | value | input par | Time constant for water in interception store [days] . Default = 1.0 |
| EVAPO | kdf | value | input par | Average extinction coefficient for the diffuse radiation flux varies with crop from 0.4 to 1.1 (Goudriaan (1977)) It is used to calculate the extinction coefficient for global radiation kgb. Deafult = 0.72 |
| DEPRESSION STORAGE | SMaxSealed | value | input par | maximum depression storage for water on impervious surface which is not immediatly causing surface runoff [mm] . This storage is emptied by evaporation (EW0). Default = 1.0 |
| SNOW | SnowFactor | value | input par | Multiplier applied to precipitation that falls as snow. Since snow is commonly underestimated in meteorological observation data, setting this multiplier to some value greater than 1 can counteract for this. Estimate from prior data if available, otherwise 1 |
| SNOW | SnowSeasonAdj | value | input par | It is the range [mm C-1 d-1] of the seasonal variation of snow melt. SnowMeltCoef is the average value. |
| SNOW | TempMelt | value | input par | It is the degree-day factor that controls the rate of snowmelt [mm °C-1 day-1] |
| SNOW | TempSnow | value | input par | It is the average temperature below which precipitation is assumed to be snow [°C] |
| SNOW | TemperatureLapseRate | value | input par | Temperature lapse rate with altitude [deg C / m]. It is the temperature lapse rate that is used to estimate average temperature at the centroid of each pixel’s elevation zones [°C m-1]. Default = 0.0065 |
| SNOW | Afrost | value | input par | Daily decay coefficient. It is the frost index decay coefficient [day-1]. It has a value in the range 0-1. Default = 0.97 |
| SNOW | Kfrost | value | input par | Snow depth reduction coefficient, [cm-1]. Default = 0.57 |
| SNOW | SnowWaterEquivalent | value | input par | Snow water equivalent, (based on snow density of 450 kg/m3) (e.g. Tarboton and Luce, 1996) It is the equivalent water depth of a given snow cover, expressed as a fraction [-] |
| SNOW | FrostIndexThreshold | value | input par | Degree Days Frost Threshold (stops infiltration, percolation and capillary rise) Molnau and Bissel found a value 56-85 for NW USA. It is the critical value of the frost index (Eq 2-5) above which the soil is considered frozen [°C day-1] |
| WATER ABSTRACTION | IrrigationEfficiency | value/map | input | Field application irrigation efficiency max 1, ~0.90 drip irrigation, ~0.75 sprinkling |
| WATER ABSTRACTION | ConveyanceEfficiency | value/map | input | onveyance efficiency, around 0.80 for average channel |
| WATER ABSTRACTION | IrrigationType | value | input | IrrigationType (value between 0 and 1) is used here to distinguish between additional adding water until fieldcapacity (value set to 1) or not (value set to 0) |
| WATER ABSTRACTION | IrrigationMult | value | input | Factor to irrigation water demand More than the transpiration is added e.g to prevent salinisation |
| WATER ABSTRACTION | LivestockConsumptiveUseFraction | value | input | Consumptive Use (1-Recycling ratio) for livestock water use (0-1) |
| WATER ABSTRACTION | IndustryConsumptiveUseFraction | value | input | Consumptive Use (1-Recycling ratio) for industrial water use (0-1) |
| WATER ABSTRACTION | EnergyConsumptiveUseFraction | value/map | input | Consumptive Use (1-Recycling ratio) for energy water use (0-1) Source: Torcellini et al. (2003) “Consumptive Use for US Power Production” map advised by Neil Edwards, Energy Industry the UK and small French rivers the consumptive use varies between 1:2 and 1:3, so 0.33-0.50 For plants along big rivers like Rhine and Danube the 0.025 is ok EnergyConsumptiveUseFraction=0.025 |
| WATER ABSTRACTION | DomesticConsumptiveUseFraction | value | input | Consumptive Use (1-Recycling ratio) for domestic water use (0-1) Source: EEA (2005) State of Environment |
| WATER ABSTRACTION | LeakageFraction | value | input | $(PathMaps)/leakage.map Fraction of leakage of public water supply (0=no leakage, 1=100% leakage) |
| WATER ABSTRACTION | LeakageWaterLoss | value | input | The water that is lost from leakage (lost) (0-1) |
| WATER ABSTRACTION | LeakageReductionFraction | value | input | Leakage reduction fraction (e.g. 50% = 0.5 as compared to current Leakage) (baseline=0, maximum=1) |
| WATER ABSTRACTION | WaterSavingFraction | value | input | Water savings fraction (e.g. 10% = 0.1 as compared to current Use (baseline=0, maximum=1) scenwsav.map |
| CALC INDICATOR | Population | map | input | Population per pixel |
| CALC INDICATOR | PopulationMaps | map | input | Population map for TransientLandUseChange |
| CALC INDICATOR | LandUseMask | map | input | Land use mask map to mask out deserts and high mountains (to cover ETdif map, otherwise Sahara etc would pop out; meant as a drought indicator |
| WATER ABSTRACTION | WaterUseMaps | map | output | path and prefix of the reported water use m3 s-1 as a result of demand and availability |
| WATER ABSTRACTION | WaterUseTS | tss | output | Time series of upstream water use at gauging stations |
| WATER ABSTRACTION | StepsWaterUseTS | tss | output | number of loops needed for water use routine |
| WATER ABSTRACTION | maxNoWateruse | value | input | maximum number of loops for calculating the use of water |
| WATER ABSTRACTION | WUsePercRemain | value | input | percentage of water that must remain the channel (after water abstraction) |
| WATER ABSTRACTION / CALC INDICATOR | WUseRegion | map | input | area from which surface water is extracted |
| GROUNDWATER | LZSmoothRange | value | input | length of the window used to smooth the LZ zone [number of cell length] It works ONLY if wateruse=1 |
| GROUNDWATER | GroundwaterBodies | map | input | map of aquifers (0/1), used to smoothen LZ near extraction areas |
| LAKES | LakeMask | map | input | Mask with Lakes from GLWD database |
| TRANSMISSION | TransPower1 | value | input par | Transmission loss function parameter. Default = 2.0 |
| TRANSMISSION | TransArea | value | input par | downstream area taking into account for transmission loss |
| TRANSMISSION / RESERVOIR | UpAreaTrans | map | inpput | upstream area for transmission loss and computation of K coeff in reservoirs module |
| KINEMATIC WAVE | beta | value | input par | It is the routing coefficient in Manning’s equation (2/3). kinematic wave parameter: 0.6 is for broad sheet flow |
| KINEMATIC WAVE | OFDepRef | value | input par | It is a reference flow depth from which the flow velocity of the surface runoff is calculated [mm] Reference depth of overland flow [mm], used to compute overland flow Alpha for kin. wave |
| KINEMATIC WAVE | GradMin | value | input par | Minimum slope gradient of the surface (for kin. wave: slope cannot be 0) It is a lower limit for the slope gradient used in the calculation of the surface runoff flow velocity [m m-1] |
| KINEMATIC WAVE | ChanGradMin | value | input par | Minimum channel gradient (for kin. wave: slope cannot be 0) It is a lower limit for the channel gradient used in the calculation of the channel flow velocity [m m-1] |
| MCT DIFFUSIVE WAVE | ChannelsMCT | map | input | Boolean map with value 1 at channel pixels where MCT is used, and 0 at all other pixels |
| MCT DIFFUSIVE WAVE | ChanGradMaxMCT | value | input par | Maximum channel gradient for channels using MCT routing [-] (for MCT wave: slope cannot be 0) [m m-1] |
| DOUBLE KINEMATIC WAVE | QSplitMult | value | input par | PBchange Multiplier applied to average Q to split into a second line of routing |
| SOIL | CourantCrit | value | input par | Minimum value for Courant condition in soil moisture routine. Always less than or equal to 1. Small values result in improved numerical accuracy, at the expense of increased computing time (more sub-steps needed). If reported time series of soil moisture contain large jumps, lowering CourantCrit should fix this |
| RESERVOIRS | DtSecReservoirs | value | input | Sub time step used for reservoir simulation [s]. Within the model, the smallest out of DtSecReservoirs and DtSec is used. |
| RESERVOIRS | ReservoirInitialFillValue | value/map | input initial/internal | Initial reservoir fill fraction -9999 sets initial fill to normal storage limit if you’re not using the reservoir option, enter some bogus value |
| LAKES | TabLakeAvNetInflowEstimate | table | input | Estimate of average net inflow into lake (=inflow - evaporation) [cu m / s] Used to calculated steady-state lake level in case LakeInitialLevelValue is set to -9999 |
| INFLOW | InflowPoints | map | input forcings | OPTIONAL: nominal map with locations of (measured) inflow hydrographs [cu m / s] |
| INFLOW | QInTS | tss | input forcings | OPTIONAL: observed or simulated input hydrographs as time series [cu m / s] Note that identifiers in time series correspond to InflowPoints map (also optional) |
| SOIL | HeadMax | value | input | Maximum capillary head [cm]. This value is used if Theta equals residual soil moisture content (value of HeadMax is arbitrary). Only needed for pF computation, otherwise doesn’t influence model results at all) |
| EVAPORATION FROM OPEN WATER | maxNoEva | 10 | value | input |
Table: lfbinging section in OS LISFLOOD settings xml
| module | KEY | Type | I/O | Description |
|---|---|---|---|---|
| SNOW AND FROST | Afrost | value | input | Daily decay coefficient. It is the frost index decay coefficient [day-1]. It has a value in the range 0-1. |
| INITIAL CONDITION | AvgDis | map | input initial/internal | $(PathInit)/avgdis.map CHANNEL split routing in two lines Average discharge map [m3/s] |
| EVAPO(TRANSPI)RATION AND INTERCEPTION | AvWaterRateThreshold | value | input | It defines a critical amount of water that is used as a threshold for resetting the variable Dslr. The threshold is defined as an equivalent intensity in [mm day-1] Critical amount of available water (expressed in [mm/day]!), above which ‘Days Since Last Rain’ parameter is set to 1 default: 5.0 (not included in calibration) |
| INFILTRATION | b_Xinanjiang | map | input | Power in Xinanjiang distribution function. [-] It is the power in the infiltration equation. Default: 0.7 |
| ROUTING | beta | value | input | It is the routing coefficient in Manning’s equation (2/3). kinematic wave parameter: 0.6 is for broad sheet flow |
| ROUTING | CalChanMan | value/map | input | It is a multiplier that is applied to the Manning’s roughness map of the channel system default: 2.0 $(PathParams)/params_CalChanMan1.nc |
| ROUTING | CalChanMan2 | value/map | input | Multiplier applied to Channel Manning’s n for second routing line default: 3.0 $(PathParams)/params_CalChanMan2.nc |
| ROUTING | CalChanMan3 | value/map | input | Multiplier [-] applied to Channel Manning’s n for MCT routing default: 3.0 $(PathParams)/params_CalChanMan3.nc |
| TIMESTEP RELATED PARAMETERS | CalendarDayStart | date | input | Reference Calendar day of the model. It is used inside LISFLOOD code as the reference date for time step id numbers. It MUST be <= first simulation start date. |
| EVAPO(TRANSPI)RATION AND INTERCEPTION | CalEvaporation | value | input | Multiplier applied to potential evapo(transpi)ration rates. Default = 1.0, not used in calibration. |
| REPORTED OUTPUT MAPS (END) | ChanCrossSectionEnd | map | output/end | Reported chan cross-section area [m2] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | ChanCrossSectionState | map | output/state | Reported chan cross-section area [m2] |
| ROUTING | ChanGradMaxMCT | map | input | Maximum channel gradient for channels using MCT routing [-] (for MCT wave: slope cannot be 0) |
| ROUTING | ChanGradMin | nan | input | Minimum channel gradient (for kin. wave: slope cannot be 0) It is a lower limit for the channel gradient used in the calculation of the channel flow velocity [m m-1] |
| ROUTING | ChannelsMCT | map | input | Boolean map with value 1 at channel pixels where MCT is used, and 0 at all other pixels |
| REPORTED OUTPUT MAPS (END) | ChanQAvgDtEnd | map | output/end | Reported average discharge on the last routing sub-step [cu m/s] ChanQAvgDt |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | ChanQAvgDtState | map | output/state | Reported average discharge the last routing sub-step [cu m/s] ChanQAvgDt |
| REPORTED OUTPUT MAPS (END) | ChanQEnd | map | output/end | Reported instantaneous discharge at end of computation step [cu m/s] ChanQ |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | ChanQState | map | output/state | Reported instantaneous discharge at end of computation step [cu m/s] ChanQ |
| REPORTED OUTPUT MAPS (END) | ChSideEnd | map | output/end | Reported channel side flow |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | ChSideState | map | output/state | Reported sideflow to channel for first line of routing [m3/s] |
| WATER USE MAPS AND PAR | ConveyanceEfficiency | map | input | onveyance efficiency, around 0.80 for average channel |
| NUMERICS | CourantCrit | value | input | Minimum value for Courant condition in soil moisture routine. Always less than or equal to 1. Small values result in improved numerical accuracy, at the expense of increased computing time (more sub-steps needed). If reported time series of soil moisture contain large jumps, lowering CourantCrit should fix this |
| INITIAL CONDITION | CrossSection2AreaInitValue | value/map | input initial/internal | initial channel crosssection for 2nd routing channel -9999: use 0 |
| REPORTED OUTPUT MAPS (END) | CrossSection2End | map | output/end | Cross section area for split routing [m2] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | CrossSection2State | map | output/state | Cross section area for split routing [m2] |
| REPORTED OUTPUT MAPS (END) | CumInterceptionEnd | map | output/end | Reported interception storage |
| REPORTED OUTPUT MAPS (END) | CumInterceptionForestEnd | map | output/end | Reported interception storage for forest |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | CumInterceptionForestState | map | output/state | Reported interception storage for forest |
| REPORTED OUTPUT MAPS (END) | CumInterceptionIrrigationEnd | map | output/end | Reported interception storage for irrigation |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | CumInterceptionIrrigationState | map | output/state | Reported interception storage |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | CumInterceptionState | map | output/state | Reported interception storage |
| INITIAL CONDITION | CumIntForestInitValue | value/map | input initial/internal | cumulative interception forest [mm] |
| INITIAL CONDITION | CumIntInitValue | value/map | input initial/internal | cumulative interception [mm] |
| INITIAL CONDITION | CumIntIrrigationInitValue | value/map | input initial/internal | cumulative interception irrigation [mm] It is the initial value of the interception storage for the irrigation part of a pixel [mm] |
| REPORTED OUTPUT MAPS (END) | CumIntSealedEnd | map | output/end | Reported depression storage |
| INITIAL CONDITION | CumIntSealedInitValue | value/map | input initial/internal | cumulative depression storage [mm] depression storage for surface runoff from imperious surface |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | CumIntSealedState | map | output/state | Reported depression storage |
| REPORTED OUTPUT MAPS (END) | DischargeEnd | map | output/end | Reported average discharge on the model timestep [m3/s] |
| REPORTED OUTPUT MAPS | DischargeMaps | map | output | Reported average discharge [cu m/s] (average over model timestep) |
| REPORTED OUTPUT MAPS | DisMaps | map (missing) | output | Reported discharge [cu m/s] at the end of a timestep |
| WATER USE MAPS AND PARAMETERS | DomesticConsumptiveUseFraction | value | input | Consumptive Use (1-Recycling ratio) for domestic water use (0-1) Source: EEA (2005) State of Environment |
| INPUT WATER USE MAPS AND PAR | DomesticDemandMaps | map | input | Domestic water abstraction daily maps [mm] |
| REPORTED OUTPUT MAPS (END) | DSLREnd | map | output/end | Reported days since last rain |
| REPORTED OUTPUT MAPS (END) | DSLRForestEnd | map | output/end | Reported days since last rain for forest |
| INITIAL CONDITION | DSLRForestInitValue | value/map | input initial/internal | initial number of days since the last rainfall event for forest [days] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | DSLRForestState | map | output/state | Reported days since last rain for forest |
| INITIAL CONDITION | DSLRInitValue | value/map | input initial/internal | days since last rainfall |
| REPORTED OUTPUT MAPS (END) | DSLRIrrigationEnd | map | output/end | Reported days since last rain for irrigation |
| INITIAL CONDITION | DSLRIrrigationInitValue | value/map | input initial/internal | initial number of days since the last rainfall event for irrigation [days] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | DSLRIrrigationState | map | output/state | Reported days since last rain irrigation |
| REPORTED OUTPUT MAPS (INDIVIDUAL STATE VAR AT EVERY TIME STEP) | DSLRMaps | map | output | Reported days since last rain |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | DSLRState | map | output/state | Reported days since last rain [ndays] |
| TIMESTEP RELATED PARAMETERS | DtSec | map | input | timestep [seconds]. This is the simulation time interval (86400-day; 3600-hour) |
| TIMESTEP RELATED PARAMETERS | DtSecChannel | map | input | Sub time step used for kinematic wave channel routing [seconds] Within the model, the smallest out of DtSecChannel and DtSec is used Using a value that is smaller than DtSec may result in a better simulation of the overal shape of the calculated hydrograph |
| INPUT METEO AND VEG MAPS | E0Maps | map | input | daily reference evaporation (free water) [mm/day] |
| WATER USE MAPS AND PARAMETERS | EnergyConsumptiveUseFraction | map | input | Consumptive Use (1-Recycling ratio) for energy production water use (0-1) |
| INPUT WATER USE MAPS AND PAR | EnergyDemandMaps | map | input | Energy water abstraction daily maps [mm] |
| INPUT METEO AND VEG MAPS | ES0Maps | map | input | daily reference evaporation (soil) [mm/day] |
| REPORTED OUTPUT MAPS (DRIVING METEO VAR) | ESRefMapsOut | map | output | Potential evaporation from bare soil surface [mm per time step] |
| INPUT METEO AND VEG MAPS | ET0Maps | map | input | daily reference evapotranspiration (crop) [mm/day] |
| REPORTED OUTPUT MAPS (DRIVING METEO VAR) | ETRefMapsOut | map | output | Potential reference evapotranspiration [mm per time step] |
| EVAPORATION FROM OPEN WATER | EvaOpenMaps | map (missing) | output | Reported evaporation from open water [mm] |
| EVAPORATION FROM OPEN WATER | EvaOpenTS | tss (missing) | output | Time series of upstream water evaporation from open water at gauging stations |
| REPORTED OUTPUT MAPS (DRIVING METEO VAR) | EWRefMapsOut | map | output | Potential evaporation from open water surface [mm per time step] |
| EVAPORATION FROM OPEN WATER | FracMaxWater | value | input | Percentage of maximum extend of water |
| REPORTED OUTPUT MAPS (END) | FrostIndexEnd | map | output/end | Reported frost index |
| INITIAL CONDITION | FrostIndexInitValue | value/map | input initial/internal | initial frost index value |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | FrostIndexState | map | output/state | Reported frost index |
| SNOW AND FROST | FrostIndexThreshold | map | input | Degree Days Frost Threshold (stops infiltration, percolation and capillary rise) Molnau and Bissel found a value 56-85 for NW USA. It is the critical value of the frost index (Eq 2-5) above which the soil is considered frozen [°C day-1] |
| ROUTING | GradMin | 0 | input | Minimum slope gradient of the surface (for kin. wave: slope cannot be 0) It is a lower limit for the slope gradient used in the calculation of the surface runoff flow velocity [m m-1] |
| GROUNDWATER RELATED PAR | GwLoss | map | input | Maximum loss rate out of Lower response box, expressed as a fraction of lower zone outflow. Fraction [-], range 0-1 A value of 0 (closed lower boundary) is recommended as a starting value Maximum rate of percolation from the lower groundwater zone (groundwater loss) zone [mm day-1]. default: 0.0 |
| GROUNDWATER RELATED PAR | GwPercValue | map | input | Maximum rate of percolation going from the upper to the lower groundwater zone [mm day-1] default: 0.5 $(PathParams)/params_GwPercValue.nc |
| INPUT WATER USE MAPS AND PAR | IndustrialDemandMaps | map | input | Industry water abstraction daily maps [mm] |
| WATER USE MAPS AND PARAMETERS | IndustryConsumptiveUseFraction | map | input | Consumptive Use (1-Recycling ratio) for industrial water use (0-1) |
| WATER USE MAPS AND PAR | IrrigationEfficiency | map | input | Fraction of water re-used in industry (e.g. 50% = 0.5 = half of the water is re-used, used twice (baseline=0, maximum=1 scenruse.map |
| WATER USE MAPS AND PAR | IrrigationMult | map | input | Factor to irrigation water demand More than the transpiration is added e.g to prevent salinisation |
| WATER USE MAPS AND PAR | IrrigationType | map | input | IrrigationType (value between 0 and 1) is used here to distinguish between additional adding water until fieldcapacity (value set to 1) or not (value set to 0) |
| EVAPO(TRANSPI)RATION AND INTERCEPTION | kdf | value | input | Average extinction coefficient for the diffuse radiation flux varies with crop from 0.4 to 1.1 (Goudriaan (1977)) It is used to calculate the extinction coefficient for global radiation kgb. Deafult = 0.72 |
| SNOW AND FROST | Kfrost | map | input | Snow depth reduction coefficient, [cm-1] |
| INPUT METEO AND VEG MAPS | LAIForestMaps | map | input | leaf area index forest [m2/m2] |
| INPUT METEO AND VEG MAPS | LAIIrrigationMaps | map | input | leaf area index irrigation [m2/m2] |
| INPUT METEO AND VEG MAPS | LAIOtherMaps | map | input | leaf area index [m2/m2] |
| REPORTED OUTPUT MAPS (END) | LakeLevelEnd | map | output/end | Reported lake level |
| EVAPORATION FROM OPEN WATER | LakeMask | map | input | Mask with Lakes from GLWD database |
| REPORTED OUTPUT MAPS (END) | LakeStorageM3 | map | output | Reported lake storage |
| WATER USE MAPS AND PAR | LandUseMask | map | input | Land use mask map to mask out deserts and high mountains (to cover ETdif map, otherwise Sahara etc would pop out; meant as a drought indicator |
| EVAPO(TRANSPI)RATION AND INTERCEPTION | LeafDrainageTimeConstant | map | input | Time constant for leaf drainage |
| WATER USE MAPS AND PARAMETERS | LeakageFraction | map | input | Fraction of leakage of public water supply (0=no leakage, 1=100% leakage) |
| WATER USE MAPS AND PAR | LeakageReductionFraction | map | input | Leakage reduction fraction (e.g. 50% = 0.5 as compared to current Leakage) (baseline=0, maximum=1) |
| WATER USE MAPS AND PAR | LeakageWaterLoss | value | input | The water that is lost from leakage (lost) (0-1) |
| IRRIGATION AND WATER ABSTRACTION | LivestockConsumptiveUseFraction | map | input | Consumptive Use (1-Recycling ratio) for livestock water use (0-1) |
| INPUT WATER USE MAPS AND PAR | LivestockDemandMaps | map | input | Livestock water abstraction daily maps [mm] |
| GROUNDWATER RELATED PAR | LowerZoneTimeConstant | map | input | Time constant for the lower groundwater zone [days] |
| INITIAL CONDITION | LZAvInflowMap | value/map | input initial/internal | $(PathInit)/lzavin.map Reported map of average percolation rate from upper to lower groundwater zone (reported for end of simulation) |
| REPORTED OUTPUT MAPS (END) | LZEnd | map | output/end | Reported storage in lower groundwater zone response box [mm] |
| INITIAL CONDITION | LZInitValue | value/map | input initial/internal | water in lower store [mm] -9999: use steady-state storage |
| REPORTED OUTPUT MAPS (INDIVIDUAL STATE VAR AT EVERY TIME STEP) | LZMaps | map | output | Reported storage in lower groundwater zone response box [mm] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | LZState | map | output/state | Reported storage in lower response box [mm] |
| WATER USE MAPS AND PAR | MapIrrigationCropCoef | table | input | Irrigation crop coefficient |
| WATER USE MAPS AND PAR | MapIrrigationCropGroupNumber | table | input | Irrigation crop group number |
| REPORTED OUTPUT MAPS | MaskDischargeMaps | map (missing) | output | Reported discharge [cu m/s] but cut by a discharge mask map |
| SETTINGS | MaskMap | map/value | input | Clone map used to set computation area for Lisflood model It can be 5 values separated by a blank space: col row cellsize xupleft yupleft (3600 1500 0.1 -180 90 -> World) or a map in pcraster format or netcdf If a map is used, information are read from the map. |
| EVAPORATION FROM OPEN WATER | maxNoEva | value | input | Maximum number of loops for calculating evaporation (distance water is taken to satisfy the need of evaporation from open water). Default = 10 |
| WATER USE MAPS AND PAR | maxNoWateruse | value | input | maximum number of loops for calculating the use of water (=distance to the water demand cell) |
| SETTINGS | netCDFtemplate | map | input | netcdf template used to copy metadata information for writing netcdf |
| ROUTING | OFDepRef | 0 | input | It is a reference flow depth from which the flow velocity of the surface runoff is calculated [mm] Reference depth of overland flow [mm], used to compute overland flow Alpha for kin. wave |
| REPORTED OUTPUT MAPS (END) | OFDirectEnd | map | output/end | Reported water volume for direct fraction on catchment surface |
| INITIAL CONDITION | OFDirectInitValue | value/map | input initial/internal | Reported water volume for direct fraction on catchment surface [m^3] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | OFDirectState | map | output/state | Reported water volume for direct fraction on catchment surface [m3] |
| REPORTED OUTPUT MAPS (END) | OFForestEnd | map | output/end | |
| INITIAL CONDITION | OFForestInitValue | value/map | input initial/internal | Reported water volume for other fraction on catchment surface [m^3] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | OFForestState | map | output/state | Reported water volume for forest fraction on catchment surface [m3] |
| REPORTED OUTPUT MAPS (END) | OFOtherEnd | map | output/end | |
| INITIAL CONDITION | OFOtherInitValue | value/map | input initial/internal | Reported water volume for forest fraction on catchment surface [m^3] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | OFOtherState | map | output/state | Reported water volume for other fraction on catchment surface [m3] |
| WATER USE MAPS AND PAR | Population | map | input | Population per pixel |
| WATER USE MAPS AND PAR | PopulationMaps | map | input | Population map for TransientLandUseChange |
| INFILTRATION | PowerPrefFlow | map | input | Power that controls increase of proportion of preferential flow with increased soil moisture storage. It s the power in the preferential flow equation [-] default: 3.5 $(PathParams)/params_PowerPrefFlow.nc |
| INPUT METEO AND VEG MAPS | PrecipitationMaps | map | input | precipitation [mm/day] |
| REPORTED OUTPUT MAPS (DRIVING METEO VAR) | PrecipitationMapsOut | map | output | Precipitation [mm per time step] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | PrevCmMCTEnd | map | output/end | Reported Courant number at previous step for MCT routing |
| INITIAL CONDITION | PrevCmMCTInitValue | value/map | input initial/internal | Courant number at previous step for MCT diffusive routing [-]. A value of -9999 sets the initial value to 0 |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | PrevCmMCTState | map | output/state | Reported Courant number at previous step for MCT routing |
| INITIAL CONDITION | PrevDischarge | value/map | input initial/internal | initial discharge from previous run for MCT diffusive routing -9999: use 0 |
| INITIAL CONDITION | PrevDischargeAvg | value/map | input initial/internal | initial discharge from previous run for lakes, reservoirs and transmission loss only needed for lakes reservoirs and transmission loss -9999: use 0 |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | PrevDmMCTEnd | map | output/end | Reported Raynolds number at previous step for MCT routing |
| INITIAL CONDITION | PrevDmMCTInitValue | value/map | input initial/internal | Reynolds number at previous step for MCT diffusive routing [-]. A value of -9999 sets the initial value to 1 |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | PrevDmMCTState | map | output/state | Reported Reynolds number at previous step for MCT routing |
| INITIAL CONDITION | PrevSideflowInitValue | value/map | input initial/internal | initial inflow from each pixel to the channel [mm]. A value of -9999 sets the initial amount of sideflow to thye channel to 0 |
| EVAPO(TRANSPI)RATION AND INTERCEPTION | PrScaling | value | input | Multiplier applied to potential precipitation rates |
| ROUTING | QSplitMult | value | input | PBchange Multiplier applied to average Q to split into a second line of routing |
| REPORTED OUTPUT MAPS (END) | ReservoirFillEnd | map | output/end | Reported reservoir filling |
| RICE IRRIGATION | RiceFlooding | value | input | water amount in mm per day 10 mm for 10 days (total 10cm water) |
| RICE IRRIGATION | RiceHarvestDay1 | map | input | map with starting day of the year |
| RICE IRRIGATION | RiceHarvestDay2 | map | input | map with starting day of the year |
| RICE IRRIGATION | RicePercolation | value | input | FAO: percolation for heavy clay soils: PERC = 2 mm/day |
| RICE IRRIGATION | RicePlantingDay1 | table | input | map with starting day of the year |
| RICE IRRIGATION | RicePlantingDay2 | table | input | map with starting day of the year |
| EVAPO(TRANSPI)RATION AND INTERCEPTION | SMaxSealed | value | input | maximum depression storage for water on impervious surface which is not immediatly causing surface runoff [mm] This storage is emptied by evaporation (EW0) |
| REPORTED OUTPUT MAPS (END) | SnowCoverAEnd | map | output/end | Reported snow cover in snow zone A [mm] |
| INITIAL CONDITION | SnowCoverAInitValue | value/map | input initial/internal | initial snow depth in snow zone A [mm] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | SnowCoverAState | map | output/state | Reported snow cover in snow zone A [mm] |
| REPORTED OUTPUT MAPS (END) | SnowCoverBEnd | map | output/end | Reported snow cover in snow zone B [mm] |
| INITIAL CONDITION | SnowCoverBInitValue | value/map | input initial/internal | initial snow depth in snow zone B [mm] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | SnowCoverBState | map | output/state | Reported snow cover in snow zone B [mm] |
| REPORTED OUTPUT MAPS (END) | SnowCoverCEnd | map | output/end | Reported snow cover in snow zone C [mm] |
| INITIAL CONDITION | SnowCoverCInitValue | value/map | input initial/internal | initial snow depth in snow zone C [mm] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | SnowCoverCState | map | output/state | Reported snow cover in snow zone C [mm] |
| SNOW AND FROST | SnowFactor | value | input | Multiplier applied to precipitation that falls as snow. Since snow is commonly underestimated in meteorological observation data, setting this multiplier to some value greater than 1 can counteract for this. Estimate from prior data if available, otherwise 1 |
| SNOW AND FROST | SnowMeltCoef | value/map | input | Snowmelt coefficient [mm/deg C /day]. It is the degree-day factor that controls the rate of snowmelt default: 4.0 $(PathParams)/params_SnowMeltCoef.nc SRM: 0.45 cm/C/day ( = 4.50 mm/C/day), Kwadijk: 18 mm/C/month (= 0.59 mm/C/day) See also Martinec et al., 1998. |
| SNOW AND FROST | SnowSeasonAdj | value | input | It is the range [mm C-1 d-1] of the seasonal variation of snow melt. SnowMeltCoef is the average value. |
| SNOW AND FROST | SnowWaterEquivalent | value | input | Snow water equivalent, (based on snow density of 450 kg/m3) (e.g. Tarboton and Luce, 1996) It is the equivalent water depth of a given snow cover, expressed as a fraction [-] |
| TIMESTEP RELATED PARAMETERS | StepEnd | value/date | input | Step id number or date of end time step in simulation. If number is used, it refers to “CalendarDayStart”. For dates, also HH:MM can be set. If they are not set, 00:00 are automatically used. StepStart MUST be <= Calendar DayStart and >= StepStart |
| TIMESTEP RELATED PARAMETERS | StepStart | value/date | input | Step id number or date of the simulation start step. See code |
| WATER USE MAPS AND PAR | StepsWaterUseTS | tss | input | number of loops needed for water use routine |
| REPORTED OUTPUT MAPS | SurfaceSoilMoistureMaps | map (missing) | output | Reported surface soil moisture [%] |
| INPUT METEO AND VEG MAPS | TavgMaps | map | input | average daily temperature [C] |
| REPORTED OUTPUT MAPS (DRIVING METEO VAR) | TavgMapsOut | map | output | Average DAILY temperature [degrees C] |
| SNOW AND FROST | TemperatureLapseRate | value | input | Temperature lapse rate with altitude [deg C / m] It is the temperature lapse rate that is used to estimate average temperature at the centroid of each pixel’s elevation zones [°C m-1] |
| SNOW AND FROST | TempMelt | value | input | It is the degree-day factor that controls the rate of snowmelt [mm °C-1 day-1] |
| SNOW AND FROST | TempSnow | value | input | It is the average temperature below which precipitation is assumed to be snow [°C] |
| REPORTED OUTPUT MAPS (END) | Theta1End | map | output/end | Reported volumetric soil moisture content for soil layer 1 [V/V] |
| REPORTED OUTPUT MAPS (END) | Theta1ForestEnd | map | output/end | Reported volumetric soil moisture content for soil layer 1 for forest [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta1ForestState | map | output/state | theta for soil layer 1 forest fraction |
| REPORTED OUTPUT MAPS (END) | Theta1IrrigationEnd | map | output/end | Reported volumetric soil moisture content for soil layer 1 [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta1IrrigationState | map | output/state | Reported volumetric soil moisture content for soil layer 1 for irrigation[V/V] |
| REPORTED OUTPUT MAPS (INDIVIDUAL STATE VAR AT EVERY TIME STEP) | Theta1Maps | map | output | Reported volumetric soil moisture content for soil layer 1 [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta1State | map | output/state | Reported volumetric soil moisture content for soil layer 1 [V/V] |
| REPORTED OUTPUT MAPS (END) | Theta2End | map | output/end | Reported volumetric soil moisture content for both soil layer 2 [V/V] |
| REPORTED OUTPUT MAPS (END) | Theta2ForestEnd | map | output/end | Reported volumetric soil moisture content for both soil layer 2 for forest [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta2ForestState | map | output/state | theta for soil layer 2 forest fraction |
| REPORTED OUTPUT MAPS (END) | Theta2IrrigationEnd | map | output/end | Reported volumetric soil moisture content for soil layer 2 [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta2IrrigationState | map | output/state | Reported volumetric soil moisture content for both soil layer 2 for irrigation [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta2State | map | output/state | Reported volumetric soil moisture content for both soil layer 2 [V/V] |
| REPORTED OUTPUT MAPS (END) | Theta3End | map | output/end | Reported volumetric soil moisture content for both soil layer 3 [V/V] |
| REPORTED OUTPUT MAPS (END) | Theta3ForestEnd | map | output/end | Reported volumetric soil moisture content for both soil layer 3 [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta3ForestState | map | output/state | theta for soil layer 3 forest fraction |
| REPORTED OUTPUT MAPS (END) | Theta3IrrigationEnd | map | output/end | Reported volumetric soil moisture content for soil layer 3 [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta3IrrigationState | map | output/state | Reported volumetric soil moisture content for both soil layer 3 for irrigation [V/V] |
| REPORTED OUTPUT MAPS (INDIVIDUAL STATE VAR AT EVERY TIME STEP) | Theta3Maps | map | output | Reported volumetric soil moisture content for soil layer 3 [V/V] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | Theta3State | map | output/state | Reported volumetric soil moisture content for both soil layer 3 [V/V] |
| INITIAL CONDITION | ThetaForestInit1Value | value/map | input initial/internal | initial soil moisture content layer 1 -9999: use field capacity values |
| INITIAL CONDITION | ThetaForestInit2Value | value/map | input initial/internal | initial soil moisture content layer 2 -9999: use field capacity values |
| INITIAL CONDITION | ThetaForestInit3Value | value/map | input initial/internal | initial soil moisture content layer 3 -9999: use field capacity values |
| INITIAL CONDITION | ThetaInit1Value | value/map | input initial/internal | initial soil moisture content layer 1 -9999: use field capacity values |
| INITIAL CONDITION | ThetaInit2Value | value/map | input initial/internal | initial soil moisture content layer 2 -9999: use field capacity values |
| INITIAL CONDITION | ThetaInit3Value | value/map | input initial/internal | initial soil moisture content layer 3 -9999: use field capacity values |
| INITIAL CONDITION | ThetaIrrigationInit1Value | value/map | input initial/internal | initial soil moisture content layer 1 for irrigation -9999: use field capacity values |
| INITIAL CONDITION | ThetaIrrigationInit2Value | value/map | input initial/internal | initial soil moisture content layer 2 for irrigation -9999: use field capacity values |
| INITIAL CONDITION | ThetaIrrigationInit3Value | value/map | input initial/internal | initial soil moisture content layer 3 for irrigation -9999: use field capacity values |
| INITIAL CONDITION | timestepInit | value/date | input initial/internal | If initial conditions are stored as netCDF stack, this variable sets which time step to use as initial step. It can be either a date (e.g. 1/1/2010) or a number (e.g. 5). If a number is used, it refers to “CalendarDayStart”. (it is generally one step back compared to StepStart) If missing, netcdf file are read with no reference to ‘time’, either if they are a stack or not. timestepInit is ignored if netCDF file is a single netCDF file.. |
| REPORTED OUTPUT MAPS | TopSoilMoistureMaps | map (missing) | output | Reported Topsoil moisture [%] |
| INITIAL CONDITION | TotalCrossSectionAreaInitValue | value/map | input initial/internal | initial cross-sectional area of flow in channel[m2] -9999: use half bankfull |
| REPORTED OUTPUT MAPS (INDIVIDUAL RATE VAR AT EVERY TIME STEP) | TotalRunoffMaps | map | output | Reported total runoff [mm/∆t] |
| REPORTED OUTPUT MAPS (INDIVIDUAL RATE VAR AT EVERY TIME STEP) | TotaltoChanMaps | map | output | Reported total runoff that enters the channel: groundwater + surface runoff [mm/∆t] |
| TRANSMISSION LOSS | TransArea | value | input | downstream area taking into account for transmission loss |
| TRANSMISSION LOSS | TransPower1 | value | input | Transmission loss function parameter |
| TRANSMISSION LOSS | TransSub | value/map | input | Transmission loss function parameter |
| TRANSMISSION LOSS | UpAreaTrans | map | input | upstream area for transmission loss and k factor of reservoir module |
| GROUNDWATER RELATED PAR | UpperZoneTimeConstant | map | input | Time constant for the upper groundwater zone [days] default: 10 $(PathParams)/params_UpperZoneTimeConstant.nc Time constant for water in upper zone [days*mm^GwAlpha] Note that units are days if GwAlpha=0 (linear reservoir] |
| REPORTED OUTPUT MAPS (END) | UZEnd | map | output/end | Reported storage in upper groundwater zone response box [mm] |
| REPORTED OUTPUT MAPS (END) | UZForestEnd | map | output/end | Reported storage in upper groundwaterzone response box [mm] |
| INITIAL CONDITION | UZForestInitValue | map | input initial/internal | Initial water storage water in upper groundwater zone for forest [mm] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | UZForestState | map | output/state | Reported storage in upper groundwater zone response box [mm] |
| INITIAL CONDITION | UZInitValue | value/map | input initial/internal | water in upper groundwater zone [mm] |
| REPORTED OUTPUT MAPS (END) | UZIrrigationEnd | map | output/end | Reported storage in upper groundwater zone response box for irrigation [mm] |
| INITIAL CONDITION | UZIrrigationInitValue | value/map | input initial/internal | Initial water storage water in upper groundwater zone for irrigation [mm] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | UZIrrigationState | map | output/state | Reported storage in upper groundwater zone response box [mm] |
| REPORTED OUTPUT MAPS (INDIVIDUAL STATE VAR AT EVERY TIME STEP) | UZMaps | map | output | Reported storage in upper groundwater zone response box [mm] |
| REPORTED OUTPUT MAPS (INDIVIDUAL RATE VAR AT EVERY TIME STEP) | UZOutflowMaps | map | output | Reported upper groundwater zone outflow [mm/∆t] |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | UZState | map | output/state | Reported storage in upper groundwater zone response box [mm] |
| REPORTED OUTPUT MAPS (END) | WaterDepthEnd | map | output/end | Reported overlandflow water depth |
| OUPUT | WaterDepthInitValue | map | input | initial overland flow water depth [mm] |
| REPORTED OUTPUT MAPS (INDIVIDUAL STATE VAR AT EVERY TIME STEP) | WaterDepthMaps | map | output | Reported water depth |
| REPORTED OUTPUT MAPS (STATE VARIABLES AT SELECTED TIME STEPS) | WaterDepthState | map | output | Reported overland flow water depth |
| REPORTED OUTPUT MAPS | WaterLevelMaps | map | output | Reported water level [m] |
| WATER USE MAPS AND PAR | WaterReUseFraction | 0 | input | Fraction of water re-used in industry (e.g. 50% = 0.5 = half of the water is re-used, used twice (baseline=0, maximum=1 scenruse.map |
| WATER USE MAPS AND PAR | WaterSavingFraction | 0 | input | Water savings fraction (e.g. 10% = 0.1 as compared to current Use (baseline=0, maximum=1) scenwsav.map |
| WATER USE MAPS AND PAR | WaterUseMaps | map | input | Reported water use m3 s-1 depending on the availability of discharge |
| WATER USE MAPS AND PAR | WaterUseTS | tss | input | Time series of upstream water use at gauging stations |
| EVAPORATION FROM OPEN WATER | WFracOfDay | map | input | table with days for each water use maps 1st column: range of days; 2nd column: suffix of wuse map |
| EVAPORATION FROM OPEN WATER | WFractionMaps | map | input | water use daily maps with a (in this case negative) volume of water [cu m/s] |
| WATER USE MAPS AND PAR | WUsePercRemain | value | input | percentage of water that must remain in a grid cell and is not withdrawn by water use e.g. 0.2 = 20 percent of discharge is not taken out |
| WATER USE MAPS AND PAR | WUseRegion | map | input | water use region |
| ROUTING | ChanBottomWMult, ChanDepthTMult, ChanSMult | value/map | input | Multipliers used to adjust channel geometry. Default = 1.0 (not included in calibration) . |
| INITIAL CONDITION | CumQEnd | map | output | Cumulative inflow to the lower groundwater zone. Required for the warm start of the pre-run. |
| INITIAL CONDITION | CumQInit | map | input initial/internal | Cumulative inflow to the lower groundwater zone. Required for the warm start of the pre-run. |
| INITIAL CONDITION | cumSeepTopToSubBForestEnd | map | output | Cumulative flux from second to third soil layer, forest land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| INITIAL CONDITION | cumSeepTopToSubBForestInit | value/map | input initial/internal | Cumulative flux from second to third soil layer, forest land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| INITIAL CONDITION | cumSeepTopToSubBIrrigationEnd | map | output | Cumulative flux from second to third soil layer, irrigated land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| INITIAL CONDITION | cumSeepTopToSubBIrrigationInit | value/map | input initial/internal | Cumulative flux from second to third soil layer, irrigated land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| INITIAL CONDITION | cumSeepTopToSubBOtherEnd | map | output | Cumulative flux from second to third soil layer, other land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| INITIAL CONDITION | cumSeepTopToSubBOtherInit | value/map | input initial/internal | Cumulative flux from second to third soil layer, other land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| INITIAL CONDITION | LZInflowCumEnd | map | input initial/internal | Cumulative number of days from the start of the prerun. Required for the warm start of the pre-run. |
| INITIAL CONDITION | LZInflowCumInit | value/map | input initial/internal | Cumulative number of days from the start of the prerun. Required for the warm start of the pre-run. |
| SETTINGS | MapsCaching | value | input | Optimization of netCDF I/O through chunking and caching: True/False define whether input maps are cached/NOT cached |
| SETTINGS | NetCDFTimeChunks | value | input | Optimization of netCDF I/O through chunking and caching: how to load the stacks of NetCDF files (e.g. -1 load everything upfront; “auto” let xarray decide) |
| SETTINGS | NumDaysSpinUp | value | input | Number of days to be discarded when computing the average fluxes in the initialization (prerun) simulation. Recommended: 1095 |
| SETTINGS | OutputMapsChunks | value | input | Optimization of netCDF I/O through chunking and caching: Dump outputs to disk every X steps (default 1) |
| SETTINGS | OutputMapsDataType | value | input | Optimization of netCDF I/O through chunking and caching: Output data type, may take the following values: “float64” (required for end files and warm start), “float32” |
| DOUBLE KINEMATIC WAVE | QSplitMult | value/map | input calib par | Multiplier applied to average Q to split into a second line of routing |
| RESERVOIRS | ReservoirFloodOutflowFactor | value/map | input calib par | default: 0.3. Factor of the 100-year return inflow (ReservoirFloodOutflow) that defines the inflow value that switches the reservoir routine to flood control mode, when exceeded. |
| RESERVOIRS | ReservoirFloodStorage | value/map | input calib par | default: 0.75. Fraction of the total reservoir storage above which the reservoirs enters the flood control zone. |
| SOIL INIT | SeepTopToSubBAverageForestMap | map | input initial/internal | Reported infiltration from the soil layer 2 to soil layer 3, forest land cover fraction, average flux over the simulation period |
| SOIL INIT | SeepTopToSubBAverageIrrigationMap | map | input initial/internal | Reported infiltration from the soil layer 2 to soil layer 3, irrigation land cover fraction, average flux over the simulation period |
| SOIL INIT | SeepTopToSubBAverageOtherMap | map | input initial/internal | Reported infiltration from the soil layer 2 to soil layer 3, other land cover fraction, average flux over the simulation period |
| INITIAL CONDITION | TimeSinceStartPrerunChunkEnd | map | output | Cumulative discharge. Required for the warm start of the pre-run. |
| INITIAL CONDITION | TimeSinceStartPrerunChunkInit | map | input initial/internal | Cumulative discharge. Required for the warm start of the pre-run. |
Table: Variables required for model initialization.
| section (XML) | KEY | Type | Cold Start: prerun and run | Warm Start: preun | Warm Start: run | Description |
|---|---|---|---|---|---|---|
| lfuser | CrossSection2AreaInitValue | value/map | -9999 | ch2cro.end.nc | ch2cro.end.nc | initial channel crosssection for 2nd routing channel -9999: use 0 |
| lfuser | CumIntForestInitValue | value/map | 0 | cumf.end.nc | cumf.end.nc | cumulative interception forest [mm] |
| lfuser | CumIntInitValue | value/map | 0 | cum.end.nc | cum.end.nc | cumulative interception [mm] |
| lfuser | CumIntIrrigationInitValue | value/map | 0 | cumi.end.nc | cumi.end.nc | cumulative interception irrigation [mm] It is the initial value of the interception storage for the irrigation part of a pixel [mm] |
| lfuser | CumIntSealedInitValue | value/map | 0 | cseal.end.nc | cseal.end.nc | cumulative depression storage [mm] depression storage for surface runoff from imperious surface |
| lfuser | DSLRForestInitValue | value/map | 1 | dslf.end.nc | dslf.end.nc | initial number of days since the last rainfall event for forest [days] |
| lfuser | DSLRInitValue | value/map | 1 | dslr.end.nc | dslr.end.nc | days since last rainfall |
| lfuser | DSLRIrrigationInitValue | value/map | 1 | dsli.end.nc | dsli.end.nc | initial number of days since the last rainfall event for irrigation [days] |
| lfuser | FrostIndexInitValue | value/map | 0 | frost.end.nc | frost.end.nc | initial frost index value |
| lfuser | LZAvInflowMap | value/map | run: lzavin.nc; prerun: not needed | Not needed | Not needed | Reported map of average percolation rate from upper to lower groundwater zone (reported for end of simulation) |
| lfuser | OFDirectInitValue | value/map | 0 | ofdir.end.nc | ofdir.end.nc | Reported water volume for direct fraction on catchment surface [m^3] |
| lfuser | OFForestInitValue | value/map | 0 | offor.end.nc | offor.end.nc | Reported water volume for other fraction on catchment surface [m^3] |
| lfuser | OFOtherInitValue | value/map | 0 | ofoth.end.nc | ofoth.end.nc | Reported water volume for forest fraction on catchment surface [m^3] |
| lfuser | PrevCmMCTInitValue | value/map | -9999 | prevcm.end.nc | prevcm.end.nc | Courant number at previous step for MCT diffusive routing [-]. A value of -9999 sets the initial value to 0 |
| lfuser | PrevDischarge | value/map | -9999 | chanq.end.nc | chanq.end.nc | initial discharge from previous run for MCT diffusive routing -9999: use 0 |
| lfuser | PrevDischargeAvg | value/map | -9999 | chanqavgdt.end.nc | chanqavgdt.end.nc | initial discharge from previous run for lakes, reservoirs and transmission loss only needed for lakes reservoirs and transmission loss -9999: use 0 |
| lfuser | PrevDmMCTInitValue | value/map | -9999 | prevdm.end.nc | prevdm.end.nc | Reynolds number at previous step for MCT diffusive routing [-]. A value of -9999 sets the initial value to 1 |
| lfuser | PrevSideflowInitValue | value/map | -9999 | chside.end.nc | chside.end.nc | initial inflow from each pixel to the channel [mm]. A value of -9999 sets the initial amount of sideflow to thye channel to 0 |
| lfuser | SnowCoverAInitValue | value/map | 0 | scova.end.nc | scova.end.nc | initial snow depth in snow zone A [mm] |
| lfuser | SnowCoverBInitValue | value/map | 0 | scovb.end.nc | scovb.end.nc | initial snow depth in snow zone B [mm] |
| lfuser | SnowCoverCInitValue | value/map | 0 | scovb.end.nc | scovb.end.nc | initial snow depth in snow zone C [mm] |
| lfuser | ThetaForestInit1Value | value/map | thf1.end.nd, prerun outpit (preferred0); -9999 | thf1.end.nc | thf1.end.nc | initial soil moisture content layer 1, forest -9999: use field capacity values |
| lfuser | ThetaForestInit2Value | value/map | thf2.end.nd, prerun outpit (preferred0); -9999 | thf2.end.nc | thf2.end.nc | initial soil moisture content layer 2, forest -9999: use field capacity values |
| lfuser | ThetaForestInit3Value | value/map | thf3.end.nd, prerun outpit (preferred0); -9999 | thf3.end.nc | thf3.end.nc | initial soil moisture content layer 3, forest -9999: use field capacity values |
| lfuser | ThetaInit1Value | value/map | th1.end.nd, prerun outpit (preferred0); -9999 | th1.end.nc | th1.end.nc | initial soil moisture content layer 1, other fraction -9999: use field capacity values |
| lfuser | ThetaInit2Value | value/map | th2.end.nd, prerun outpit (preferred0); -9999 | th2.end.nc | th2.end.nc | initial soil moisture content layer 2, other fraction -9999: use field capacity values |
| lfuser | ThetaInit3Value | value/map | th3.end.nd, prerun outpit (preferred0); -9999 | th3.end.nc | th3.end.nc | initial soil moisture content layer 3, other fraction -9999: use field capacity values |
| lfuser | ThetaIrrigationInit1Value | value/map | thi1.end.nd, prerun outpit (preferred0); -9999 | thi1.end.nc | thi1.end.nc | initial soil moisture content layer 1, irrigation -9999: use field capacity values |
| lfuser | ThetaIrrigationInit2Value | value/map | thi2.end.nd, prerun outpit (preferred0); -9999 | thi2.end.nc | thi2.end.nc | initial soil moisture content layer 2, irrigation -9999: use field capacity values |
| lfuser | ThetaIrrigationInit3Value | value/map | thi3.end.nd, prerun outpit (preferred0); -9999 | thi3.end.nc | thi3.end.nc | initial soil moisture content layer 3, irrigation -9999: use field capacity values |
| lfuser | timestepInit | value/date | Not Needed | value/date | value/date | If initial conditions are stored as netCDF stack, this variable sets which time step to use as initial step. It can be either a date (e.g. 1/1/2010) or a number (e.g. 5). If a number is used, it refers to “CalendarDayStart”. (it is generally one step back compared to StepStart) If missing, netcdf file are read with no reference to ‘time’, either if they are a stack or not. timestepInit is ignored if netCDF file is a single netCDF file.. |
| lfuser | TotalCrossSectionAreaInitValue | value/map | -9999 | chcro.end.nc | chcro.end.nc | initial cross-sectional area of flow in channel[m2] -9999: use half bankfull |
| lfuser | UZForestInitValue | map | 0 | uzf.end.nc | uzf.end.nc | Initial water storage water in upper groundwater zone for forest [mm] |
| lfuser | UZInitValue | value/map | 0 | uz.end.nc | uz.end.nc | water in upper groundwater zone [mm] |
| lfuser | UZIrrigationInitValue | value/map | 0 | uzi.end.nc | uzi.end.nc | Initial water storage water in upper groundwater zone for irrigation [mm] |
| lfuser | cumSeepTopToSubBForestInit | value/map | 0 | cumSeepTopToSubBForest.end.nc | Not needed | Cumulative flux from second to third soil layer, forest land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| lfuser | cumSeepTopToSubBIrrigationInit | value/map | 0 | cumSeepTopToSubBIrrigated.end.nc | Not needed | Cumulative flux from second to third soil layer, irrigated land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| lfuser | cumSeepTopToSubBOtherInit | value/map | 0 | cumSeepTopToSubBOther.end.nc | Not needed | Cumulative flux from second to third soil layer, other land cover fraction. Prerun output, used to initilize soil water content in the cold start. |
| lfuser | LZInflowCumInit | map | 0 | LZInflowCum.end.nc | Not needed | Cumulative number of days from the start of the prerun. Required for the warm start of the pre-run. |
| lfuser | TimeSinceStartPrerunChunkInit | map | 0 | TimeSinceStartPrerunChunk.end.nc | Not needed | Cumulative discharge. Required for the warm start of the pre-run. |
| lfuser | CumQInit | map | 0 | CumQEnd.nc | Not needed | Cumulative inflow to the lower groundwater zone. Required for the warm start of the pre-run. |
| lfbinding | SeepTopToSubBAverageForestMap | map | run: SeepTopToSubBAverageForestMap.nc; prerun: not needed | Not needed | Not needed | Reported infiltration from the soil layer 2 to soil layer 3, forest land cover fraction, average flux over the simulation period |
| lfbinding | SeepTopToSubBAverageIrrigationMap | map | run: SeepTopToSubBAverageIrrigationMap.nc; prerun: not needed | Not needed | Not needed | Reported infiltration from the soil layer 2 to soil layer 3, irrigation land cover fraction, average flux over the simulation period |
| lfbinding | SeepTopToSubBAverageOtherMap | map | run: SeepTopToSubBAverageOtherMap.nc; prerun: not needed | Not needed | Not needed | Reported infiltration from the soil layer 2 to soil layer 3, other land cover fraction, average flux over the simulation period |
| lfbinding | AvgDis | map | run: avgdis.nc; prerun: not needed | Not needed | Not needed | Reported map of average discharge (reported for end of simulation) |
| lfbinding | LZInitValue | value/map | -9999 | lz.end.nc | lz.end.nc | water in lower store [mm] -9999: use steady-state storage |