Overall, Flood Modeller has four components which help in creating flood models. These are 1D River, 1D Urban, 2D and Hydrology+. These four components can be used singly or in combination, as per the project requirements. Each of these four components have specific file types which are used in creating models. The following section lists and discusses the various file types used in these four components.
1D River
(1D River - Description on what it contains and where you can find the data (survey, existing models, different informational links))
The 1D River is a representation of the physical river system, which treats the river as a linear system of nodes. The model nodes can be of various types - cross-sections, boundary locations, structures such as culverts, spillways and bridges. A 1D River model assists a hydraulic modeller to assess river flows and water levels, to analyse conditions in the baseline scenario and proposed scenario.
In 1D river modelling, a River Network describes the underlying system geometry. This consists of multiple 1D units, or nodes, to provide the physical properties of the river. The geometry and roughness of the river bed is specified in River Section Nodes. These allow the water to be routed between them. The network file has a file extenion .dat and may be opened in the user interface as well as in a text editor.
The Event file contains boundary data such flows, water levels, etc. The event file has a file extension .ied may be opened in the user interface as well as in a text editor.
The Initial Conditions file contains the initial water level information for all river model nodes. A river model requires an initial condition to initiate the model simulation and compute the flow and other variables for the next temporal step. The Initial Conditions file has a file extension .iic or .zzs may be opened in the user interface as well as in a text editor.
The Simulation file is used to put together the information and parameters, all that are required to perform a model simulation. It contains information such as file paths for network file, event file, initial condition file, computation time stepping, result saving interval, run parameters, links to 2D model and 1D Urban model, additional outputs, etc. The Simulation file has a file extension .ief may be opened in the user interface as well as in a text editor.
The various file types used and produced in 1D River models are tabulated below:
Input files
File type | File Definition | How to load |
|---|---|---|
1D network | Collections of connected 1D nodes saved with file extension '.dat', (Flood Modeller 1D model files) |
|
Event data | Subsets of your 1D networks that define variations from the default boundary data (as defined within the network), e.g. different historical flood events (flow time series), rainfall events (1-in-100 year storm) or tidal cycles (water level time-series). These files have extension '.ied' and have a similar format to 1D network (dat) files |
|
Initial conditions | The default initial conditions settings for your 1D network (contained in the dat file) can be overridden by a separate initial conditions file. This is a text file that lists all network nodes and provides key parameter settings for each node. The extension can be 'zzs' or 'iic'. |
|
Spatial data | Both 1D and 2D simulations can use spatial data. 2D models are mainly defined by these data types, whereas 1D models use spatial data for flood mapping (in results post-processing). References to spatial data are defined in the associated model simulation files. You can use this section of the project to store references to your spatial datasets. |
|
Associated files | This section of the project can store any files. This enables you to add references to files that are not part of your models but may be directly relevant to your project, eg photos, reports, presentations. |
|
Simulations | All models types are defined by a simulation file. If you are investigating different scenarios then each one will require a simulation file that references all input data and details your associated simulation settings. 1D simulation files are in text format with extension 'ief'. 2D simulations are xml format ('.xml'). Linked models will use a combination of these files. |
|
Supporting files
File name | Extension | Description |
|---|---|---|
1D event data | .ied | Replaces default boundary data assigned to boundary nodes in the 1D network file. The event file can contain one or multiple boundary nodes from your dat file (QTbdy, HTbdy, hydrology boundaries etc). For each file, you can define an alternative set of inputs, for example a time-series representing a historic flood event or calculated probabilistic data series. You can add one or multiple event files to your 1D simulation. |
1D initial conditions | .zzs/.iic | Replaces default initial conditions data specified in the 1D network file. The initial conditions file can be created as a snapshot output of conditions at a specified time within a model simulation (that uses your 1D network file). This is useful when one simulation follows on from another, for example a flood forecast model might use the previous day’s output as the start point of a new run. Initial conditions can also be generated as an output from a steady state simulation that uses your 1D network. Each 1D simulation can only use one initial conditions file. |
1D sections | .sec | Replaces default cross-section data defined in river section nodes in the 1D network file. The format is the same as an event file (ied file) and each node is defined in the same format as the network file (dat file). This can be used to define different development scenarios quickly for the same model, thus use one base network file and add on different cross-section data to model different options for flood defences. You can add one or multiple section files to your 1D simulation. |
2D topographic features | .shp/.dbf | These files are used to override elevation data defined in the 2D ground grid of a 2D model. Polygon shapefiles contain one or multiple polygon features, coupled with an attribute file (dbf file) that defines revised elevations for each polygon. These can be used to define flow paths 'missed' by the main ground grid, for example, arches under bridges. These inputs can also be used to define different development scenarios quickly for the same model, using one base ground grid and adding on different topographic shapefiles to model different options for flood defences. You can add one or multiple topographic feature files to your 2D simulation. |
2D boundary | .shp/.dbf .ied .dat .csv | Your 2D model will always require some form of boundary condition for each simulation as this defines the water entering the modelled area. These data are always added via a shapefile, which defines the boundary location (as a point, line or polygon). However, there are multiple options available for assigning boundary values to your boundary shapefile. These are:
You can add one or multiple boundaries to your 2D simulation. |
River network-2D link lines | .shp/.dbf | If you want to link a river network to your 2D model, you must add a polyline shapefile to define which 1D nodes link to which 2D grid cells. The shapefile attribute file will contain references to 1D model nodes. Flood Modeller provides tools to help produce this shapefile and associated attribute data. This type of file is a special case of a 2D boundary as the linked 1D model provides an input of water to your 2D model (note the connection is two-way). You can only link your 2D model to one 1D model. However, links may be defined by either one or multiple link line shapefiles. |
River-Urban network link-reference file | .csv | If you want to link a river network to an urban network then - in addition to referencing the urban network file (.inp) in your simulation file (.ief ) - you need to specify a separate text file (csv format) detailing urban and river nodes are connected. Flood Modeller provides tools to define this link file. You can only link your river network to one urban network and links must be defined in a single csv file. |
Urban network-2D link-element file | .shp/.dbf | If you want to link a 2D model to an urban network then - in addition to referencing the urban network file (.inp) in your simulation file (.xml) - you need to specify a separate point shapefile detailing the location of connected urban nodes within your 2D grid. The shapefile attribute file will contain references to the urban nodes. Flood Modeller provides tools to define this link file. You can only link your 2D model to one urban network and links must be defined in a single shapefile. |
1D-TUFLOW link lines | .mif/.mid | If you want to link a 1D model to a TUFLOW 2D model then - in addition to referencing the TUFLOW model in your simulation file (ief file) - you need to specify a separate MapInfo format polyline file detailing the location of 1D nodes within your 2D grid. Flood Modeller provides tools to define this link file. You can only link your 1D model to one TUFLOW model and links must be defined in a single MapInfo file. |
2D roughness grid/roughness polygons | .asc .shp/.dbf | You can specify a global roughness for your 2D model; a constant value applied across the whole modelled area. However, you have the option of adding one or more roughness files to override the global roughness in selected areas or across your whole model. These files can be in raster grid format (.asc files) or polygon shapefile, with roughness defined in the associated attribute file. |
1D river simulation file extensions
There are a number of subsidiary files that may be created or used during a 1D river model simulation. The file types are listed below for reference.
Extension | Contents |
zzs | The results of steady state runs. The format is the same as that of the initial conditions stored in the '.dat' file (ASCII) |
zzn | The output from an unsteady run containing the flow, stage, Froude number, velocity, unit mode and unit state at each saved time step. The latter two are used to store supplementary output such as sluice gate control parameters and weir modes (Binary) |
zzl | The file produced during an unsteady run to store general run parameters and a list of labels (Binary).If 'y' is entered in response to the write 1D Quality file prompt extra data will be appended to this file |
zzr | Tabulated results from an unsteady run |
zzd | Diagnostic output file. This should be inspected if warning messages are displayed which refer to the '.zzd' file (ASCII) |
cal | This user prepared file contains time series data, eg calibration data, for use with the graphical and tabular post processors (ASCII) |
cus | A user prepared file containing data, such as observed levels, for showing on longitudinal sections (ASCII) |
zzm | File containing maximum and minimum levels that occurred during the run (Binary) |
zzt | Diagnostic file containing model network data. Only produced if monitor number 3 is requested (ASCII) |
zzu | Diagnostic file containing certain unit characteristic data. For Flood Modeller this file is usually empty, unless running in boundary mode when rating (Q-h) curves are written here (ASCII) |
ott | File containing data for transfer to the OTTA program. Only produced if 'y' is entered in response to the 'write OTTA file' prompt (Binary) |
zzb | Intermediate results for hydrological boundaries; catchment characteristics and intermediate variables (ASCII) |
zzh | Intermediate results for hydrological boundaries; hydrograph values and volumetric analysis (ASCII) |
1D Urban
The 1D Urban Network is a representation of the urban drainage networks which include features such as pipes, junctions, outfalls, etc. The urban network details are saved in the .inp file. The .inp file is the only input file that is required for running a 1D Urban simulation. Here is a list of information that is saved within the 1D Urban model:
Network data can be obtained from existing models, Municipalities, Local Governments, water management companies, open-access datasets and surveys.
Node and Link labels, dimension, levels, connectivity, depth, location, etc.
Model Settings
General - Model type, choice of infiltration model, routing model, ponding options
Model Start and End date and time
Time steps
Dynamic Wave - model options
Climatology
Temperature
Evaporation
Wind Speed
Snow Melt
Areal Depletion
Adjustments - Temperature adjustment, Evaporation adjustment, Rain multiplier and Soil conductivity multiplier.
There are a few subsidiary files that may be created or used during a 1D urban model simulation. The file types are listed below for reference.
Extension | Contents |
ini | This is a file created parallelly with the .inp file, and contains SWMM5 model feature details |
rpt | This is a report file which contains summary statistics displayed based on results found at every computational time step |
out | It is a binary file which saves model output |
2D
The 2D Model is an attempt to represent flow of excess runoff above the ground surface. Therefore, the model needs data such as ground levels, surface roughness, buildings and roads, rainfall/infiltration, inflow/outflow boundaries and 1D Structures. All the necessary data are linked within a single model file, saved in an XML file format.
Data for the ground surface elevation is generally obtained from LiDAR and ground surveys. Existing models are sometimes helpful in getting a readymade setup, where necessary updates can be made by replacing previous data with new dataset.
2D – Description on what it contains and where you can find the data (survey, existing models, different informational links)
Spatial Data
Boundary File (mention boundary data in 2D is event file in 1D)
Simulation File
Hydrology +
Existing page here can be used as start point (but do better here):