CMS Releases

Instructions

1. Download the appropriate 'exe' file.
2. Extract the DLL file from the zip, if needed

Note: you must have the correct platform DLL file in the same directory.

Executables

32 bit

• cms2d_v4p1r19-x32p.exe
• 32bit-DLL.zip

64 bit

• cms2d_v4p1r19-x64p.exe
• 64bit-DLL.zip

Revision History

Version 4.0

Revision 1

• Bug Fix - NaN wind drag coefficient produced for zero wind speed.

Revision 2

• Change - Variable time stepping algorithm.

Revision 3

• New feature - Display time step statistics.

Revision 4

• New feature - Multiple XMDF output files for each variable group.

Revision 5

• New feature - Hybrid solver using both GMRES and Gauss-Seidel
• New feature - Hydro statistics are used to check for model divergence at every outer loop iteration.

Revision 6

• Bug Fix - Bug fix for multiple XMDF output files. Files are deleted before for coldstarts.
• Bug Fix - Wind linear interpolation coefficient changed to avoid extrapolation.
• Bug Fix - Changed observation station output format to F9.4 so that dry cells write -999 for water elevation
• Bug Fix - Increased tolerance for output in check_time_list to avoid skipping output times
• Change - Increased interval for sediment transport screen print from 5 to 10

Revision 7

• Bug Fix - Replaced wucapac transport formula

Revision 8

• Change - Changed variable time step settings (more conservative)
• Bug fix - Reordered convergence if statements in CMS_Flow
• Bug fix - Removed mean current velocities from simulation statistics (not used currently)
• Bug fix - Changed sign of "Stokes forcing" term in momentum equation (negligible effect)
• Bug fix - Removed wccg reference in roller and replaced with wccg2 (wccg2 created by Alex)
• Bug fix - Added reinitialization of tmultw in recalculate (to properly recover from crashes)
• Change - Added cdflux1 variable to be used in recalculate and update (more consistent)
• Bux fixes - Several bug fixes reported bu Earl Hayter for CMS-Wave (EJH)
• Bug fix - Added code to not allow vis=0.0 at dry cells (EJH)
• Maintenance - Removed old code for reading NCCHE type input ASCII files
• Bug fix - Divide by zero in sed_betat for dry cells due to zero viscosity
• Change - Reintroduced the wave ASCII output for use with PTM

Revision 9

• Bug fix - Removed average current velocity output in sim_stats causing error
• Change - Units of sediment transport from m^2/s to kg/m/s
• Maintenance - Removed unused variable struct from code
• Change - Removed positive and negative sediment transport rates from statistics
• Change - Added statistics output for maximum sediment transport rates
• Change - Added statistics output for total-load concentration norm residuals

Revision 10

• Change - Removed coefficient calculation for v-momentum equation, except at boundary cells
• Change - Added static source terms for momentum and salinity
• New Feature - Added second-order temporal scheme
• New Feature - Added GAMMA, CUBISTA, ALSMART, and HOAB advection schemes
• Change - Optimized deferred corrections
• Change - Improved output display screen
• New Features - Added rubble mound, culverts, and weirs from Weiming's code.

Revision 11

• Change - Set default output file names for each group to group names instead of solution file
• Change - Added cards to turn on/off specific output variables
• Bug fix - Fixed ascii output of current velocity
• Maintenance - Cleaned up prestart, read_card_file, and others
• New Feature - Added Quasi-3D module to calculate 3D dispersion terms
• Change - Modified cards for wave mass flux velocity and roller flux

Revision 12

• Bug fix - Hot start failed to write to hotstart file after starting from hotstart file.
• New Feature - Save Point files instead of Observation Cells. Ensured this works with Hot Starts
• Change - Modified HYDRO_TIMESTEP, DURATION_RUN, DURATION_RAMP to be able to read time units.

Revision 13

• Change - Modified representative bottom orbital velocity Uwr calculation using parametric method based on JOHNSWAP spectrum
• Change - Modified bottom friction calculation to that Uwr is used instead of Uw for all of the bottom friction friction formulations except the quadratic one
• New feature - Added card MORPH_START_TIME which replaces CALC_MORPH_DURING_RAMP
• New feature - Added GM79 and DSK88 bed friction formulations
• Maintenance - Verified Soulsby-van Rijn transport formula with example case from Soulsby 1997
• Maintenance - Verified GM79 bed friction formulation using example from Soulsby 1997
• New feature - Added bed-correction to Soulsby-van Rijn transport formula
• Change - Simplified wall friction formulation to avoid iterative solution
• New features - Added curvature to hydrodynamic simulation statistics

Revision 14

• Bug fix - Fixed cdWndvolp calculation for Lagrangian winds.
• Bug fix - Variable sqrttwo not defined properly.
• Change - Initial guess of roller energy is set to the previous time step instead of zero and converges much faster.
• New feature - Added output for fraction of broken waves and wave dissipation coefficient.
• Change - Modified incipient wave breaking.

Version 4.1

• 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.

Revision 1

• 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

Revision 2

• 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)

Revision 3 (11/26/2012)

• 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

= Revision 3 (11/30/2012)

• New feature - Added subroutines for reading card with scalars and booleans
• New features - Added unit conversion subroutines
• Maintenance - Cleaned up boundary initialization subroutine

Revision 4

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

Revision 5

• Change - Added parallelization to hardbottom loop in sed_imp

Revision 10 (01/17/2013)

• 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

Revision 11 (02/09/2013)

• 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)

Revision 12 (03/01/2013)

• 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

Revision 13 (03/04/2013)

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

Revision 14 (03/12/2013)

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

Version 4.1 Revision 15 (03/14/2013)

• 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 16 (03/15/2013) ! 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 17 (04/06/13) ! 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 18 (04/08/13) ! 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 19 (04/09/13) ! Bug fix - Changed allocation size for vdata and udata arrays in nesting structure variable NH_str

---

Test_Cases