Delta Shell - is an integrated modelling environment. The main idea of the Delta Shell is to provide one application as a platform which can be used to integrate various models and tools. It is achieved by use of a software framework specifically focused to provide a set of components which can be re-used by environmental models.
Recent version of the Delta Shell can be obtained in the Download section. It also includes instructions on installation and minimum system requirements.
In the first development phase SOBEK, Delft3D will be integrated into the Delta Shell.
Delta Shell is currently in active development. Feel free to contact us if you interested in development by sending email to: contact.
This tutorial provides a general overview of the application files as well as brief introduction of the most common user operations, which are available in the program.
When you have finished the installation, doubleclick at your desktop on the icon "Delta Shell - Flow 1D"
=> This will start 'Delta Shell'
How to start with a 1-D model?
When application is started - it automatically creates a default empty project so an user can immediately start filling it in with data, models, etc. A project can be seen as a currently opened user work document. An active project can be stored in SQLite database file format. Eventually DeltaShell may store a model input / output data in a set of NetCDF files located next to the project file. So in total there are two non-proprietary file formats used to store project data.
To start with an empty project:
Rightclick on 'Project1' in the Project Explorer
Choose 'Add' > 'New Model' > 'Flow model 1D'
Doubleclick on 'Network' under 'flow model 1d (1)' in the Project Explorer
A new tab appears with an empty map
To start with an imported SOBEK Model:
Righclick on'Project1' in the Project Explorer
Choose 'Import' > 'SOBEK model'
Navigate to the .LIT Map
Doubleclick on the file 'Network.tp'
How is the user interface organised?
Description of the windows
The main graphical user interface is organized as a set tool windows and document windows. A difference between those two is that the tool windows are always shown on the screen and the document windows are only used to visualize or edit a specific data type.
Typical examples are:
Project Explorer - the main navigation window showing all data contained in the current project in a tree view.
Map Contents - tree-like window showing the list of the GIS layers in the currently opened map.
Message Window - logging windows, messages sent from models or different parts of the system are placed here.
Network Table View - Shows properties of the selected network in a table.
Properties - shows properties for an active selection of the graphical user interface.
Network Contents- allows to view / edit structure of the currently opened (hydro) network.
Time Series Navigator - allows to navigate through times of any time-dependent data.
Adjusting the grafical user interface with dockable windows
You can easily adjust the grafical user interface by dragging the dockable windows with you left mouse button.
Select a window header (e.g. project explorer)
Keep your left mouse button pressed while dragging the window to the place you want
Release your left mouse button
Tip: You can always select a window with the'View'-button on the menu bar
Tip 'Map as leading window' Some users like to use the map as leading window 'Kaart centraal'. Watch next movie to see how you can arrange your dockable windows like that.
How is data organised in the Project Explorer?
All model input and output data can be navigated via the Project Explorer tree view.
How does the map work?
You can present Geografical data in two ways
-Doubleclick on items in the Project Explorer: A new map is opened for this specific item.
-Open a empty map (Rightclick on 'Project', 'New Item' > 'Map') and drag different items from the Project explorer on the map. In this way you can combine information on one map.
With the window 'Map Contents' you can show, hide and adjust layers within the active map.
Conventions usability
In general Delta Shell works with the following convention:
Button/Key
Action
Esc
Stops you action and returns to select tool
Leftclick
Selects an item
Rightclick
Gives a contex menu with possible actions
Doubleclick
Show a map or editor
Note: this is a alpha build. Some functionality is not tested well and may not work at all!
Download
By clicking download I accept the License agreement of Delta Shell - FLOW1D 1.0
For a list of previous versions check Releases page.
Functionality
Delta Shell framework:
Plug-ins can be used to extend modeling environment, for example: FLOW1D.
(OpenSource) GIS supporting vector and raster data and attribute-based styling.
OpenStreetMap can be used as a background layer on a map (with caching).
Project file format based on SQLite database and NetCDF file format.
Graphical user interface supporting toolbar and window docking and tab document interface.
Project Explorer used as a main project data management window.
Network Editor used to model the HydroNetwork on the map (main window).
Network Contents editor showing the HydroNetwork in a tabular way.
Map Contents used to select and set visibility on the map.
Generic Properties editor used to edit simple properties.
Time Series Navigator used to select active time span.
Time SeriesEditor used to edit for example boundary conditions.
Time-dependent data defined along the network.
Logging to file and Messages window.
HydroNetwork:
River channels.
Nodes and branches. Automatic boundary detection.
Routes along the network.
Cross-sections:
Location-based YZ.
Geometry-based XYZ.
Location-based Tabulated River (Height, FlowWidth, StorageWidth).
Composite structures used to host all other types of structures such as:
Weirs, included gated weir.
Pumps (fixed controls).
Bridges (single).
Locations where Lateral inflows can be defined.
Flow model:
Model run parameters such as start-time, end-time, timestep.
Map-based initial conditions editor.
Flow boundary conditions defined as discharge or water level (constant value or time series).
Location-based Flow laterals defined as constant or time series discharge.
Computational grid can be generated.
Output variables: (water) area, depth, flow, level or velocity.
Import / export:
Model: SOBEK 2.12.
HydroNetwork from GIS (Shapefile or GeoDatabase), including attribute data.
YZ-cross-sections can be exported / imported to / from *.csv.
Visualization of model results:
Chart and Table: time series for a selected set of locations and model output variables.
Side view: waterlevel along a route (part of the network), including bottom level extracted from the cross-sections and locations of the cross-sections.
Map: time-dependent layers on a map, with support of custom symbology.
Time Series Navigator.
Tutorials
This tutorial shows how to set up a simple model simulating one-dimensional hydrodynamic flow. You can follow the steps shown in (video)screencasts. Next picture gives an overview of the schematisation you are going to create.
A1: Create a model from scratch using the network editor (Rotterdamse weg)
Open network
Right click on 'Project1' in Project explorer
Choose 'Add > New Model > Flow Model 1D'
Open treeview 'flow model 1d (1)' in Project explorer
Open treeview 'input'
Double click on 'network'
Add a map
Select 'Add new Wms Layer' in Map Contents
Try to zoom at Deltares at rotterdamse weg in Delft (South of Delft)
Draw network
Select icon 'Create New Branch (Point and Click)' to draw a branch
Use icons 'Create Weir', 'Create Pump' and 'Create Cross Section' to finish your hydronetwork
Adjust parameters
Double click on your weir, set crest level -4 m, crest width 10 m,Y offset 8 m
Double click on your pump, set switch-on level at suction side at -5 m and witch-off level at -6 m.
Set Boundary nodes
Select 'node 1' in Boundary Data in Project explorer
Set 'FlowConstant' 30 m3/s
Select 'node 2'
Set 'WaterLevelConstant' on 0 m
Set initial values
Double click on 'initial water level' in Boundary Data in Project explorer
Use icon 'Add network location to network coverage' to define location with initial values
Adjust initial values
Add grid and simulate
Right click on 'computational grid' in Project explorer
Select 'Generate calculation grid locations'
Set maximum length 100 m
Select OK
Double click on 'computational grid' to check your grid
Right click on 'flow model 1d (1)'
Select 'Run Model'
You can also download, unzip and open this ready-to-run project. You can download these files here
Use sideview to view your results
A2: Create a model from scratch using the network editor (SOBEK Tutorial).
For this tutorial you need some data files. You can download these files here Please download and unzip these files before you start with this tutorial.
Set up a network
After installing DeltaShell, you start with a new project. The following screencast shows you how to:
select a type of model
select your background map.
The next screencast shows you how to draw an hydronetwork from scratch. You will have to:
draw 2 branches
add 4 cross-sections
add a simple weir
Now you can adjust the default parameters:
change cross-section geometry.
change weir properties
set boundary conditions
Set initial conditions and computational points
The next screencast shows you how to:
Set initial conditions
Add a computational grid
Simulate and show results
The next screencast shows you how to:
Set simulation period and timestep
Start a simulation
View the results
B: Create a model using SOBEK import
For this tutorial you need some data files. You can download these files here Please download and unzip these files before you start with this tutorial.
Import SOBEK model
Open new project
Right click on project, choose import
Select SOBEK Model
Navigate to SW_MAX_2.lit
Select network.tp
Click on project1 to expand
Double click on network1
Simulate model
Right click on flow model 1d
Select properties
Set output timestep on 01:00:00 and timestep 00:10:00
Right click on flow model 1d
select Run Model
Right click on flow model 1d
Select properties
Set output timestep on 01:00:00 and timestep 00:10:00
Right click on flow model 1d
select Run Model
Show results
Click on output
Double click on water level
Select a location
Click on 'time series' icon
Choose water level
Click on 'Add new network route' icon
Select a location
Select another location
Click on 'Show Sideview for selected route' icon
C: Create a model using GIS import
This tutorial shows how to set up a model by using GIS data.
For this tutorial you need some data files. You can download these files here Please download and unzip these files before you start with this tutorial.
The following screencasts show how to import GIS data from shapefiles into a flow model. The data covers channels, cross sections, pumps and weirs.
Add new model, flow model 1d
Toggle the input directory
Right click network
Choose Hydronetwork from GIS importer
Enter the values in the import dialogs (see screencasts)
Import channels from shape files
Make import mapping/settings file of cross-sections,pumps and weirs from shape files for the importer
Use mapping/settings file of cross-sections,pumps and weirs to import from shape files
Import from Geo-database
Set Computational points
Simulate and show results
As an example a complete model that runs can be downloaded. You can download these files here Please download and unzip these files, click open existing model and run.
This example shows how to edit some precipitation values and run a Rainfall-Runoff model.
In more detail: you can view step-by-step how to start a new project, to open a Urban Rainfall-Runoff model, to edit the precipitation data, to run the model, to view the results, to use docking windows, to edit the input data again and after running the model to view the new results.
Note that the output is automatically available at user defined locations as soon as the result are generated.
Thus, ... just one click action to run and view the results at all your results locations!