US Army Corps of Engineers

Coastal Inlets Research Program

Coastal Modeling System (CMS)

The Coastal Modeling System is an integrated 2D numerical modeling system for simulating waves, current, water level, sediment transport, and morphology change at coastal inlets and entrances. Emphasis of the CMS is on navigation channel performance and sediment exchange between the inlet and adjacent beaches. A key objective of this work is to develop, test, and transfer the CMS to Corps Districts and industry for use on specific engineering studies.

CMS Versions and Tools
CMS-Merged (implicit and explicit) - v5.0 to v5.3 (updated)

CMS 5.3 - Current Release is CMS2D_v5.3 (update 1) - 7 July 2022
Check wiki page for latest version


  • Interface - Surfacewater Modeling System (SMS) version 13.2 (should work with SMS 13.0+ and reduced functionality with SMS 11.2).
  • Combined Implicit and Explicit solution schemes into one executable - New
    • Cartesian and Quadtree (telescoping) grids available for both solution schemes
  • Sediment Mapping capability - New
    • Documentation forthcoming.
    • Contact Honghai Li for information.
  • Capability for 4 structure types added - New
    • Permeable Rubble Mound Jetties, Weirs, Culverts, Tidal Gates
    • Interface changes will be available in future updates to SMS 13.2. Rubble Mound is already available in SMS 13.1+.
  • New SMS interface for CMS-Wave in SMS 13.2 with an easier to read parameter file format (.std).
  • Numerous bug fixes and parallelization improvements.
Latest version of the code is always available from the CIRP Wiki page listed below:
Please note the Terms and Conditions for the Coastal Modeling System
CMS-Implicit - v4.1 - variable spaced or quadtree non-conforming grid. ALSO contains inline wave model.

CMS 4.1 - Latest Release is cms2d_v4p1r51 - 22 April 2015


  • Interface - Surfacewater Modeling System (SMS) version 11.1 (reduced functionality with SMS 11.0).
  • Nested boundary conditions - New
    • Water level extracted from larger CMS or ADCIRC grid
    • Water level + Velocity extracted from larger CMS or ADCIRC grid
    • Extraction from ADCIRC tidal databases (potential terms only)
  • Multiple Meteorological Stations for spatially variable wind forcing - New
  • Change from Observation Points to Save Points - New
    • SMS can directly pull in time series curves for designated save locations.
    • Output multiple variables within HYDRO, SEDIMENT, SALINITY, and WAVE groups.
  • Grid quality indicators added to simulation statistics module.
  • Numerous bug fixes and parallelization improvements.

Latest version of the code is always available from the CIRP Wiki page listed below:

Please note the Terms and Conditions for the Coastal Modeling System
CMS-Wave Standalone - For use with CMS-Flow Explicit or by itself
  • Latest - Ver 3.2
  • Older
  • Interface - SMS 11.0. Reduced functionality with SMS 10.1, but operational.
  • New Features (SMS interface development underway)
    • Full-plane effects when using winds AND wave spectra.
    • Spatially variable wind and surge fields.
    • Infragravity waves
CMS-Wave version 3.2 - executable
32-bit - download
64-bit - download

Please contact CIRP for access to older version.

Other Tools for use with the Coastal Modeling System

PTM with the Coastal Modeling System
Interface – SMS 11.0 has simplified model interface. Reduced functionality with SMS 10.1, but operational.

CMS-PTM version 2.0.55 – Executable

CMS-Wave Automated Procedure
The ability to systematically execute a large number of CMS-Wave simulations with little user interaction is beneficial in applications where new and/or reruns of numerous simulations are required for model re-validation and sensitivity tests, or for a large number of production runs. 

An automated procedure was developed and is described in a CHETN (in press) and uses a series of MATLAB® scripts to generate CMS-Wave model I/O files, run the model on a PC, post-process model output files to calculate basic statistics for model-data comparison, and plot the model results.  It performs many individual simulations which use different wave breaking formulations, or wave model versions, or input conditions.  The procedure allows users to efficiently setup CMS-Wave model both for successive or simultaneous simulations in Corps projects and to expediently evaluate model results in research studies.
Installation program and sample files: (~20 MB)
Documentation (CHETN):
CMS-Wave Model: Part 4. An Automated Procedure for CMS-Wave in Resource-Demanding Applications - PDF
HDF View
CMS-Flow files are written in a binary format which cannot be read by a text viewer. To look into the files (no editing please), you can download a binary file viewer.
HDF View 2.5 - link
Wave Information Studies (WIS) Data New
CMS Users can use data from the Wave Information Studies (WIS) program to force CMS-Wave with. The main website is located at the link below. Contact to obtain 2d Spectra for forcing. Eventually this will be made possible within the Data Portal, but send an email for now.

List of Information
Documentation CMS Wiki Page
CMS Documentation Portal
Validation Report Test Case Files CIRP Wiki - Validation Test Cases
Validation Cases Documented CIRP Wiki - Other Test Cases
Workshops List of CIRP Workshops
Recent Poster CMS Poster - 2019 RARG
Subscription List Subscribe by email **
Unsubscribe by email **
**Send with empty subject

Points of Contact
Engineer Research and Development Center
Coastal and Hydraulics Laboratory
Vicksburg, MS 39180