CMS-Flow: Difference between revisions

From CIRPwiki
Jump to navigation Jump to search
mNo edit summary
 
(39 intermediate revisions by 4 users not shown)
Line 3: Line 3:
|model_type=    Hydrodynamic model intended for local applications, primarily at inlets, the nearshore, and bays
|model_type=    Hydrodynamic model intended for local applications, primarily at inlets, the nearshore, and bays
|developer=     
|developer=     
Christopher W. Reed, Ph.D. <br />
Christopher W. Reed, Ph.D. br /
Alex Sanchez
Alex Sanchez
|web_site=      http://cirp.usace.army.mil/
|web_site=      http://cirp.usace.army.mil/
Line 15: Line 15:
-->
-->
CMS-Flow is a component of the Coastal Modeling System (CMS).  It is a finite-volume numerical engine which presently includes various two dimensional capabilities.  Present features are:
CMS-Flow is a component of the Coastal Modeling System (CMS).  It is a finite-volume numerical engine which presently includes various two dimensional capabilities.  Present features are:
* Hydrodynamics - water levels and current flow values under any condition of tide, wind, surge, waves and river flow
* '''Hydrodynamics''' - water levels and current flow values under any condition of tide, wind, surge, waves and river flow
* Sediment Transport - as bedload, suspended load, and total load dependent on various transport algorithms
* '''Sediment Transport''' - as bedload, suspended load, and total load dependent on various transport algorithms
* Morphology Change
* '''Morphology Change'''
* Salinity Transport
* '''Salinity Transport'''
For more information on the model itself, refer to the [http://cirp.usace.army.mil/pubs/pdf/TR-06-9.pdf users manual] published by USACE-ERDC.
For more information on the model itself, refer to the [http://cirp.usace.army.mil/Downloads/PDF/TR-06-9.pdf users manual] published by USACE-ERDC.


Pre- and post-processing of CMS-Flow grids is accomplished with the Surface-water Modeling System (SMS), version 10.0 and later.  The user can set up and edit computational grids, specify model parameters, define interaction of this model with the wave counterpart ([[CMS-Wave]]), launch the model and visualize the results.
Pre- and post-processing of CMS-Flow grids is accomplished with the Surface-water Modeling System (SMS), version 10.0 and later.  The user can set up and edit computational grids, specify model parameters, define interaction of this model with the wave counterpart ([[CMS-Wave]]), launch the model and visualize the results.
Line 28: Line 28:


==Graphical Interface==
==Graphical Interface==
The [[CMS-Flow Graphical Interface|CMS-Flow Graphical Interface]] is contained in the [http://xmswiki.com/xms/SMS:Cartesian_Grid_Module Cartesian Grid Module] as well as the [http://xmswiki.com/xms/SMS:Map_Module Map Module] and includes tools to create and edit a CMS-Flow simulation. The simulation consists of a geometric definition of the model domain (the grid) and a set of numerical parameters. The parameters define the boundary conditions and options pertinent to the model.
The [[CMS-Flow Graphical Interface|CMS-Flow Graphical Interface]] is contained in the [http://xmswiki.com/xms/SMS:Cartesian_Grid_Module Cartesian Grid Module] [[File:Cartesian_Grid_Module.PNG]] as well as the [http://xmswiki.com/xms/SMS:Map_Module Map Module] [[File:MapModule.PNG]]and includes tools to create and edit a CMS-Flow simulation. The simulation consists of a geometric definition of the model domain (the grid) and a set of numerical parameters. The parameters define the boundary conditions and options pertinent to the model.


The interface is accessed by selecting the [http://xmswiki.com/xms/SMS:Cartesian_Grid_Module Cartesian Grid Module] and setting the current model to CMS-Flow.  If a grid has already been created for a CMS-Flow simulation or an existing simulation read, the grid object will exist in the [http://xmswiki.com/xms/SMS:Project_Explorer Project Explorer] and selecting that object will make the Cartesian grid module active and set the model to CMS-Flow. See [http://xmswiki.com/xms/SMS:Cartesian_Grid_Module#Creating_2D_Grids Creating 2D Cartesian Grids] for more information.
The interface is accessed by selecting the [http://xmswiki.com/xms/SMS:Cartesian_Grid_Module Cartesian Grid Module] and setting the current model to CMS-Flow.  If a grid has already been created for a CMS-Flow simulation or an existing simulation read, the grid object will exist in the [http://xmswiki.com/xms/SMS:Project_Explorer Project Explorer] and selecting that object will make the Cartesian grid module active and set the model to CMS-Flow. See [http://xmswiki.com/xms/SMS:Cartesian_Grid_Module#Creating_2D_Grids Creating 2D Cartesian Grids] for more information.
Line 34: Line 34:
Run-time parameters and setups are located in the [[CMS-Flow:Model_Control|CMS-Model Control]] dialog portion of the graphical interface.
Run-time parameters and setups are located in the [[CMS-Flow:Model_Control|CMS-Model Control]] dialog portion of the graphical interface.


==Using the Model / Practical Notes==
For new simulations, users will create the CMS-Flow grid based on a conceptual model. The conceptual model includes:
*A CMS-Flow Coverage: this coverage defines the domain of the grid using a grid frame. The coverage also defines the location of land and water in the grid using one of three methods:
** Land/Water cells defined based bathymetric values.  CMS-Flow uses depths, so positive depth indicates water, negative depth indicates land.  Cells with depth less than the negative value of the water surface are dry.  This option requires a geometric survey that includes both the bathymetric area and the areas that could potentially be flooded.  This is the most intuitive option and the preferred method if geometric data is available.
** Land/Water interface defined by coastline arcs.  This option allows the user to define, read or import arc definitions that delineate the water area.  These arcs include an orientation. To the left of the arc is land, to the right is water.  The user can select an arc and swap its orientation.  All the area inside the grid frame on the "water" side of the arc must have elevations defined either from a survey, or by specification.  Cells created on the "land" side of the arc will never be included in calculations (they are permanently dry).  These arcs also include an attribute defining how cells spanning this interface are to be classified.  They may be forced to be water (ocean preference), forced to be land (land preference) or split based on the percentage of the cell on each side of the arc (percent preference).
** Land/Water interface defined by polygons.  This option also requires the user to define arcs delineating the extents of the computational area.  However, these arcs must be closed into polygons. Each polygon is specified to enclose land or water and cells are classified accordingly.
*An Area Property Coverage: this is an optional coverage or set of coverages which contain polygons of material types.
==Feature List==
==Feature List==
Information about the Features available for CMS-Flow are listed below.  Additional information about these features can be found on [[CMS-Flow:Features|here]]
Information about the Features available for CMS-Flow are listed below.  Additional information about these features can be found by clicking here [[CMS-Flow:Features|here]] or on the individual links below.
* [[CMS-Flow:Features#Boundary_Conditions|Boundary Condition Forcing]]
*[[CMS-Flow:Features#Boundary_Conditions|Boundary Condition Forcing]]
* [[CMS-Flow:Features#Global_Forcing|Global Forcing]]
**[[CMS-Flow:Features#Water_Surface_Elevation_Forcing|Water Surface Elevation]]
* [[CMS-Flow:Features#Transport_Options|Transport Options]]
**[[CMS-Flow:Features#Water_Surface_Elevation_and_Velocity_Forcing|Water Surface Elevation and Velocity]]
** Sediment Transport
**[[CMS-Flow:Features#River_Flow_Forcing|River Flow Forcing]]
** Salinity Transport
**[[CMS-Flow:Features#Salinity_Concentration_Forcing|Salinity Concentration Forcing]]
*[[CMS-Flow:Features#Global_Forcing|Global Forcing]]
**[[CMS-Flow:Features#Wind_Forcing|Wind Forcing]]
**[[CMS-Flow:Features#Wave_Forcing|Wave Forcing]]
*[[CMS-Flow:Features#Transport_Options|Transport Options]]
** [[CMS-Flow:Features#Sediment_Transport|Sediment Transport]]
***[[CMS-Flow:Features#Non-equilibrium_Algorithm|Non-equilibrium Algorithm (NET)]] [[File:NEW.gif]]
***[[CMS-Flow:Features#Total_Load_Algorithm|Total Load Algorithm]]
** [[CMS-Flow:Features#Salinity_Transport|Salinity Transport]] [[File:NEW.gif]]
* [[CMS-Flow:Features#Other_Processes|Other Processes]]
* [[CMS-Flow:Features#Other_Processes|Other Processes]]
**[[CMS-Flow:Features#Bottom_Friction|Bottom Friction]]
**[[CMS-Flow:Features#Hard_Bottom|Hard Bottom]]
**[[CMS-Flow:Features#Variable_D50|Variable D50]]
**[[CMS-Flow:Features#Eddy_Viscosity|Eddy Viscosity]] [[File:NEW.gif]]
* [[CMS-Flow:Features#Other_Features|Other Features]]
* [[CMS-Flow:Features#Other_Features|Other Features]]
 
** [[CMS-Flow:Features#Parallelization_with_OpenMP|Parallelization]] --  [http://cirp.usace.army.mil/products/tutorials/MP/MultiProcesses.html Animation] [[File:NEW.gif]]
==New Features/Capabilities==
*[[CMS-Flow:Features#Units_of_Measurement|Units of Measurement]]
With the introduction of CMS-Flow version 3.75, several new features have been added.  Below is a list of these new features/capabilities which link to additional pages of documentation.
 
*[[CMS-Flow:Salinity Calculation|Salinity Calculation]]
*[[CMS-Flow:Non-equilibrium Sediment Transport|Non-equilibrium Sediment Transport]]
*[[CMS-Flow:Subgrid Turbulence Model|Subgrid Turbulence Model]]
 
More information to be added at a later time.


==Upcoming Features==
==Upcoming Features==
*[[CMS-Flow:Implicit|Implicit Solver]] -- Scheduled release: March 2010
*[[CMS-Flow:Implicit|Implicit Solver]] -- CMS-2D Version 4 Beta 2 - Released: June 2010
*[[CMS-Flow:Telescoping|Telescoping Grid Capability]] -- Scheduled release: July 2010
*[[CMS-Flow:Telescoping|Telescoping Grid Capability]] -- Scheduled release: July 2010
*[[CMS-Flow:Cohesive|Cohesive Sediment Transport]] -- Scheduled release: July 2010
*[[CMS-Flow:Cohesive|Cohesive Sediment Transport]] -- Scheduled release: July 2010
Line 77: Line 73:
* Sep 2008 Modeling of Morphologic Changes Caused by Inlet Management Strategies at Big Sarasota Pass, Florida [http://www.fsbpa.com/08Proceedings/07AlymovTruittPoffAnderson2008.pdf]
* Sep 2008 Modeling of Morphologic Changes Caused by Inlet Management Strategies at Big Sarasota Pass, Florida [http://www.fsbpa.com/08Proceedings/07AlymovTruittPoffAnderson2008.pdf]
* Jul 2007  ERDC/CHL CHETN-IV-69 Tips for Developing Bathymetry Grids for Coastal Modeling System Applications [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-69.pdf]
* Jul 2007  ERDC/CHL CHETN-IV-69 Tips for Developing Bathymetry Grids for Coastal Modeling System Applications [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-69.pdf]
* Aug 2006  ERDC/CHL TR-06-9  Two-Dimensional Depth-Averaged Circulation Model CMS-M2D: Version 3.0, Report 2, Sediment Transport and Morphology Change [http://cirp.usace.army.mil/pubs/pdf/TR-06-9.pdf]
* Aug 2006  ERDC/CHL TR-06-9  Two-Dimensional Depth-Averaged Circulation Model CMS-M2D: Version 3.0, Report 2, Sediment Transport and Morphology Change [http://cirp.usace.army.mil/Downloads/PDF/TR-06-9.pdf]
* Feb 2006  ERDC/CHL CHETN-IV-67 Frequently-Asked Questions (FAQs) About Coastal Inlets and U.S. Army Corps of Engineers' Coastal Inlets Research Program (CIRP) [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-67.pdf] Updated FAQ Website [http://cirp.usace.army.mil/pubs/FAQs/FAQ.html]
* Feb 2006  ERDC/CHL CHETN-IV-67 Frequently-Asked Questions (FAQs) About Coastal Inlets and U.S. Army Corps of Engineers' Coastal Inlets Research Program (CIRP) [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-67.pdf] Updated FAQ Website [http://cirp.usace.army.mil/pubs/FAQs/FAQ.html]
* May 2005  ERDC/CHL CHETN-IV-63 Representation of Nonerodible (Hard) Bottom in Two-Dimensional Morphology Change Models [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-63.pdf]
* May 2005  ERDC/CHL CHETN-IV-63 Representation of Nonerodible (Hard) Bottom in Two-Dimensional Morphology Change Models [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-63.pdf]
* May 2004  ERDC/CHL TR-04-2  Two-Dimensional Depth-Averaged Circulation Model M2D: Version 2.0, Report 1, Technical Documentation and User’s Guide [http://cirp.usace.army.mil/pubs/pdf/TR-04-2.pdf]
* May 2004  ERDC/CHL TR-04-2  Two-Dimensional Depth-Averaged Circulation Model M2D: Version 2.0, Report 1, Technical Documentation and User’s Guide [http://cirp.usace.army.mil/Downloads/PDF/TR-04-2.pdf]
* Dec 2003  ERDC/CHL CHETN-IV-60 SMS Steering Module for Coupling Waves and Currents, 2: M2D and STWAVE [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-60.pdf]
* Dec 2003  ERDC/CHL CHETN-IV-60 SMS Steering Module for Coupling Waves and Currents, 2: M2D and STWAVE [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-60.pdf]


[[category:main]]
[[category:main]]

Latest revision as of 19:48, 31 May 2013

CMS-Flow is a component of the Coastal Modeling System (CMS). It is a finite-volume numerical engine which presently includes various two dimensional capabilities. Present features are:

  • Hydrodynamics - water levels and current flow values under any condition of tide, wind, surge, waves and river flow
  • Sediment Transport - as bedload, suspended load, and total load dependent on various transport algorithms
  • Morphology Change
  • Salinity Transport

For more information on the model itself, refer to the users manual published by USACE-ERDC.

Pre- and post-processing of CMS-Flow grids is accomplished with the Surface-water Modeling System (SMS), version 10.0 and later. The user can set up and edit computational grids, specify model parameters, define interaction of this model with the wave counterpart (CMS-Wave), launch the model and visualize the results.

The model is intended to be run on a project-scale, meaning the domain should only be on the order of 1-100 kilometers in length and width; however, future features will allow for more regional applications. The following sections describe the interface and make recommendations for the applications of the model.

Graphical Interface

The CMS-Flow Graphical Interface is contained in the Cartesian Grid Module Cartesian Grid Module.PNG as well as the Map Module MapModule.PNGand includes tools to create and edit a CMS-Flow simulation. The simulation consists of a geometric definition of the model domain (the grid) and a set of numerical parameters. The parameters define the boundary conditions and options pertinent to the model.

The interface is accessed by selecting the Cartesian Grid Module and setting the current model to CMS-Flow. If a grid has already been created for a CMS-Flow simulation or an existing simulation read, the grid object will exist in the Project Explorer and selecting that object will make the Cartesian grid module active and set the model to CMS-Flow. See Creating 2D Cartesian Grids for more information.

Run-time parameters and setups are located in the CMS-Model Control dialog portion of the graphical interface.

Feature List

Information about the Features available for CMS-Flow are listed below. Additional information about these features can be found by clicking here here or on the individual links below.

Upcoming Features

Case Studies / Sample Problems

The following tutorials may be helpful for learning to use CMS-Flow in SMS:

  • Models Section
    • CMS - CMS-Flow

Links and References

  • Sep 2008 Modeling of Morphologic Changes Caused by Inlet Management Strategies at Big Sarasota Pass, Florida [1]
  • Jul 2007 ERDC/CHL CHETN-IV-69 Tips for Developing Bathymetry Grids for Coastal Modeling System Applications [2]
  • Aug 2006 ERDC/CHL TR-06-9 Two-Dimensional Depth-Averaged Circulation Model CMS-M2D: Version 3.0, Report 2, Sediment Transport and Morphology Change [3]
  • Feb 2006 ERDC/CHL CHETN-IV-67 Frequently-Asked Questions (FAQs) About Coastal Inlets and U.S. Army Corps of Engineers' Coastal Inlets Research Program (CIRP) [4] Updated FAQ Website [5]
  • May 2005 ERDC/CHL CHETN-IV-63 Representation of Nonerodible (Hard) Bottom in Two-Dimensional Morphology Change Models [6]
  • May 2004 ERDC/CHL TR-04-2 Two-Dimensional Depth-Averaged Circulation Model M2D: Version 2.0, Report 1, Technical Documentation and User’s Guide [7]
  • Dec 2003 ERDC/CHL CHETN-IV-60 SMS Steering Module for Coupling Waves and Currents, 2: M2D and STWAVE [8]
Retrieved from "https://cirpwiki.info/index.php?title=CMS-Flow&oldid=9874"