User Tools

Site Tools


start:hype_tutorials:floodplain_tutorial

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
start:hype_tutorials:floodplain_tutorial [2018/06/08 15:36]
cpers
start:hype_tutorials:floodplain_tutorial [2024/02/05 12:45] (current)
cpers
Line 5: Line 5:
 A HYPE floodplain can only be formed from water that flows from a main river or an outlet lake; local streams and internal lakes cannot have an associated floodplain area. The floodplain and its water body are considered as one unique slc-class, and this class' area is the maximum extent of the floodplain. This means that floodplains do not constitute a new slc class and therefore the (previous) class area, that is the water body area (of main river or outlet lake), becomes larger to include the possibility to be flooded. A HYPE floodplain can only be formed from water that flows from a main river or an outlet lake; local streams and internal lakes cannot have an associated floodplain area. The floodplain and its water body are considered as one unique slc-class, and this class' area is the maximum extent of the floodplain. This means that floodplains do not constitute a new slc class and therefore the (previous) class area, that is the water body area (of main river or outlet lake), becomes larger to include the possibility to be flooded.
  
-The modelled floodplains are described mainly by information given in the [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] file and by some parameters in the [[start:​hype_file_reference:​par.txt|par.txt]] file. The information in [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] can be grouped in three categories:+The modelled floodplains are described mainly by information given in the [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] file and by some parameters in the [[start:​hype_file_reference:​par.txt|par.txt]] file. To use the floodplain model its model option is set in [[start:​hype_file_reference:​info.txt|info.txt]]. The information in [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] can be grouped in three categories:
   - area related data; area fractions between floodplain, water bodies and subbasins (including ''​fpfol'',​ ''​fpfmr''​)   - area related data; area fractions between floodplain, water bodies and subbasins (including ''​fpfol'',​ ''​fpfmr''​)
   - elevation thresholds; thresholds between water body and flood plain and between water body and downstream lake/river (''​floll'',​ ''​flolp'',​ ''​flmmr'',​ ''​flmrp'',​ ''​fymol'',​ ''​fymmr''​)   - elevation thresholds; thresholds between water body and flood plain and between water body and downstream lake/river (''​floll'',​ ''​flolp'',​ ''​flmmr'',​ ''​flmrp'',​ ''​fymol'',​ ''​fymmr''​)
-  - recession coefficients;​ coefficients to regulate the flow between water body and floodplain (''​rclfp'',​ ''​rclpl'',​ ''​rclfp'',​ ''​rclpr''​).+  - recession coefficients;​ coefficients to regulate the flow between water body and floodplain (''​rclfp'',​ ''​rcfpl'',​ ''​rcrfp'',​ ''​rcfpr''​).
  
 These input data can be estimated in different ways. The suggestion here is to define those that can be observed/​derived relatively easy from data (area and elevation threshold) and manually calibrate the others (recession coefficients). A method to do that is described below: These input data can be estimated in different ways. The suggestion here is to define those that can be observed/​derived relatively easy from data (area and elevation threshold) and manually calibrate the others (recession coefficients). A method to do that is described below:
Line 20: Line 20:
 |Figure 1: Example of determining fraction of floodplain area (''​fpfmr''​ and ''​fpfol''​). A represents the whole subbasin area, the subscripts lake and mr, outlet lake and main river, respectively.| |Figure 1: Example of determining fraction of floodplain area (''​fpfmr''​ and ''​fpfol''​). A represents the whole subbasin area, the subscripts lake and mr, outlet lake and main river, respectively.|
  
 +  * Introduce the area changes in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]]. A new distribution of the slc-classes'​ area fractions is needed, reducing the non-water classes area in favor of the water areas. Remember that the new olake area (A3 in the example in Fig 1) is composed of the original outlet lake area (<​m>​A3_lake</​m>​) plus the area flooded by the olake (<​m>​{A3}_{flood lake}</​m>​);​ same for the new main river area. The area of the subbasin that is not flooded can be distributed between the non-water classes present in the subbasin before the changes using the same distribution as before or it can be distributed among a subset of these classes. Remember that the sum of all classes'​ area fractions in a subbasin needs to be one.
  
-The input data values needed can be estimated in different ways and also be calibrated in HYPE. Here we describe one method to determine input data. For each subbasin that have a floodplain repeat these steps:+**Elevation thresholds**
  
-  ​- Determine how much of the floodplain area in the subbasin that shall belong to the main river and to the outlet lake (if any). Calculate the slc-fractions for main river and olake classes accordingly ​(e.g. floodplain area of the river + river area together make up the area of the main river class). You may have to reduce the other classes’ slc-fractions so that the sum over the subbasin is still 1. Put the new slc-fractions in [[start:​hype_file_reference:​geodata.txt|GeoData.txt]]. +  ​* The elevation thresholds values are determined using elevation data (e.g. DEM from SRTM). The ones whose names include "​ol"​ are related ​to olakes and the ones with "​mr"​ are related to main river. ​Fig2 summarizes a way to calculate these parameters; **A** (''​flmrr''​ and ''​floll''​), **B** (''​flmrp''​ and ''​flolp'​') and **C** (''​fymol''​ and ''​fymmr''​)**A** is the threshold for flow from water body to floodplain. ​**B** is the threshold for flow from floodplain to water body. **C** is the highest elevation ​of the floodplain, i.e. the water level when the flood reaches its maximum areal extent
-  - Calculate the fraction of the main river and olake classes area that is floodplainThese fractions are entered into [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] variables ​''​fpfmr''​ and ''​fpfol''​. The rest of the classes' ​area is river or lake surface area. +
-  - The slope of the floodplain areas is determined from elevation data. The floodplain is approximated with a linear relation to area (see Figure 8 in [[start:​hype_model_description:​hype_routing#​floodplains|model description]]). The difference between the lowest elevation ​and the highest elevation of the floodplain ​(approximated as linear) are set as water level at maximum areal extent. These are entered into [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] variables ​''​fymmr''​ and ''​fymol''​. +
-  - The threshold for flow from water body to the floodplain ​is given a valueFor an outlet lake this should be normally larger than the lake depth (if outflow occurs before the lake floods over to the floodplain). For a river the threshold can start with a value of zero if nothing better ​is known. These values are set to the [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] variables ''​flmrr''​ and ''​floll''​. +
-  - The threshold for flow from floodplain to water body is given a valueIf nothing better ​is known start with zero. This is set to the [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] variables ''​flmrp''​ and ''​flolp''​. +
-  - The water levels ​of the river/lake and floodplain ​will try to reach equilibriumThe speed of equalization is determined by recession coefficients that say how far to equilibrium ​the water level will reach on one time step. There are separate recession coefficients for flow to and from the floodplain and for main river and outlet lake, in total 4 possible parameters (''​rcrfp'',​ ''​rcfpr'',​ ''​rclfp'',​ ''​rcfpl''​). The recession coefficients must be between zero and one. A recession coefficient of one gives a fast response.+
  
 +|{{:​start:​hype_tutorials:​flood_tut_2.png?​600|}}|
 +|Figure 2: Illustration and definition of elevation (**xi**) and floodplain input (**A**,​**B**,​**C**) variables. Suggestion for determination method of elevation variables.|
 +
 +  * All the **xi** are absolute distances referring to the sea level. **A**, **B**, and **C** are relative distances calculated based on the previous absolute values and the depth of the lake or main river (//​**depth**//​). The depths should be the same as HYPE uses, i.e. 
 +    * for outlet lake: lake depth are found in [[start:​hype_file_reference:​lakedata.txt|LakeData.txt]], ​ [[start:​hype_file_reference:​damdata.txt|DamData.txt]],​ [[start:​hype_file_reference:​geodata.txt|GeoData.txt]] or [[start:​hype_file_reference:​par.txt|par.txt]]
 +    * for main river: depth is calculated from the volume and area of the main river by the equations:
 +    * <m> depth [m]={dead volume}/​{main river area [m^2]} </m>
 +    * <m> {dead volume [m^3]}=deadm*{upstream area [km^2]}*{river length [m]} </m>
 +    * where ''​deadm''​ is a general parameter ([[start:​hype_file_reference:​par.txt|par.txt]]). This parameter needs to be larger than 0, when floodplains are simulated. We took it from E-HYPE and it has a value of 0.005 m2 km-2
 +    * To fulfil the assumptions made by HYPE of the functioning of the floodplain, the following conditions must hold: 1) **A≥0**, 2) **B≥0** 3) **C≥0**. If **x2<​x3** you can set **x3=x2** to fulfill condition 2). If **x4<​x3** you can set **x4=x3+0.1** to fulfill condition 3) with a marginal. ​
 +
 +  * If no elevation information is available, both the threshold for flow from water body to floodplain (''​flmrr''​ and ''​floll''​) and the threshold for flow from floodplain to water body (''​flmrp''​ and ''​flolp''​) can be set to zero as a starting value.  ​
 +
 +  * For ''​modeloption floodmodel 3'',​ two extra input data are needed (''​hrefr''​ and ''​hrefl''​). These are the floodplain threshold in an absolute reference system. For these the value **x2** can be used.
 +
 +**Recession coefficients**
 +
 +  * The water levels of the river/lake and floodplain will try to reach equilibrium. The speed of equalization is determined by recession coefficients that say how far to equilibrium the water level will reach on one time step. There are separate recession coefficients for flow to and from the floodplain and for main river and outlet lake, in total four parameters (''​rcrfp'',​ ''​rcfpr'',​ ''​rclfp'',​ ''​rcfpl''​). The recession coefficients must be between zero and one. A recession coefficient of one gives a fast response. These coefficients usually need to be calibrated.
 +
 +**Model parameters**
 +
 +A few parameters from [[start:​hype_file_reference:​par.txt|par.txt]] need to be mentioned in relation to floodplains. ​
 +
 +  * The parameter used to calculate the dead volume in the main watercourse,​ ''​deadm'',​ should not be changed after/if it has been used to determine the thresholds. The parameter, if larger than zero, lets the river hold a water volume after the flow from the river has stopped. This can be important if you simulate substances. It can also delay the start of flow after a dry (zero-flow) period by being filled up with inflowing water replacing evaporated water during the dry period.
 +  * Lake, river and floodplains evaporates according to the value of the evaporation parameters (''​cevp'',​ ''​ttmp'',​ both land use dependent) for the land use defined for these classes.
 +  * Surface runoff recession coefficient (''​srrcs'',​ land use dependent) should be set to 1 for lake and river classes with floodplains. Then no water will be left standing on the dry part of the floodplain, but will be added to the flooded water.
 +  * There is a possibility to (temporary) replace the some of the data in [[start:​hype_file_reference:​flooddata.txt|FloodData.txt]] with model parameters (in [[start:​hype_file_reference:​par.txt|par.txt]]). This possibility can be used to (automatically) calibrate the elevation thresholds and recession coefficients. The parameters are general parameters, and thus only one floodplain can be in the set-up or all floodplains in the set-up will have the same parameter values during calibration. The use of this calibration parameters are set with a parameter ''​optonoff'',​ and the parameters are called ''​opt1'',​ .., ''​opt8''​. Different values for optonoff will replace different sets of floodplain data. You can replace none (optonoff=0) or all of them (optonoff=1),​ but alternatively replace only thresholds (optonoff=2),​ only recessioncoefficients (optonoff=3) or only maximum extent of floodplain (optonoff=4). ​
 +
 +| ''​opt1'' ​       | replacing ​ ''​floll'' ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 +| ''​opt2'' ​       | replacing ​ ''​flolp'' ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 +| ''​opt3'' ​       | replacing ​ ''​flmrr'' ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 +| ''​opt4'' ​       | replacing ​ ''​flmrp'' ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 +| ''​opt5'' ​       | replacing ​ ''​rclfp''​ and ''​rcrfp'' ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 +| ''​opt6'' ​       | replacing ''​fymol'' ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 +| ''​opt7'' ​       | replacing ​ ''​fymmr'' ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 +| ''​opt8'' ​       | replacing ​ ''​rcfpl''​ and ''​rcfpr'' ​                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 + 
 +The parameters are described in [[start:​hype_file_reference:​par.txt|par.txt]].
start/hype_tutorials/floodplain_tutorial.1528464980.txt.gz · Last modified: 2023/11/16 14:28 (external edit)