SSIIM

SSIIM is an abbreviation for Sediment Simulation In Intakes with Multiblock option. The program is designed to be used in teaching and research for hydraulic/river/sedimentation engineering. It solves the Navier-Stokes equations using the control volume method with the SIMPLE algorithm and the k-epsilon turbulence model. It also solves the convection-diffusion equation for sediment transport, using van Rijn's formula for the bed boundary. Also, a water quality module is included.

The program is not made for the marine environment, and it can not compute any effects of stratification due to salinity gradients.

The program has an interactive graphical grid editor creating a structured grid. The post-processor includes vector graphics, contour plots, profiles etc. which can run simultaneously with the solver, enabling viewing of intermediate result.

There are two versions of the program: SSIIM 1 uses a structured grid and SSIIM 2 uses an unstructured grid. SSIIM 1 is easier to use and the grid is simpler. It is recommended to start with this version. If wetting/drying is to be modelled, it is necessary to use SSIIM 2. Otherwise, SSIIM 1 is recommended. The User's Manual gives more information about the versions.

Operating systems

The programs have been compiled on different operating systems. The main user interface is made in Windows. The Windows version has been reported to also run on Linux using Wine. Native versions compiled on Linux have also been made, but they do not have a user interface. SSIIM versions have also been made for 64 bits operating systems. These versions are necessary for modelling grids larger than around 4 million cells. There is also an older version of SSIIM for OS/2. The input files for the examples included with the OS/2 version can be used on the other operating systems.

Support

As an academic institution we unfortunately do not have the resources to give user support for SSIIM. If you have problems, we recommend that you read the documentation carefully. If you need user support for your CFD work, we recommend that you use a commercial CFD program, for example one of those listed here.

Disclaimer and legal matters:

Software statistics says an average computer program will have 2-20 bugs pr. 1000 program lines. The SSIIM programs will therefore have between 100-1000 bugs. New versions of the SSIIM program have not been thorougly tested before uploaded on this web page.

I disclaim all warranties with regard to this software and the information in this document, whether expressed or implied, including without limitation, warranties of fitness and merchantability. In no event shall I or my employers, be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortuous action, arising out of or in connection with the use or performance of this software. It is not recommended that the program be used for solving a problem whose incorrect solution could lead to injury to a person or loss of property. If you do use the program in such a manner, it is at your own risk. It is necessary to know that to understand and interpret the program results properly it is required that the user have knowledge and experience in computational fluid dynamics and hydraulic engineering.

If the user publish results where the SSIIM model has been used, the user should include in the publication a statement that says that the SSIIM model has been used.

Provided the user complies with the above statements, the program can be used freely. The program can be distributed freely on condition that this disclaimer and an unchanged copy of the User's Manual is distributed with the program.

Download the SSIIM User's Manual (20. June 2014, 1.5 MB PDF file)

Download SSIIM 1 for Windows (22. August 2013, v. 46, 2.4 MB) The version uses the DLL files and is compiled for 32 bits Windows.

Download SSIIM 1 for Windows, non-parallel version (8. October 2007, 1.1 MB) The version is compiled for 32 bits Windows. It uses the DLL files that can be downloaded from the links below. The version does not contain algorithms for running on parallell systems or exploit multi-core processors.

Download SSIIM 1 for 64 bits Windows (17. October 2012, v. 45, 2.6 MB) The version does not use the DLL files and is compiled for 64 bits Windows.

Download SSIIM 1 for 32 bits Linux (7. November 2007, 1.1 MB) The version does not use DLL files and it does not have a user interface. It is compiled on SUSE Linux, but should also work on other Linux versions.

Download SSIIM 1 for 64 bits Linux (2. November 2014, v. 47, 1.3 MB) The version does not use DLL files and it does not have a user interface. It is compiled on a PC with Inter processor and SUSE Linux.

Download SSIIM 1 for IBM p575+ (8. August 2011, 2.4 MB) The version does not use DLL files. It is compiled on a 64 bits AIX operating system.

Download SSIIM 2 for Windows (26. November 2014, v. 174, 2.6 MB) The version is compiled for 32 bits Windows. It uses the DLL files that can be downloaded from the links below.

Download SSIIM 2 for Windows (24. March 2011, 3.1 MB) The version is compiled for 32 bits Windows. It does not use the DLL files.

Download SSIIM 2 for Windows, non-parallel version (29. September 2007, 1.1 MB) The version is compiled for 32 bits Windows. It uses the DLL files that can be downloaded from the links below. The version does not contain algorithms for running on parallell systems or exploit multi-core processors.

Download SSIIM 2 for 64 bits Windows (30. August 2014, v. 171, 3 MB) The version is compiled for 64 bits Windows. It does not use the DLL files.

Download SSIIM 2 for IBM p575+ (14. November 2011, v. 127, 3.0 MB) The version does not use DLL files and does not have a user interface. It is compiled on a 64 bits AIX operating system.

Download SSIIM 2 for 64 bits SUSE Linux (30. August 2014, v. 172, 1.6 MB) The version does not use DLL files and does not have a user interface. It is compiled on a 64 bits SUSE Linux PC with an Intel X86 processor, using the gcc compiler with the /O2 option.

Download SSIIM 2 for 64 bits Linux (30. August 2012, v. 149, 1.7 MB) The version does not use DLL files and does not have a user interface. It is compiled on a 64 bits SGI Linux cluster with Intel Sandy Bridge Xeon processors, using the Intel compiler with the /O2 /xAVX options.

Download SSIIM 2 for 64 bits Linux with MPI parallelization (13. September 2013, v. 162, 1.5 MB) The version does not use DLL files and does not have a user interface. It is compiled on a 64 bits SGI Linux cluster with Intel Sandy Bridge Xeon processors, using the Intel compiler with the /O2 option. It will only work with the SGI MPI library installed on the cluster.

Download SSIIM 2 for 64 bits Linux with MPI parallelization (13. September 2013, v. 162, 2.7 MB) The version does not use DLL files and does not have a user interface. It is compiled on a 64 bits SGI Linux cluster with Intel Sandy Bridge Xeon processors, using the GNU mpicc compiler.

Download document discussing the performance of the parallel SSIIM versions (23. January 2008, 130 kB)

Download document giving guidance for the parallel SSIIM 2 version, including MPI. (19. April 2013)

Download the SSIIM 3D OpenGL viewer for SSIIM 1 (13. February 2007, 160 kB) This is a home-made 3D post-processor. We recommend to use the freeware ParaView instead.

Download OS/2 version of SSIIM with example files (20. November 1996, 1 MB zip file)

Download DLL files for SSIIM 1 (26. February 2011, 350 kB) These files are needed to run the latest version of SSIIM 1 for Windows.

If you have downloaded the DLLs for SSIIM 1 before, there might have been fewer DLLs in the zip'ed file. Some DLL files can be downloaded separately in a zip'ed format here:

Download walldll.zip. (23. October 2009)
Download tsc1dll.zip. (update 18/2-05)
Download beddll.zip. (23. October 2009)
Download roughm1.zip.
Download slide1dll.zip. (update 16/4-07)
Download bgraddll.dll. (11. September 2009)
Download floc1dll.dll. (19. November 2010)

Download DLL files for SSIIM 2 (25. July 2011, 154 kB)

Download separate DLL files for SSIIM 2:

Download flocdll.dll (20. November 2010).
Download vdmldll.dll (10. December 2010).
Download beddll.dll (25. July 2011).
Download vegdll.dll (15. December 2010).
Download sfdifdll.dll (25. November 2009).
Download walldll.dll (21. October 2003).
Download turbdll.dll (8. June 2011).
Download nestdll.dll (23. January 2009).
Download slide2dll.dll (13. March 2007).
Download source2dll.dll (29. September 2007).

The DLLs may not be compatible with the executable made at a different time. This may lead to an error when running the SSIIM program saying that a library is not found. If you are using the newest version of the executable, you can solve the problem by downloading the newest DLL files.

To run the parallel version of SSIIM, the OpenMP libraries are needed. On Windows, these are most conveniently installed with the Visual C++ redistribution package "vcredist_86.exe" that can be downloaded from Microsoft's web pages. Use a search tool to look for the file name. Note the parallel version can contain bugs that are not in the non-parallel version.

The theory of the program is given in the CFD Class Notes, which can be downloaded here (590 kB PDF file)

List of latest changes and bug fixes for SSIIM 1

List of latest changes and bug fixes for SSIIM 2


Source code for DLL files:

Download files for beddll.dll (25. July 2011)

This is the source code for the beddll.dll file. Using the files, it is possible to code new sediment transport formulas, formulas for critical shear stress, effective roughness, bedform height and effects of sloping beds. The same files are used for both SSIIM 1 and SSIIM 2. The files are written in C, and can be compiled using the freely downloadable MS Visual Studio Express compiler. An older version which uses code::blocks instead of MS Visual Studio is available below:

Download bedfiles_codeblocks.zip (4. August 2009)

The code::blocks compiler is also free, and easier to use than the Microsoft compiler.

The port of the beddll to code::blocs was done by Hans Bihs.


Links:

Main CFD group web page for our department.


Examples for SSIIM 1

SSIIM 1 needs at least the two input files "koordina" and "control" to work. The "koordina" file contains the grid, and the "control" file has many of the other parameters. To run the examples, download the files together with the program into the same directory, and start the program. Note that the input files must not have any extension, but some web browsers may add extensions when the files are saved. The files then have to be renamed before SSIIM is run.

- Flow in a 90 degree curved channel: [control] [koordina]

- Fish farm tank: [control] [koordina]

- Local scour

- Trap efficiency of a sand trap

- Trap efficiency of an intake

- Scour in a contraction

- Water quality using Streeter-Phelps model:

Further examples are included in the OS/2 version of SSIIM 1. The Windows and OS/2 input files are the same.


Examples for SSIIM 2

Note that the input files for SSIIM given below do not have any extensions. Most web browsers for Windows will add extension when the files are saved to disk, for example -.txt. The files then have to be renamed, and the extensions removed, before the files can be used by SSIIM.

Algae distribution in Eglwys Nynydd, UK:

Lake Sperillen, Norway:

Channel formation in a sand box. Test case for SSIIM version 2.0 with unstructured adaptive dynamically resizing grid. Note that this will only work for versions after 18. Dec. -98.

An improved grid system has been made, with hexahedral cells following most of the bed:

Spillway modelling:

Nested grids with circular cylinder:


*  * NTNU
* Civil and Env. Eng.
* Dept. Hydraulic Eng.

----
Updated: 15. December 2014
----

ntnu

Copyright © 2000-2014, Institutt for vann og miljøteknikk, NTNU