CMS Releases

Instructions

1. Extract the OpenMP DLL file from the zip, if needed. Note: you must have the correct platform DLL file in the same directory.
2. Download the appropriate 'exe' file.
3. If running the CMS from the SMS, change the location and name of the CMS-Flow Implicit executable by clicking on "Edit" | "Preferences...", and then selecting the "File Locations" tab and then clicking on the box under the "Executables" column next to "CMS-Flow Implicit" box in the "Models" column. Enter the location and name of the executable and select "Open".

• Note: For security reasons, the CMS executables or available for downloaded in a zip file.

OpenMP DLL

• 32 bit DLL: 32bit-DLL.zip
• 64 bit DLL: 64bit-DLL.zip

Releases

Version 4.1 Revision 37 (11/21/13)

Executables

• 32 bit: cms2d_v4p1r37-x32p.exe
• 64 bit: cms2d_v4p1r37-x64p.exe

Modifications

• Bug fix - Incorrect error message when reading local horizontal projection system
• Bug fix - XMDF library causing error en closing temporary file temp.h5. Code added so that it does not crash the model but the temporary file is not deleted.
• Bug fix - Latitude dataset was not being read in properly.
• Bug fix - When hot starting a simulation, if the initial condition for the salinity did not match the boundary conditions, this led to an inconsistency at the boundary. The salinity boundary condition is now ramped from the initial condition to the specified time series values using the same ramp function as in the hydrodynamics.
• New feature - Added optional strings units: seconds, radians, and degrees.
• New feature - Added preprocessor definition for diagnostic mode
• New feature - Improved diagnostics messages
• Bug fix - Bed layer thickness not being properly read in during hot starts.
• Bug fix - When hot starting a simulation with sediment transport, the water depths at the ghost cells was not being set properly causing instabilities for only the first time step.

Version 4.1 Revision 36 (10/28/13)

Executables

• 32 bit: cms2d_v4p1r36-x32p.exe
• 64 bit: cms2d_v4p1r36-x64p.exe

Modifications

• New feature - Added timers (watches) to profile the code, with C preprocessor definitions, and unit tests.

Version 4.1 Revision 35 (10/10/13)

Executables

• 32 bit: cms2d_v4p1r35-x32p.exe
• 64 bit: cms2d_v4p1r35-x64p.exe

Modifications

• New feature - Added C preprocessor definitions for XMDF source code at compilation time. We be used to include/exclude other options such as profiling in the future.

Version 4.1 Revision 34 (09/19/13)

Executables

• 32 bit: cms2d_v4p1r34-x32p.exe
• 64 bit: cms2d_v4p1r34-x64p.exe

Modifications

• New feature - Added capability to specify save points using a block structure
• New feature - Added capability to read wind speed and direction from SMS xys files
• Bug fix - The temporal scheme was not being set to first order after a time-step reduction.

Version 4.1 Revision 33 (09/16/13)

Executables

• 32 bit: cms2d_v4p1r33-x32p.exe
• 64 bit: cms2d_v4p1r33-x64p.exe

Modifications

• Bug fix - Fixed divide by zero in combined wave-current Soulsby-van Rijn subroutines
• Bug fix - Moved definition of default value for variable nhard to initialization routine sed_default

Version 4.1 Revision 32 (09/12/13)

Executables

• 32 bit: cms2d_v4p1r32-x32p.exe
• 64 bit: cms2d_v4p1r32-x64p.exe

Modifications

• Bug fix - Hard bottom datasets not being read in properly
• Bug fix - Corrected bug related to beta feature allowing the bed composition to change while not the bed elevation

Version 4.1 Revision 31 (09/11/13)

Executables

• 32 bit: cms2d_v4p1r31-x32p.exe
• 64 bit: cms2d_v4p1r31-x64p.exe

Modifications

• New feature - New open wse boundary velocity condition based on approximate momentum equation and damping factor
• Bug fix - Incorrect warning message displayed when the flux boundary inflow angle is specified outwards of the domain. The actual flux at the boundary was correct and there was a bug in the code which checks the boundary flux.

Version 4.1 Revision 30 (08/30/13)

Executables

• 32 bit: cms2d_v4p1r30-x32p.exe
• 64 bit: cms2d_v4p1r30-x64p.exe

Modifications

• Update - Added new version of wave model 20 May 2013
• Update - Added beta feature to set start of bed composition and bed change separately. This allows the user to estimate the equilibrium bed composition for a user-specified equilibrium bathymetry

Version 4.1 Revision 29 (07/12/13)

Executables

• 32 bit: cms2d_v4p1r29-x32p.exe
• 64 bit: cms2d_v4p1r29-x64p.exe

Modifications

• Bug fix - CMS-Wave was allowing for the user to select a number of frequencies which was larger than then hardcoded value

Version 4.1 Revision 28 (06/18/13)

Executables

• 32 bit: cms2d_v4p1r28-x32p.exe
• 64 bit: cms2d_v4p1r28-x64p.exe

Modifications

• Bug fix - Fixed precision problem causing divide by zero on some machines.

Version 4.1 Revision 27 (06/17/13)

Executables

• 32 bit: cms2d_v4p1r27-x32p.exe
• 64 bit: cms2d_v4p1r27-x64p.exe

Modifications

• Bug fix - Found bug in searching for overlapping points in subroutine intpcoef_cart2tel
• New feature - Added atmospheric pressure and stokes velocity to water level adjustment at boundary conditions
• Change - Modified boundary treatment for pressure equation using momentum interpolation. Changes done in subroutine prescorbnd and improved the boundary for field cases. The change also simplified the code.
• Bug fix - Fixed bug related to predicted wave water level for constant water level boundary condition (beta).
• Bug fix - Fixed bug related to the current velocity specification at open water level boundaries. The current velocity is calcualted using an extrapolated momentum interpolation. The bug fix has resolved instabilities causing jets to form at the boundaries.
• Bug fix - Reference time not being set properly for wave vector and radiation stresss output in XMDF file
• New feature - Added capability to use SMS Time Series Data files for wind input curve specification.
• Change - Improved diagnostics. Now outputs diagnostic super ascii files in the case of a crash. In addition more variables are displayed when an instability is detected.
• New features - Quasi3D formulation (beta).Completed the LSTF and LIP11D-1B test cases. Added capability to output vertical profiles of the horizontal current velocity at observation stations and global datasets for the current velocity at different sigma levels.
• New feature - Option for bottom boundary layer streaming added as a shear stress at the bottom in the direction of waves (beta)
• Change - Consolidated math routines into a library.
• Change - Modified water level boundary condition for flux boundaries to use an extrapolated water level.
• Bug fix - Flux correction was being applied between dry cells.
• Maintenance - Cleaned up bottom and wall friction library. Renamed several subroutines and variables.
• New feature - Addes routines for interpolation from polygonal to Cartesian grids and Cartesian to scattered points.
• Modification - Changed interpolation coefficient file format to only save non-zero coefficients.
• New features - Added option to output: cell area, connectivity, total flux velocity vector and magnitude, wave flux velocity vector and magnitude, total water depth, water level pressure, water level gradients, current velocity gradients, streamwise curvature, and roller dissipation.

Version 4.1 Revision 26 (05/30/13)

Executables

• 32 bit: cms2d_v4p1r26-x32p.exe
• 64 bit: cms2d_v4p1r26-x64p.exe

Modifications

• Bug fix - Fixed typos in vertical units and datum definition (beta)
• Bug fix - Ramp function was not being properly assigned to the bottom orbital velocities.

Version 4.1 Revision 25 (05/24/13)

Executables

• 32 bit: cms2d_v4p1r25-x32p.exe
• 64 bit: cms2d_v4p1r25-x64p.exe

Modifications

• Bug fix - Resolved bug related to harmonic boundary specification.
• Bug fix - Fixed bug related to the boundary extrapolation at fitted boundaries (alpha)
• New feature - Added cards to read wind stress and atmospheric pressure fields
• Change - Salinity horizontal mixing coefficient divided by Schmidt number
• Change - Changed output format for super ASCII files for greater precision
• New feature - Super ASCII files now include residuals, total water depth, pressure, and pressure correction
• Bug fix - A slight asymmetry if water level was found with the OpenMP parallelization of HLPA scheme and using nonuniform Cartesian grids for the Bump test case due to the NOWAIT clause. The clause has been removed and the problem fixed.
• Bug fix - Fixed bug in roller module related to changed common block for CMS-Wave files. The bug was introduced with a new version of the wave model (10Oct2011) and was causing the wave files to be mixed up. The wave XMDF output file was being saved with the name wind.dat and in subsequent runs the file was being read in as a wind file causing a read error.
• Bug fix - Fixed bug related to advanced constant roughness height specification
• Bug fix - Fixed bug related to improper initialization of error diagnostic variable ierr in unit conversion library. Problem only occured when running in debug mode.
• Bug fix - Fixed bug related to bottom roughness dataset read which was overwriting the relative path.

Version 4.1 Revision 24 (05/13/13)

Executables

• 32 bit: cms2d_v4p1r24-x32p.exe
• 64 bit: cms2d_v4p1r24-x64p.exe

Modifications

• Bug fix - Fixed devide by zero problem in SIP solver leading to NaN's
• Change - Changed sediment bed initialization so that the input first layer is taken as the mixing layer
• New feature - In the case the user specifies the water density and temperature the model now solves the equation of state for the water salinity using the secant method to estimate the water salinity which is then used for the kinematic viscosity calculation
• Bug fix - Fixed bug related to grain size calculation for older 3.75 where only the d50 dataset is given without a transport grain size.
• New feature - Added code for user to modify the maximum matrix solver iterations for the sediment concentration using the card SEDIMENT_CONCENTRATION_ITERATIONS.
• Bug fix - Fixed bug related to harmonic blocks
• New feature - Added option to turn on or off the wave and wind adjusted water level
• Change - Restructured advanced boundary nesting variables to that parent simulation is stored separately.

Version 4.1 Revision 23 (04/25/13)

Executables

• 32 bit: cms2d_v4p1r23-x32p.exe
• 64 bit: cms2d_v4p1r23-x64p.exe

Modifications

• Maintenance - Cleaned up salinity boundary condition initialization
• Bug fix - Fixed bug related to implicit salinity transport boundary conditions
• Bug fix - Fixed bug related to implicit salinity transport normalized residual initialization
• Bug fix - Fixed bugs related to new spatially variable wind formats. Fleet format and UVP formats have been verified.
• Change - Changed save points so that the cell id is always calculated using the coordinates
• Maintenance - Cleaned up met station routines and verified met station input. Enhanced met station diagnostic output.

Version 4.1 Revision 22 (04/23/13)

Executables

• 32 bit: cms2d_v4p1r22-x32p.exe
• 64 bit: cms2d_v4p1r22-x64p.exe

Modifications

• Bug fix - Units of minutes were not being read in correctly within the unit conversion library.
• Bug fix - Fixed bug related to single size sediment transport
• Bug fix - Added parenthesis before viskfl in subroutine. Error only an issue for constant sediment mixing coefficient (advanced alpha feature).

Version 4.1 Revision 21 (04/19/13)

Executables

• 32 bit: cms2d_v4p1r21-x32p.exe
• 64 bit: cms2d_v4p1r21-x64p.exe

Modifications

• Change - Simplified the mixing layer thickness calculation so that it is no longer a function of the deposition thickness
• Change - Changed interpolation of cell face bed load transport rate in bed slope term to harmonic mean
• New feature - Added parallelization to btklogexp and btklogrouse subroutines
• Change - Added new hardbottom treatment to limit concentration capacity
• New feature - Added parallelization to sedcapac_soulsby subroutine
• Bug fix - Fixed a bug related to the second order temporal scheme in which the variables from n-2 time step were not being updated properly for the first time step during variable time steps.
• Change - The second order scheme is only applied if the time step does not change.
• Bug fix - Two logical variables for single tidal constituent boundary were not being initialized. No known problems were being caused.

Version 4.1 Revision 20 (04/10/13)

Executables

• 32 bit: cms2d_v4p1r20-x32p.exe
• 64 bit: cms2d_v4p1r20-x64p.exe

Modifications

• Change - Modified one-cell-wide-channel wetting and drying criteria to allow flow in deep and narrow channels

Version 4.1 Revision 19 (04/09/13)

Executables

• 32 bit: cms2d_v4p1r19-x32p.exe
• 64 bit: cms2d_v4p1r19-x64p.exe

Modifications

• Change - Added additional debug variables in the diagnostic solution file *_diag.h5

Version 4.1 Revision 18 (04/08/13)

Executables

• 32 bit: cms2d_v4p1r18-x32p.exe
• 64 bit: cms2d_v4p1r18-x64p.exe

Modifications

• Bug fix - Fixed bug related to path specification for ICoords and JCoords. Bug only occurred for one known grid but has been fixed.
• Bug fix - Fixed bug in reading the cross-shore boundary condition.
• New feature - Added cards to specify convergence thresholds for implicit solution scheme
• Change - Moved precipitation and evaporation contribution to source term into the static source term for the implicit scheme

Version 4.1 Revision 17 (04/06/13)

Executables

• 32 bit: cms2d_v4p1r17-x32p.exe
• 64 bit: cms2d_v4p1r17-x64p.exe

Modifications

• Bug fix - Changed allocation size for vdata and udata arrays in nesting structure variable NH_str
• Change - Added internal closed boundary condition to improve the pressure field solution for the implicit scheme
• Bug fix - Added temporary variable to avoid changing the time series step variable in subroutine tidevalue within the steering module

Version 4.1 Revision 16 (03/15/2013)

Executables

• 32 bit: cms2d_v4p1r16-x32p.exe
• 64 bit: cms2d_v4p1r16-x64p.exe

Modifications

• Bug fix - Moved initialization of nestin1, nestin2, and iwave in CMS-Wave to the beggining of the file
• Change - Added input card for maximum current velocity, and water level values for convergence checking

Version 4.1 Revision 15 (03/14/2013)

Executables

• 32 bit: cms2d_v4p1r15-x32p.exe
• 64 bit: cms2d_v4p1r15-x64p.exe

Modifications

• Bug fix - Changed input units for single size sediment transport cards from m to mm
• Change - Removed slope limiter from pressure gradient term. This was causing convergence problems.
• Bug fix - Changed if statement in Soulsby-van Rijn transport formula for wave conditions (.not.cmswave) tp (noptset>=3)

Version 4.1 Revision 14 (03/12/2013)

Executables

• 32 bit: cms2d_v4p1r14-x32p.exe
• 64 bit: cms2d_v4p1r14-x64p.exe

Modifications

• Bug fix - Removed extra ramp from boundary concentration in subroutine sedbnd_eval

Version 4.1 Revision 13 (03/04/2013)

Executables

• 32 bit: cms2d_v4p1r13-x32p.exe
• 64 bit: cms2d_v4p1r13-x64p.exe

Modifications

• Bug fix - Added interpolation of gaps (dry values) for internal nested boundary conditions

Version 4.1 Revision 12 (03/01/2013)

Executables

• 32 bit: cms2d_v4p1r12-x32p.exe
• 64 bit: cms2d_v4p1r12-x64p.exe

Modifications

• Bug fix - Fixed critical shear velocity correction for SVR and VR transport formulas
• Bug fix - Fixed path bug in CMS-Wave
• Bug fix - Fixed path bug for boundary conditions
• Change - Increased default wave bottom friction factor to 0.65 from 0.5 based on comparisons to other models

Version 4.1 Revision 11 (02/09/2013)

Executables

• 32 bit: cms2d_v4p1r11-x32p.exe
• 64 bit: cms2d_v4p1r11-x64p.exe

Modifications

• Bug fix - Fixed bug in wave friction factor calculation for Data2 and Data13 (only for smooth conditions)
• Maintenance - Cleaned up the friction library
• New feature - Added bedform routines based on Soulsby (2005)

Version 4.1 Revision 10 (01/17/2013)

Executables

• 32 bit: cms2d_v4p1r10-x32p.exe
• 64 bit: cms2d_v4p1r10-x64p.exe

Modifications

• New feature - Least squares interpolation
• Maintenance - Moved structures code to separate files.
• Maintenance - Cleaned up wetting and drying subroutine.

1. Added parallelization to onecellwidechannels special wetting/drying case loop.
2. Moved distance to wall calculation to eddy viscosity module and added parallelization.
3. Added parallelization to flpond.

• Bug Fix - Revised deferred correction subroutines and fixed OpenMP race condition
• Maintenance - Changed code structure so that component variable definitions are in fortran modules in separate files named *_def.F90 (e.g. sed_def.F90), and component libraries are in separate files named *_lib.F90 (e.g. sed_lib.F90). Also separated source into folders so that is better organized.
• Change - Revised new block structures for boundary specification
• New feature - Added OpenMP parallelization to sediment avalanching subroutine
• New features - Added time step statistics to sediment transport
• Change - Moved water density from module to input in all friction subroutines.
• Change - Cell-face water depth is not calcuated from cell face water elevation, and bottom elevation instead of interpolating the water depth between cells. The new approach more efficient since the bed elevation only changes once per time step, and the water level gradients are calculated anyway.
• Bug fix - Fixed bug related to bed slope correction in Lund-CIRP and Soulsby-Van Rijn transport equations.
• Bug fix - Fixed bug relates to simplified log-law wall friction formulation
• Bug fix - Corrected if statement in iterative log-law wall friction formulation
• Change - Changed wall friction formulation to use wall friction coefficient instead of gamma

Version 4.1 Revision 5

Executables

• 32 bit: cms2d_v4p1r5-x32p.exe
• 64 bit: cms2d_v4p1r5-x64p.exe

Modifications

• Change - Added parallelization to hardbottom loop in sed_imp

Version 4.1 Revision 4

Executables

• 32 bit: cms2d_v4p1r4-x32p.exe
• 64 bit: cms2d_v4p1r4-x64p.exe

Modifications

• New feature - Added grid quality indicators to simulation statistics module

Version 4.1 Revision 3 (11/26/2012)

Executables

• 32 bit: cms2d_v4p1r3-x32p.exe
• 64 bit: cms2d_v4p1r3-x64p.exe

Modifications

• New feature - Added subroutines for reading card with scalars and booleans
• New features - Added unit conversion subroutines
• Maintenance - Cleaned up boundary initialization subroutine
• Change - Separated smoothing iterations for wave breaking index and wave breaking dissipation
• Change - Changed default smoothing iteration numbers for wave variables
• Change - Added steering variables for controling flow-to-wave current velocity and bed elevations values
• Maintenance - Cleaned up setwave subroutine and added OpenMP parallelization
• Bug fix - Extrapolation distances were being reset to zero when reading interpolation files
• New feature - Added SIP and ICCG solvers for structured grids

Version 4.1 Revision 2

Executables

• 32 bit: cms2d_v4p1r2-x32p.exe
• 64 bit: cms2d_v4p1r2-x64p.exe

Modifications

• Maintenance - Added parallelization to several sections of code
• Bug fix - Removed race condition in deferred correction subroutines
• Maintenance - Moved boundary condition specification to subroutines
• New feature - Different formulations for spatial gradients now available.
• Bug fix - Fixed boundary condition bug (introduced in V4.1)

Version 4.1 Revision 1

Executables

• 32 bit: cms2d_v4p1r1-x32p.exe
• 64 bit: cms2d_v4p1r1-x64p.exe

Modifications

• Maintenance - Added parallelization to several sections of code
• Maintenance - Combined coefficient assembly for u and v momentum equations
• Maintenance - Combined coefficient and source term calculations for pressure correction equation
• New feature - Added meteorological stations
• New feature - Added general input cards for scalars and booleans

Version 4.1

Modifications

• New feature - Nested water level boundary condition in a larger CMS or ADCIRC grid
• New feature - Nested water level and velocity boundary condition in a larger CMS or ADCIRC grid
• Change - Code for calculation of interpolation coefficients and index made into subroutines
• New feature - Added basic linear algebra subroutines with loop unrolling and OpenMP for faster computations.
• New feature - Added spatial water level gradient to tidal, and single water level boundary conditions
• New feature - Added mean water level to tidal/harmonic boundary condition
• New feature - Block structure input for tidal/harmonic boundary conditions
• New feature - Extended the range of the yearly nodal factor and equilibrium database to 1850-2050.
• Maintenance - Cleaned up sparse matrix module and added several comments.

Older CMS Releases

• Link to description of Older versions of CMS

---

Documentation Portal

Test_Cases