Contents

Overview:

The Delta Simulation Model II (DSM2) is a one-dimensional mathematical model for dynamic simulation of one-dimensional hydrodynamics, water quality and particle tracking in a network of riverine or estuarine channels. DSM2 can calculate stages, flows, velocities, mass transport processes for conservative and non-conservative constituents including salts, water temperature, dissolved oxygen, and trihalomethane formation potential, and transport of individual particles. DSM2 thus provides a powerful simulation package for analysis of complex hydrodynamic, water quality, and ecological conditions in riverine and estuarine systems.

DSM2 currently consists of three modules, all of which come with the current distribution: HYDRO, QUAL, and PTM. HYDRO simulates one-dimensional hydrodynamics including flows, velocities, depth, and water surface elevations. HYDRO provides the flow input for QUAL and PTM. QUAL simulates one-dimensional fate and transport of conservative and non-conservative water quality constituents given a flow field simulated by HYDRO. PTM simulates pseudo 3-D transport of neutrally buoyant particles based on the flow field simulated by HYDRO. PTM has multiple applications ranging from visualization of flow patterns to simulation of discrete organisms such as fish eggs and larvae.

DSM2 is currently in version 8.1.2. Please send comments to Min Yu minyu@water.ca.gov.

Getting Started

Welcome to DSM2. This section of the documentation is intended to help you acquire and install dsm2, test that it is working and understand the layout of the distribution. After you have taken these steps, you will probably want to tackle the tutorials in the /tutorials folder of the distribution or consult the documentation or grid map in the /documentation folder -- a link has been provided on the start menu to make the documentation easier to find..

Getting DSM2

DSM2 is distributed by the California Department of Water Resources Delta Modeling Section. You can find the model at our delta evaluation tools web site. Currently we distribute Windows executables, tutorials, source code, and a data package with templates for common studies.

Installing DSM2

DSM2 comes with a binary installer, and you should be able to set it up easily with the default installation. There are two limitations:

Recommended Third Party Extras

DSM2 comes with a numerical model and scripting capabilities. It is easier to use the model if you also have a text editor with syntax highlighting, a tool for differencing text files ("diff tool"), a dss viewer and an hdf5 viewer.

Test Launching DSM2

The first step is to see whether the installation was successful. To do this, get a DOS-style command prompt window and type from any location:

C:\>hydro -v
 DSM2-Hydro 8.1.2
 Usage: Hydro input-file

If you got a message like the one above, you are up and running! Your next stop should be Tutorial #1 or Delta Tutorial #1. Look in the /tutorials folder of the distribution. The Basic Tutorials (Tutorial 1-6) feature most of the nuances of the model using a very simple grid and are an excellent way to learn about the model -- including subtleties that are new or caused confusion in the past. The Delta Tutorial series are more applied -- tasks on the Delta. Doing some of Delta Tutorial #1 as a motivator and then tackling the simple ones is a quick way to get a sense of the model.

If instead you get this:

C:\>hydro -v
'hydro' is not recognized as an internal or external command,
operable program or batch file.

...you have a path problem and we need to straighten it out.