The Flood Defense Toolkit Method
Manual
Author: Angiola Fanelli – Thetis S.p.a. – angiola.fanelli@thetis.it
Summary
1 Introduction............................................................................................................. 4
2 Plugin strategies and settings............................................................................... 5
2.1 Necessary and optional data for the plugin.................................................. 6
2.2 Data input into the plug-in............................................................................. 7
3 The plug-in commands.......................................................................................... 9
3.1 EP Elevated Perimeter................................................................................. 9
3.2 EA Elevated Area....................................................................................... 12
3.3 WR – Water Receiving bodies................................................................... 13
3.4 WDS - Water Discharge System (WD)...................................................... 16
3.5 DS – Creation of shut-off valves................................................................ 17
3.6 Report generation and query of spatial elements....................................... 18
4 Custumizable libraries......................................................................................... 20
1 Introduction
The Flood Defense Toolkit Method (FDTM) is a plug-in developed for Qgis (version 2.18.13) and represents a planning tool for urban spaces providing a general assessment on the feasibility of a flood protection strategy in an urban area.
The plug-in includes various types of technological solutions and their mutual combinations, which are site specific.
After the installation, the plug-in is presented with a command bar which shows all the functions provided and described below (Figure 1‑1).
The plug-in is downloadable from the Qgis official repository version 2.18 and it is also available on Github at: https://github.com/angiolafanelli/FloodDefense.
To install the plug-in, simply select from the repository the Flood Defense plugin and press “install”. After the installation, the manual and the libraries settings files are saved in the following path: “C: \ Users \ username \ .qgis2 \ python \ plugins \ fdtm”
Figure 1‑1 Plug-in command bar before the settings.
In the stand-alone versions of Qgis 2.18 for the Windows application system, the file named "qgis_customwidgets.py" is not copied to the correct path of python. If the plug-in does not find this file, an error will occur. To solve the problem, simply copy the "qgis_customwidgets.py" file into the folder:
[QGIS installation folder]: QGIS installation folder QGIS]\apps\python27\lib\site-packages\PyQt4\uic\widget-plugins\qgis_customwidgets.py
The file "qgis_customwidgets.py" is delivered together with the folder containing the installation library Flood Defense Toolkit Method (fdtm).
2 Plug-in strategies and settings
The user can choose one of the following flood protection strategies available in the plug-in:
raise the height of the perimeter which contains an area of particular interest (Elevated Perimeter - EP button);
raise an area of a new lot with a specific height in order to secure it from a flooding event (Elevated Area - EA button);
outline flooding areas or build tanks for the storage of the collected waters in the EP and EA areas previously designed (Water Receptors - WR key). The plug-in also includes the possibility of setting the green roofs over the buildings inside the EP perimeter;
Design and setting different types of pipes to transfer water from EP and EA to receiving bodies WR (WD key);
manage the different interconnection valves of the draining system (DS button).
For each of the strategies listed above, the user can choose among different technical measures listed in the plug-in libraries. Within the plug-in are available customizable libraries, so that the user can choose the more suitable choices in order to protect a specific area. For example, each segment of an elevated protection perimeter can be further elevated by the planner through the use of different technologies: sandbags, concrete walls, inflatable dams, plastic dams etc.
At the end of the process for the identification of the areas that need protection, the plug-in shows the whole map of the chosen works and some synthesis tables, which show also the total costs of the protection measures implemented. The management of the prices is customizable as well with specific libraries of protection measures.
2.1 Necessary and optional data for the plugin
The plug-in requires some cartographic data; some are necessary, some are, instead, optional.
The necessary data are:
DTM (Digital Terrain Model) for altitudes (meters): the higher the resolution of this file the better will be the plug-in results;
Buildings (Buildings layer): polygonal shapefile of the buildings;
Roads layer: linear shapefile of the roads;
Rainfall of the considered event - average precipitation (in millimeters): this data has to be entered in the beginning setting mask.
The optional data managed by the plug-in are:
Land Cover Use layer: polygonal shapefile which describes the characteristics of the land cover and the run-off coefficients associated with the different kind of soils;
Polygonal shapefile containing flooded area;
Drainage System Layer: linear shapefile that describes existing sewers and water drainage systems in the area;
Railways (Railways layer): linear shapefile of the railways.
The plug-in needs that all the above listed data have the same geographical reference system (EPSG).
2.2 Data input into the plug-in
At the end of the shapefiles loading in the QGIS project, the user must save the project with a name and then set up the plug-in setting window by activating the button shown in Figure 2‑1.
Figure 2‑1 starting button for the plug-in setting phase
Figure 2‑2 Plug-in setting window.
The Figure 2‑2 shows the setting window. In this windows the user sets:
Average rainfall (mm): information needed to calculate the amount of Cumulated Water (CW - in m3) during the event within protected perimeters and elevated areas;
all the mandatory and optional shapefiles;
The "default run-off coefficient" which will be used as initial run-off coefficient, in order to calculate the CW.
The run-off coefficient is a non-dimensional parameter correlated to the amount of water that flows out compared to the total amount received by the precipitation. Its value, between 1 and 0, is greater (close to 1) when the area has low soil infiltration and high runoff (waterproof flooring such as asphalt) and lower (close to 0) for permeable and well-vegetated areas (forest, public green).
At the end of the setting phase, all the shapefiles necessary for the plug-in are automatically generated and loaded into the QGIS project. The panel (Figure 2‑3) shows the list of shapefiles that will later be populated by the individual protection measures designed by the user.
Figure 2‑3 List of layers managed by the Plug-in.
Now all the plugin control buttons are activated and appear colored (Figure 2‑4).
Figure 2‑4 Plug-in bar after the conclusion of the input data validation.
3 The plug-in commands
3.1 EP Elevated Perimeter
The first and simplest protection strategy of an area is represented by the creation of different kind of barriers along its perimeter which, therefore, will be higher compared to the protected area level. This strategy can be implemented within the plug-in using the EP button. By activating the EP command and then through the editing button drawing a polygonal feature, the user can identify an area of particular interest to be protected from flooding events. Once the area has been delimitated, and thus the polygon feature is closed, the dialog box shown in Figure 3‑1 will open. This window summarizes:
Geometric, altimetry and soil characteristics of the protected area;
Calculation of the water volumes to be managed;
Choice of the safeguard quota (MPD, in meters);
Technologies for the protection of that specific perimeter (there is a first default technology that can be modified later for each segment of the perimeter).
The Figure 3‑1 shows the two setting windows of the EP characteristics. The user in this window is able to define all the geometric characteristics of the EP polygon just designed (area and perimeter). The window called "unit detail" also displays the minimum (SP) and maximum (MP) of the designed perimeter; in relation to these parameters the user will have to set the maximum protection quota (MPD). Furthermore, if there are roads that intersect the perimeter, the user can define their width (roads width): this data will be used to calculate the total run-off coefficient of the area.
Figure 3‑1 Windows for the definition of the characteristics of the EP areas.
In the second summary window for the EP parameters (“Run-off detail”) the soil coverage percentages (specific for that area) are automatically calculated (if the land use layer is set), or manually entered by the user. With this information, the plug-in returns the value of the average Run-off coefficient of the area and consequently the system is able to calculate the volume of water accumulated (CW) during the event.
An example of the structure and a description of the coding fields for the shapefile “land use cover” is summarized in Table 3‑1.
Table 3‑1 Structure of the Land use cover shapefile.
The codification of the land use field (Desc_RC) must respect the classification shown in Table 3 2.
Table 3‑2 Soil Coverage Classification and related Run off Coefficient (RC) value.
Once all the parameters have been set in these two summary windows, the data will be saved within the shapefile summary table (EP_poligon, Figure 3‑3). The types (TYP) and costs (COST) related to the default technology that can be modified in the next phase, are also displayed.
Figure 3‑2 Elevated Perimeter layer attribute table
Subsequently, the user can set the technological solutions adopted for raising each segment’s height along the perimeter (Figure 3‑3). The user can choose through a drop-down menu “protection measure” one of the technologies within the plugin's Elevated Perimeter library.
Figure 3‑3 Window to define the protection measure adopted in a segment (EP_lines) of the EP perimeter. For each segment of the perimeter, the user can choose a technology to be applied.
3.2 EA Elevated Area
The plug-in allows also the identification of new urban expansion areas that can be imagined at a higher height (Elevated Area) in order to be preserved from flooding events. The command that activates this feature is called EA: when activated, new urban expansion polygons can be defined and set at a higher elevation than the ground level. EA polygons cannot contain houses and streets, because they are considered areas in new urban expansion. Once the EA polygon is closed, the summary window of the just drawn element will open (Figure 3‑4). As seen before (EP case), the user must set the maximum height of the Elevated Area (EA) and, through a drop-down menu, choose the best technology protection for the area (Figure 3‑4).
Figure 3‑4 Window to define the protection measure adopted in an elevated area (EA).
For EA polygons, a single coefficient run-off value can be set and the plug-in is able to calculate the water accumulated inside the polygon after the considered rain event.
3.3 WR – Water Receiving bodies
Once the perimeters and the areas are made safe, the user is called to evaluate how to dispose of the water masses accumulated in these areas. It is possible to plan some different solutions:
1) Tank’s storage;
2) Increase water soil retention though solutions that aim at the run-off coefficient decrease (green roof for example);
3) The identification of "expansion areas" (green areas, basins, floodable parks) for the water storage.
In this phase it is necessary to activate the WR (Water Receptor) key which presents the three above options as shown in Figure 3‑5.
Figure 3‑5 Three possible options for the Water Receptor
When the first item called "point water_rec" is active the user can design the tank for the water. After the button activation, the user can start drawing the tank with the command “edit polygon feature”. There can be different types of cisterns that can be implemented by the plug-in (external, underground, raised etc.) and, again, there is a library that manages the description and the related costs for each cubic meter of water that can be accumulated. The Figure 3‑6 shows the window for the above listed tanks’ characteristics.
Figure 3‑6 Window for setting the tanks’ characteristics.
Another option for storing the water are the green roofs. When the "green roof water_rec" button is active (Figure 3‑6), the user will be able to draw them on the roof of the buildings inside the EP areas. Also in this case the user can choose from several available technologies listed in the customizable libraries. The Figure 3‑7 shows the screen for the identification of the green roofs’ characteristics.
Figure 3‑7 Window for setting the characteristics of the green roofs.
The last type of button is "limited water_rec": the user outlines floodable areas (obviously without any type of buildings) and the plug-in calculates, considering the morphological characteristics of the identified area, how much water can be accumulated inside them. Another library manages the options that the planner can choose: floodable basin, floodable park and floodable garden (see Figure 3‑8).
Figure 3‑8 Window for defining options for "limited water_rec".
3.4 WDS - Water Discharge System (WD)
Once the receiving water areas are defined, it is necessary to create connections between the EP or EA and the drainage areas. The WD (Water Discharge System) button allows to edit the linear shapefile of the WDS: the user designs where to drain the accumulated water. Once this command is activated, the user will be able to draw the linear path from an EA (or EP) area to a WR perimeter (defined in the previous step) and the plug-in returns the calculations of the water balance by "virtually" moving the masses of water to the receptor bodies. Figure 3‑9 shows the screenshot for the characteristics of the connection pipes in order to drain the water.
Figure 3‑9 Window for defining the characteristics of the connecting pipes to move the masses of water.
If there is a river or another water receptor (e.g. the sea) characterized by a significant capacity to receive water volumes, the user can draw a WD line that ends in this kind of receiving body, without the need to draw the receiving WR (Figure 3‑10).
Figure 3‑10 Setting up a receiving body with unlimited capacity
3.5 DS – Creation of shut-off valves
Once the design of the protection zones has been completed, if the shapefile of the sewage drains is available, it is possible to start the automatic fill with the shut-off valves; these valves will be automatically positioned in the intersection points among the perimeter EP, the sewers and the existing drainage system (Figure 3‑11).
Figure 3‑11 Creation of shut-off valves launched with the DS command.
The user can then set the different types of valves by choosing them from the options of the DSV point shapefile (Figure 3‑12).
The types of valves that can be set are:
1) Interruption valve;
2) Non return valve;
3) Pump.
Figure 3‑12 Window for defining the types of valves that can be implemented in the plug-in.
3.6 Report generation and spatial elements’ query
In the plug-in bar shown in Figure 2‑4 there are other buttons of the plug-in which perform the following functions:
1) By activating this button it is possible to query with the mouse all the features created with the plug-in. In particular, it is possible to see all the attributes and, if the user is in the writing mode of that particular shapefile, it is possible to modify it.
2) This button activates or disable the summary window of the tables generated by the plug-in.
3) With this command, the plug-in automatically generates a report containing all the maps and attribute tables of the elements created by the planner user.
4 Custumizable libraries
The technological solutions that the user can apply are customizable and can be increased modifying specific libraries. The file that manages these libraries is an editable text file (with a simple notepad) which is located inside the installation library of the plug-in. Its path is:
"C: \ Users \ username \ .qgis2 \ python \ plugins \ fdtm"
The text file managing the libraries is called "fdtm_definitions.py" and from line 161 to line 216 (see Figure 4‑1) the different libraries developed for each element of the plug-in are listed.
Each line of the code represents a specific technology. The commented and green lines explain the meaning of the code sequence reported in each record.
The structural sequence that describes each element of the EP library is:
1) Item value: design name of the element (in the plug-in it will be called as "Item_value");
2) Item label: label that is displayed in the drop-down menu
3) Validation_rules: Field not significant
3) Mobile cost X unit: Field not significant
4) Fixed cost X Unit: Unit cost per single element of measurement unit
Each element that describes a specific EP must be separated by a comma.
For example, for the EP elements library at the moment you can choose one of the following technologies described by the "item_label" field: "existing" (existing wall), "sand" (sandbag), "airdam" (inflatable dam) and "concrete" (wall to be built).
Libraries for EA, WR, WDS elements are managed in the same way. What changes is the measurement unit to which the unit cost refers. For example, for the EA elements, the cost refers to the price for a cubic meter of raised surface, while for the linear element of the WDS elements it is referred to the linear meter of construction. The implemented valves, also managed with a special library, report the price for each one.
Figure 4‑1 Text file for the management of the libraries within the plug-in.