Hydraulic output
The output is returned as a list of matrices, all aligned in time, and optionally saved or plotted depending on the arguments stage, what, and detail.
When detail = TRUE, the output contains full time series for all hydraulic variables.
When detail = FALSE, only hmax is returned; damage is returned only if the "damaging" stage is requested.
Output table
When all the stages are selected the analyse_hydraulic() function will return this list:
| Name | Description |
|---|---|
h |
Water height for each room (height above floor) |
z |
Raw absolute water level (includes base elevation) |
eQ |
Flow rate through each opening |
ve |
Flow velocity through each opening |
eS |
Wetted surface area of each opening |
vo |
Water volume for each room |
hmax |
Maximum water height in each room and the corresponding time |
damage |
Estimated flood damage per room and total |
danger |
Danger level when opening a door |
More details in the following sections.
Hydraulic details
For h, eQ, ve, and eS, the pattern is the same and it contains informations about the variable for each time step.
| Time (s) | Name of the rooms / facades or openings |
|---|---|
| 0.0 | hydraulic data |
| 0.5 | hydraulic data |
| 1.0 | hydraulic data |
| 1.5 | hydraulic data |
| … | … |
Maximum water height (hmax)
Summary table that records, for each room and each facade, the peak water height and its time of occurrence:
Name of the rooms / facades and mean |
|
|---|---|
z |
Maximum water height (m) |
t |
Time of the maximum (s) |
Damages (damage)
Returned only if "damaging" is included in the stage argument.
Computed from hmax and the room-specific vulnerability data in the model (model$dam_room_wall), using the function get_hydraulic_damage().
Name of the rooms / facades and total |
|
|---|---|
damage |
Estimated damage (€) |
Dangerosity (danger)
Work in progress. The field is named danger in the returned list (triggered when the "dangerosity" stage is included).
Saved files and graphs
If "save" is included in the stage argument, the results specified in what are written as compressed CSV files to the model’s output directory (model$path$model_output_hydraulic). Only keys that actually exist in the result (intersection of what and the returned list names) are written. If you include graph it will produce basic displays (height and discharge) in the same folder.