SMS:CMS-Flow Model Control: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(→‎Output: Updated information about how CMS-Flow currently outputs files)
No edit summary
 
(46 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TOCright}}
{{TOCright}}
The CMS-Flow ''Model Control'' dialog allows the user to view and edit the current parameters that affect how CMS-Flow runs and what options are to be included in the current simulation.  The ''Model Control'' dialog is access by right-clicking on the CMS-Flow simulation object and selecting the '''Model Control''' command.  
The CMS-Flow ''Model Control'' dialog allows viewing and editing the current parameters that affect how CMS-Flow runs and what options are to be included in the current simulation.  The ''Model Control'' dialog is access by right-clicking on the CMS-Flow simulation object and selecting the '''Model Control''' command.  


The dialog includes several tabs which partition the parameters into related groups. The tabs and their related parameters include:
The dialog includes several tabs which partition the parameters into related groups. The tabs and their related parameters include:


==General==
==General==
[[File:CMS-FlowMC GeneralTab.png|thumb|left|380 px|CMS-Flow ''Model Control'' dialog showing the ''General'' tab]]
Specifies general flow model parameters, controlling which model options the simulation will employ. The controls include:
Specifies general flow model parameters, controlling which model options the simulation will employ. The controls include:
{|
|-
|valign="top"|[[File:CMS-Flow ModelControl-General.png|thumb|left|380 px|CMS-Flow ''Model Control'' dialog showing the ''General'' tab]]
|
===Time Control===
===Time Control===
In this section the user can set the starting time, duration and hydraulic time step. The ''Ramp duration'' defines the length of an incremental loading portion at the beginning of the simulation. Controls include:
This section sets the starting time, duration and hydraulic time step. The ''Ramp duration'' defines the length of an incremental loading portion at the beginning of the simulation. Controls include:
*''Start date/time'' – the hour and day at which to begin the model.  This will be the first time step listed in any solution files.
*''Start date/time'' – The hour and day at which to begin the model.  This will be the first time step listed in any solution files.
*''Simulation duration'' – the length of the simulation in hours.
*''Simulation duration'' – the length of the simulation in hours.
*''Ramp duration'' – the period of time in days at which to allow the model to  “build up” or “ramp up” to a legitimate solution.  Aids in the convergence of  the model.
*''Ramp duration'' – The period of time in days at which to allow the model to  “build up” or “ramp up” to a legitimate solution.  Aids in the convergence of  the model.
*''Second order skewness correction'' – turns on or off the second order skewness correction which account for non-orthogonality in the telescoping grids.
*''Second order skewness correction'' – Turns on or off the second order skewness correction which account for non-orthogonality in the telescoping grids.


=== Hot Start ===  
=== Hot Start ===  
These controls allow the user to specify a previously saved hot start file to be used as initial conditions or instruct CMS-Flow to save hot start files for future use.
These controls allow specifying a previously saved hot start file to be used as initial conditions or instruct CMS-Flow to save hot start files for future use.
*''Initial conditions file''
*''Initial conditions file''
*''Write Hot Start output file''
*''Write Hot Start output file''
Line 25: Line 28:
===Solution Scheme===
===Solution Scheme===
CMS-Flow now has two solution schemes. These include the traditional "explicit" scheme. This method requires that flow be tracked through each element, resulting in hydrodynamic time steps in the order of one to two seconds. The new option is an "implicit" scheme which uses finite volume technology, supports much larger time steps resulting in fewer time steps (shorter run times) and is identically mass conserving. When the implicit scheme is being used, one of the following matrix solver types should be specified.
CMS-Flow now has two solution schemes. These include the traditional "explicit" scheme. This method requires that flow be tracked through each element, resulting in hydrodynamic time steps in the order of one to two seconds. The new option is an "implicit" scheme which uses finite volume technology, supports much larger time steps resulting in fewer time steps (shorter run times) and is identically mass conserving. When the implicit scheme is being used, one of the following matrix solver types should be specified.
*''Solution scheme'' – can be set as "Implicit" or "Explicit".
*''Solution scheme'' – Can be set as "Implicit" or "Explicit".
*''Matric solver'' – can be specified when using the "Implicit" option. Options are "Gauss-Seidel", "Gauss-Seidel-SOR", "BiCGSTab", or "GMRES".
*''Matric solver'' – Can be specified when using the "Implicit" option. Options are "Gauss-Seidel", "Gauss-Seidel-SOR", "BiCGSTab", or "GMRES".


===Threads===
===Threads===
CMS-Flow can take advantage of multiple processors using Open-MP parallelization technology. This control allows the user to specify the maximum number of threads that the engine should occupy.
CMS-Flow can take advantage of multiple processors using Open-MP parallelization technology. This control allows specifying the maximum number of threads that the engine should occupy.
*''Number of threads'' – determines the number of threads used for parallel processing.
*''Number of threads'' – Determines the number of threads used for parallel processing.
|}


==Flow==
==Flow==
[[File:CMS-FlowMC FlowTab.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Flow'' tab]]
[[File:CMS-Flow ModelControl-Flow.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Flow'' tab]]
Specifies general hydrodynamic or flow model parameters, controlling which model options the simulation will employ. The controls include:
Specifies general hydrodynamic or flow model parameters, controlling which model options the simulation will employ. The controls include:
===Hydrodynamic Time Step===
===Hydrodynamic Time Step===
This control allows the user to set the hydrodynamic time step for the model.  If the explicit solution scheme is being used, a recommended time step will be calculated based on grid cell size and depths.
This control allows setting the hydrodynamic time step for the model.  If the explicit solution scheme is being used, a recommended time step will be calculated based on grid cell size and depths.
*''Hydrodynamic time step'' – sets the time step for the hydrodynamics.
*''Hydrodynamic time step'' – Sets the time step for the hydrodynamics.
*''Wetting and drying depth'' – sets the minimum depth for wet cells.
*''Wetting and drying depth'' – Sets the minimum depth for wet cells.
*''Wave fluxes'' – turns on and off the wave volume flux velocities.
*''Wave fluxes'' – Turns on and off the wave volume flux velocities.
*''Roller fluxes'' – turns on or off the contribution to the wave volume flux velocities due to the surface roller in the surf zone. Only used if surface roller model is turned on.
*''Roller fluxes'' – Turns on or off the contribution to the wave volume flux velocities due to the surface roller in the surf zone. Only used if surface roller model is turned on.
*''Average latitude for Coriolis'' – specifies the average latitude for the grid which is used for the Coriolis parameter.
*''Average latitude for Coriolis'' – Specifies the average latitude for the grid which is used for the Coriolis parameter.


===Water Parameters===
===Bottom and Wall Friction===
This section allows specifies various general parameters to be used by the simulation. This include:
Friction datasets can be created and specified to define a spatially variable bottom roughness to provide a resistance to flow. This value has little impact in deep ocean applications but can be important in shallow regions.  
*''Water temperature'' – used in the calculation of the water kinematic viscosity and water density if not specified.
*''Wave-current bottom friction coefficient'' – This is a user editable dataset.  The available dataset types are:
*''Water density'' – assumed to be constant for the simulation. If not specified, calculated based on the water temperature and salinity.
**"Quadratic"
**"Soulsby (1995) Data2"
**"Soulsby (1995) Data13"
**"Fredsoe (1984)"
**"Huynh-Thanh  and Temperville (1991)"
*''Coefficient'' – Used for quadratic combined wave-current mean bed shear stress calculation.
*''Bed-slope friction coefficient'' – Specifies whether to include the bed slope friction factor or not in the calculation of the bed friction.
*''Wall friction'' – Turns on or off wall friction.
*''Bottom roughness dataset'' – This section allows selecting a bottom roughness dataset located in the project.
**''Bottom roughness type'' – The type of bottom roughness dataset can be selected. Available types include: "Mannings N", "Bottom friction coefficient", and "Roughness height".
**''Bottom roughness'' – Selecting the '''Dataset''' button will open the ''Select bottom roughness dataset'' dialog where the desired dataset can be chosen.


===Turbulence Parameters===
===Turbulence Parameters===
Specifies turbulence parameters.
Specifies turbulence parameters.
*''Model'' – specifies the turbulence model used: "Subgrid", "Falconer", "Parabolic",  or "Mixing length".
*''Turbulence Model'' – Specifies the turbulence model used: "Subgrid", "Falconer", "Parabolic",  or "Mixing length".
*''Base value'' – constant contribution of eddy viscosity.
*''Edit Turbulence Parameters'' – Allows editing the parameters of the turbulence model. (Not recommended)
*''Current bottom coefficient'' – coefficient related to the contribution to eddy viscosity from the bottom shear.
**''Base value'' – Constant contribution of eddy viscosity.
*''Current horizontal coefficient''– coefficient related to the contribution to eddy viscosity from horizontal velocity gradients.
**''Current bottom coefficient'' – Coefficient related to the contribution to eddy viscosity from the bottom shear.
*''Wave bottom coefficient'' – coefficient related to the wave bottom friction contribution to eddy viscosity.
**''Current horizontal coefficient''– Coefficient related to the contribution to eddy viscosity from horizontal velocity gradients.
*''Wave breaking coefficient'' – coefficient related to the wave breaking contribution to eddy viscosity.
**''Wave bottom coefficient'' – Coefficient related to the wave bottom friction contribution to eddy viscosity.
**''Wave breaking coefficient'' – Coefficient related to the wave breaking contribution to eddy viscosity.
 
==Salinity/Temperature==
[[File:CMS-Flow ModelControl-SalinityTemperature.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Salinity/Temperature'' tab]]
Specifies model parameters relating to salinity and temperature modeling in CMS-Flow. The controls include:
===Water Properties===
*''Water density'' – Assumed to be constant for the simulation. If not specified, calculated based on the water temperature and salinity.
*''Constant water temperature'' – Used in the calculation of the water kinematic viscosity and water density if not specified.
===Salinity===
*''Calculate salinity'' – Turning on this option allows specifying the salinity options. If this is option is not used, salinity will not be included in the model run.
*''Initial condition'' – Salinity transport requires that each cell have an initial value for salinity concentration (measured in ppt). CMS-Flow allows this value to start as a constant for each cell, in which case, during the initial (or ramp time)of the simulation the concentrations are distributing to natural values.
** "Global concentration" – This control specifies an initial concentration for the entire domain. The value 0.0 ppt (fresh water) is a commonly used value.
** "Spatially varied" – This option allows to bring up a ''Dataset'' dialog where it is possible to create or select a spatially varied dataset that will be used by CMS-Flow as the initial concentration at each cell.
===Temperature===
*''Calculate temperature'' – Turning on this option allows specifying the temperature options. If this is option is not used, temperature will not be included in the model run.
*''Initial condition'' – CMS-Flow allows this value to start as a constant for each cell, in which case, during the initial (or ramp time)of the simulation the concentrations are distributing to natural values.
** "Global concentration" – This control specifies an initial concentration for the entire domain. The value 0.0 ppt (fresh water) is a commonly used value.
** "Spatially varied" – This option allows to bring up a ''Dataset'' dialog where it is possible to create or select a spatially varied dataset that will be used by CMS-Flow as the initial concentration at each cell.
===Atmospheric Parameters===
To add atmospheric parameters, click on the '''Add Row''' [[File:Row-add.svg|16 px]] button. To remove atmospheric parameters, click on the '''Delete Row''' [[File:Row-delete.svg|16 px]] button.


===Bottom and Wall Friction===
After creating a row for atmospheric parameters, the following parameters can be entered:
Friction datasets can be created and specified to define a spatially variable bottom roughness to provide a resistance to flow. This value has little impact in deep ocean applications but can be important in shallow regions. This is a user editable dataset.  The available dataset types are:
*''Time''
*''Wave-current bottom friction coefficient'' – used for quadratic com-bined wave-current mean bed shear stress calculation.
*''Air Temp''
*''Coefficient''
*''Dewpoint''
*''Bed-slope friction coefficient'' – specifies whether to include the bed slope friction factor or not in the calculation of the bed friction.
*''Cloud Cover''
*''Wall friction'' – turns on or off wall friction.
*''Solar Radiation''
*''Bottom roughness dataset''


==Salinity==
[[File:CMS-FlowMC SalinityTab.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Salinity'' tab]]
Specifies model parameters relating to salinity modeling in CMS-Flow. The controls include:
*''Calculate salinity'' – toggling on this option allows specifying the salinity options. If this is option is not used, salinity will not be included in the model run.
===Time Steps===
In addition to the time step specified in the ''general parameters'' tab for hydrodynamic calculations, the explicit model also allows the specification of longer time step for the salinity dispersion process.
* ''Transport rate'' – If salinity is enabled in this tab, and the solver option is set to "explicit" in the ''Flow'' tab, the user must specify this time step. It must be larger than the hydrodynamic time step and is generally at least a factor of 20. The default transport rate time step is 60 seconds.
===Initial Condition===
Salinity transport requires that each cell have an initial value for salinity concentration (measured in ppt). CMS-Flow allows this value to start as a constant for each cell, in which case, during the initial (or ramp time)of the simulation the concentrations are distributing to natural values.
* "Global concentration" – This control allows the user to specify an initial concentration for the entire domain. The value 0.0 ppt (fresh water) is a commonly used value.
* "Spatially varied" – This option allows to bring up a ''Dataset'' dialog where the user can create or select a spatially varied dataset that will be used by CMS-Flow as the initial concentration at each cell. The ''Dataset'' dialog has the following options:
<blockquote>
* '''Create ''' &ndash; brings up the ''Dataset Toolbox'' where a new dataset can be created using the ''Data Calculator''.
* '''Select ''' &ndash; brings up an option to select an existing dataset already in the project.
* '''Unselect''' &ndash; removes the selected or created dataset.
[[File:CMS-FLowMC SalinityDataset.png|thumb|none|200 px|CMS-Flow ''Dataset'' dialog found in the ''Salinity'' tab of the ''Model Control'']]
</blockquote>
==Wave Data==
==Wave Data==
[[File:CMS-FlowMC WaveTab.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Wave'' tab using the "Inline Steering" option]]
[[File:CMS-Flow ModelControl-Wave.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Wave'' tab using the "Inline Steering" option]]
CMS-Flow includes three options on how to use wave data.
CMS-Flow includes three options on how to use wave data.
===None===
===None===
No wave data is imputed into the model.
No wave data is imputed into the model.
===Single wave condition===
===Single wave condition===
The effects of waves are input to the model in the form of spatially varying datasets. These datasets must already exist on the grid. The user simply selects which dataset to use.
The effects of waves are input to the model in the form of spatially varying datasets. These datasets must already exist on the grid. Simply select which dataset to use.
*''Significant wave height''
*''Significant wave height''
*''Peak wave period''
*''Peak wave period''
Line 95: Line 111:
*''Wave radiation stress gradients''
*''Wave radiation stress gradients''
*''Surface roller stress gradients''
*''Surface roller stress gradients''
Clicking on the '''Select''' button under any of the options with being up a ''Dataset'' dialog with two options. The '''Select''' button in the ''Dataset'' dialog will bring up a ''Select Dataset'' dialog where a dataset in the project can be chosen. The '''Unselect''' button will remove the selected dataset.
Clicking on the '''Dataset''' button under any of the options with being up a ''Select Dataset'' dialog where a dataset in the project can be chosen.


===Inline steering===
===Inline steering===
*''CMS-Wave file'' &ndash;  location of the grid file or the simulation file. Can either "Browse for file" or use the "Wave grid".
*''CMS-Wave file'' &ndash;  Location of the grid file or the simulation file. Can either "Browse for file" or use the "Wave grid".
*''Steering Interval'' &ndash; sets the recurring hot start output time. Option to use a "Constant" value or "Automatic" value.
*''Steering Interval'' &ndash; Sets the recurring hot start output time. Option to use a "Constant" value or "Automatic" value.
*''Wave Water Level'' &ndash;  determines the method used to calculate the water levels passed to the wave model. Option to select "Tidal", "Last time step", or "Tidal plus variation" (default value).
*''Wave Water Level Prediction'' &ndash;  Determines the method used to calculate the water levels passed to the wave model. Option to select "Tidal", "Last time step", or "Tidal plus variation" (default value).
*''Extrapolation Distances'' &ndash;  if checked this will write out FLOW_EXTRAPOLATION_DISTANCE and WAVE_EXTRAPOLATION_DISTANCE cards.
*''Extrapolation Distances'' &ndash;  If checked this will write out FLOW_EXTRAPOLATION_DISTANCE and WAVE_EXTRAPOLATION_DISTANCE cards.
<blockquote>
**''Flow to Wave'' &ndash; Determines the extrapolation distance used for flow variables on the wave grid. Option to set a "User specified" value or "Automatic" value.
*''Flow to Wave'' &ndash; determines the extrapolation distance used for flow variables on the wave grid. Option to set a "User specified" value or "Automatic" value.
**''Wave to Flow'' &ndash; Determines the extrapolation distance used for wave variables on the flow grid. Option to set a "User specified" value or "Automatic" value.
*''Wave to Flow'' &ndash; determines the extrapolation distance used for wave variables on the flow grid. Option to set a "User specified" value or "Automatic" value.
</blockquote>


==Wind Data==
==Wind Data==
[[File:CMS-FlowMC WindTab.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Wind'' tab]]
[[File:CMS-Flow ModelControl-Wind.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Wind'' tab]]
The user can turn on the option to tell CMS to include wind calculations in the simulation. Wind is simulated in CMS-Flow as a spatially constant, but temporally varying quantity. The model does not currently support tropical cyclonic winds.  
Turns on the option to tell CMS to include wind calculations in the simulation. Wind is simulated in CMS-Flow as a spatially constant, but temporally varying quantity. The model does not currently support tropical cyclonic winds.  


For more wind file information, see: [http://cirp.usace.army.mil/wiki/CMS-Flow_Wind_Forcing#Spatially_Variable_Wind_and_Atmospheric_Pressure CMS-Flow Wind Forcing on the CIRP wiki].
For more wind file information, see: [http://cirp.usace.army.mil/wiki/CMS-Flow_Wind_Forcing#Spatially_Variable_Wind_and_Atmospheric_Pressure CMS-Flow Wind Forcing on the CIRP wiki].
Line 116: Line 130:


===Spatially constant===  
===Spatially constant===  
*''Parameters'' &ndash; set through the time series editor below. Clicking the [[File:Add button.png]] button will add a row to the editor and clicking the [[File:Remove button.png]] button will remove a row. The follow options can be specified in each row:
*''Parameters'' &ndash; Set through the time series editor below. Clicking the '''Add Row''' [[File:Row-add.svg|16 px]] button will add a row to the editor and clicking the '''Delete Row''' [[File:Row-delete.svg|16 px]] button will remove a row. The follow options can be specified in each row:
<blockquote>
 
*''Time'' (hr) &ndash; specify time of wind measurement.
**''Time'' (hr) &ndash; Specify time of wind measurement.
*''Direction'' (deg) &ndash; specify the variation in direction of the wind in the simulation.
**''Direction'' (deg) &ndash; Specify the variation in direction of the wind in the simulation.
*''Velocity'' (m/s) &ndash; specify the variation of wind velocity in the simulation.
**''Velocity'' (m/s) &ndash; Specify the variation of wind velocity in the simulation.
</blockquote>
*''Anemometer height'' (m)
*''Anemometer height'' (m)


===Meteororological stations===
===Meteororological stations===
This option allows the user to insert data for multiple locations  
This option allows inserting data for multiple locations  
*''Mereorological  stations'' &ndash; this section contains a properties editor where each station can be defined.  A station is added using the [[File:Add button.png]] button or removed using the [[File:Remove button.png]] button. The options are:
*''Mereorological  stations'' &ndash; This section contains a properties editor where each station can be defined.  A station is added using the '''Add Row''' [[File:Row-add.svg|16 px]] button or removed a selected row using the '''Delete Row''' [[File:Row-delete.svg|16 px]] button. The options are:
<blockquote>
**''Name'' &ndash; The designated name of the station.
*''Name'' &ndash; the designated name of the station.
**''X(m) &ndash; X-axis location of meteorologic station.
*''X(m) &ndash; x-axis location of meteorologic station.
**''Y(m) &ndash; Y-axis location of meteorologic station.
*''Y(m) &ndash; y-axis location of meteorologic station.
**''Height (m)''
*''Height (m)''
**''Direction Curve'' &ndash; Launches an XY Series Editor window.
*''Direction Curve'' &ndash; launches an XY Series Editor window.
</blockquote>


*''Parameters'' &ndash; set through the time series editor below. Clicking the [[File:Add button.png]] button will add a row to the editor and clicking the [[File:Remove button.png]] button will remove a row. The follow options can be specified in each row:
*''Parameters'' &ndash; Set through the time series editor below. Clicking the '''Add Row''' [[File:Row-add.svg|16 px]] button will add a row to the editor and clicking the '''Delete Row''' [[File:Row-delete.svg|16 px]] button will remove a selected row. The follow options can be specified in each row:
<blockquote>
**''Time'' (hr) &ndash; Specify time of wind measurement.
*''Time'' (hr) &ndash; specify time of wind measurement.
**''Direction'' (deg) &ndash; Specify the variation in direction of the wind in the simulation.
*''Direction'' (deg) &ndash; specify the variation in direction of the wind in the simulation.
**''Velocity'' (m/s) &ndash; Specify the variation of wind velocity in the simulation.
*''Velocity'' (m/s) &ndash; specify the variation of wind velocity in the simulation.
</blockquote>


===Temporally and spatially varying from file===  
===Temporally and spatially varying from file===  
Line 164: Line 173:


==Output==
==Output==
[[Image:CMS-FlowMC OutputTab.png|thumb|380 px|CMS-Flow'' Model Control'' dialog showing the ''Output'' tab]]
[[File:CMS-Flow ModelControl-Output.png|thumb|380 px|CMS-Flow'' Model Control'' dialog showing the ''Output'' tab]]
This dialog allows the user to specify global output options for the simulation. This controls the datasets created by the engine which consist of spatially and temporally varied quantities (values per cell at each output time value).  
This dialog allows specifying global output options for the simulation. This controls the datasets created by the engine which consist of spatially and temporally varied quantities (values per cell at each output time value).  


These output datasets are stored in their respective XMDF (*.h5) files (e.g. current velocity in ''vel.h5'' and water surface elevation in ''wse.h5''). In previous versions of CMS-Flow all the datasets were stored in a single solution (sol.h5) file, though that is not an option in current versions.
These output datasets are stored in their respective XMDF (*.h5) files (e.g. current velocity in ''vel.h5'' and water surface elevation in ''wse.h5''). In previous versions of CMS-Flow all the datasets were stored in a single solution (sol.h5) file, though that is not an option in current versions.


===Output Times Lists===
===Output Times Lists===
Due to the potentially long simulation times, CMS-Flow does not output at a constant interval during the simulation. Instead, the user defines one or more lists of times. For each dataset output by the engine, the user selects one time list.  The selected quantity will be saved at each time in the time list.
Due to the potentially long simulation times, CMS-Flow does not output at a constant interval during the simulation. Instead, define one or more lists of times. Select one time list for each dataset output by the engine.  The selected quantity will be saved at each time in the time list.


CMS-Flow supports up to four different and individual sets of time values. The options for each list include:
CMS-Flow supports up to four different and individual sets of time values. The options for each list include:
Line 176: Line 185:
*''Increment (hrs)''
*''Increment (hrs)''
*''End time (hrs)''
*''End time (hrs)''
Each list can have multiple time sets. To add a time set, click on the Add (+) button. To remove a time set, click on the Remove (-) button.
Each list can have multiple time sets. To add a time set, click on the '''Add Row''' [[File:Row-add.svg|16 px]] button. To remove a time set, click on the '''Delete Row''' [[File:Row-delete.svg|16 px]] button.


===Output Datasets===
===Output Datasets===
Line 182: Line 191:
*''Water Surface Elevation''  
*''Water Surface Elevation''  
*''Current Velocity''  
*''Current Velocity''  
<blockquote>
**''Current Magnitude'' (optional)
*''Current Magnitude'' (optional)
**''Current Velocity''  
*''Current Velocity''  
</blockquote>
*''Morphology''
*''Morphology''
<blockquote>
**''Depth (through time)''
*''Depth (through time)''
**''Morphology Change'' (optional)
*''Morphology Change'' (optional)
</blockquote>
*''Transport''
*''Transport''
<blockquote>
**''Sediment Total-Load Capacity'' (optional)
*''Sediment Total-Load Capacity'' (optional)
**''Sediment Total-Load Concentration'' (optional)
*''Sediment Total-Load Concentration'' (optional)
**''Fraction Suspended'' (optional)
*''Fraction Suspended'' (optional)
**''Total Sediment Transport''
*''Total Sediment Transport''
**''Salinity Concentration'' (optional)  
*''Salinity Concentration'' (optional)  
</blockquote>
*''Waves''
*''Waves''
<blockquote>
**''Wave Height''
*''Wave Height''
**''Wave Period''
*''Wave Period''
**''Wave Height Vector''
*''Wave Height Vector''
**''Wave Dissipation'' (optional)
*''Wave Dissipation'' (optional)
</blockquote>
*''Wind''
*''Wind''
<blockquote>
**''Wind Speed'' (optional)
*''Wind Speed'' (optional)
**''Wind Speed Vector''
*''Wind Speed Vector''
</blockquote>
*''Eddy Viscosity''
*''Eddy Viscosity''


===Statistical Output===
===Statistical Output===
Statistical data can be written out for the following:  
CMS-Flow includes the ability to perform statistical evaluations of the time series solution computed for each cell over the user specified time range. Additional outputs containing steady state datasets for minimum, maximum, average, mean, etc... will be created in the solution. Statistical data can be written out for the following:  
*''Hydrodynamics''  
*''Hydrodynamics''  
*''Sediment Transport''  
*''Sediment Transport''  
Line 230: Line 229:
*''SMS Super ASCII files (*.sup, *.xy, *.dat)''
*''SMS Super ASCII files (*.sup, *.xy, *.dat)''
*''XMDF file compression''
*''XMDF file compression''
*''Simulation label'' &ndash; specify a name for output files.
*''Simulation label'' &ndash; Specify a name for output files.


==Sediment Transport==
==Sediment Transport==
[[File:CMS-FlowMC SedimentTab.png|thumb|380 px|CMS-Flow ''Model Control'' dialog showing the ''Sediment Transport'' tab]]
[[File:CMS-Flow ModelControl-SedimentTransport.png|thumb|420 px|CMS-Flow ''Model Control'' dialog showing the ''Sediment Transport'' tab]]
Sediment transport options can be specified by toggling on the ''Calculate Sediment Transport'' option in the ''Model Control''. Once this option is selected, sediment transport data will be calculated during the model run.  
Sediment transport options can be specified by toggling on the ''Calculate Sediment Transport'' option in the ''Model Control''. Once this option is selected, sediment transport data will be calculated during the model run.  


Line 241: Line 240:
===Timing===
===Timing===
The sediment transport and morphologic time steps are the time steps at which the transport and bed change equations are calculated.
The sediment transport and morphologic time steps are the time steps at which the transport and bed change equations are calculated.
* ''Transport Time Step (not used for implicit scheme)'' &ndash; used for transport equation.
<!--* ''Transport Time Step (not used for implicit scheme)'' &ndash; Used for transport equation.
* ''Morphologic Time Step (not used for implicit scheme)'' &ndash; used for updating bed elevation.
* ''Morphologic Time Step (not used for implicit scheme)'' &ndash; Used for updating bed elevation.-->
* ''Morphologic change start time'' &ndash; sets start time for the morphology change calculation.
* ''Morphologic change start time'' &ndash; Sets start time for the morphology change calculation.


===Formulation===
===Formulation===
* "Equilibrium Total Load" &ndash; assumes both the bed load and suspended load to be in equilibrium. The bed change is solved using a simple mass balance equation known as the Exner equation.
* "Equilibrium Total Load" &ndash; Assumes both the bed load and suspended load to be in equilibrium. The bed change is solved using a simple mass balance equation known as the Exner equation.
* "Equilibrium Bed load plus Nonequilibrium Susp Load" &ndash; conducted separately the calculations of suspended load and bed load. The bed load is assumed to be in equilibrium and is included in the bed change equation while the suspended load is solved through the solution of an advection-diffusion equation. Actually the advection diffusion equation is a non-equilibrium formulation, but because the bed load is assumed to be in equilibrium, this model is referred to the "Equilibrium A-D" model.
* "Equilibrium Bed load plus Nonequilibrium Susp Load" &ndash; Conducted separately the calculations of suspended load and bed load. The bed load is assumed to be in equilibrium and is included in the bed change equation while the suspended load is solved through the solution of an advection-diffusion equation. Actually the advection diffusion equation is a non-equilibrium formulation, but because the bed load is assumed to be in equilibrium, this model is referred to the "Equilibrium A-D" model.
* "Nonequilibrium Total Load" &ndash; assumes neither the bed nor suspended loads to be in equilibrium. The suspended- and bed-load transport equations are combined into a single equation and thus there is one less empirical parameter to estimate (adaptation length).
* "Nonequilibrium Total Load" &ndash; Assumes neither the bed nor suspended loads to be in equilibrium. The suspended- and bed-load transport equations are combined into a single equation and thus there is one less empirical parameter to estimate (adaptation length).
 
===Transport Formula===
===Transport Formula===
*''Transport Formula'' &ndash; selects the transport formula.
*''Transport Formula'' &ndash; Selects the transport formula.
<blockquote>
**"Lund-CIRP"
*"Lund-CIRP"
**"van Rijn"
*"van Rijn"
**"Soulsby-van Rijn"
*"Soulsby-van Rijn"
**"Watanabe"
*"Watanabe"
*''Concentration Profile'' &ndash; Selects the concentration profile to be used either in the equilibrium A-D or NET models. In the A-D model, it is used to estimate the near bed concentration, whereas in the NET, it is used in the total load correction factor.
</blockquote>
**"Exponential"
*''Concentration Profile'' &ndash; selects the concentration profile to be used either in the equilibrium A-D or NET models. In the A-D model, it is used to estimate the near bed concentration, whereas in the NET, it is used in the total load correction factor.
**"Rouse"
<blockquote>
**"Lund-CIRP"
*"Exponential"
**"van Rijn"
*"Rouse"
*''Watanabe Transbort Rate Coefficient'' &ndash; Sets the empirical coefficient which goes into the Watanabe transport formula.
*"Lund-CIRP"
*"van Rijn"
</blockquote>
*''Watanabe Transbort Rate Coefficient'' &ndash; sets the empirical coefficient which goes into the Watanabe transport formula.


===Properties===
===Properties===
*''Sediment Density'' &ndash; sets the sediment density in kg/m^3.
*''Sediment Density'' &ndash; Sets the sediment density in kg/m^3.
*''Sediment Porosity'' &ndash; sets the sediment porosity.
*''Sediment Porosity'' &ndash; Sets the sediment porosity.


===Scaling Factors and Coefficients===
===Scaling Factors and Coefficients===
*''Bed load scaling factor'' &ndash; calibration factor for bed load transport capacity formula
*''Bed load scaling factor'' &ndash; Calibration factor for bed load transport capacity formula
*''Suspended load scaling factor'' &ndash; calibration factor for suspended load transport capacity formula
*''Suspended load scaling factor'' &ndash; Calibration factor for suspended load transport capacity formula
*''Morphologic acceleration factor'' &ndash; directly multiplies by calculated bed change.
*''Morphologic acceleration factor'' &ndash; Directly multiplies by calculated bed change.
*''Bed slope diffusion coefficient''
*''Bed slope diffusion coefficient''
*''Hiding and exposure coefficient''
*''Hiding and exposure coefficient''
Line 279: Line 275:
The adaptation coefficient is an important parameter to consider in setting up the CMS sediment transport model. The sensitivity of results to the adaptation coefficient depends on the spatial and temporal scales of the problem.
The adaptation coefficient is an important parameter to consider in setting up the CMS sediment transport model. The sensitivity of results to the adaptation coefficient depends on the spatial and temporal scales of the problem.
*''Total load adaptation method''
*''Total load adaptation method''
<blockquote>
**"Constant length" &ndash; Temporally and spatially total load adaptation length is used for the whole domain.
*"Constant length" &ndash; temporally and spatially total load adaptation length is used for the whole domain.
***''Total load adaptation length''
<blockquote>
**"Constant time" &ndash; Temporally and spatially constant total-load adaptation time is used for the whole domain.
*''Total load adaptation length''
***''Total load adaptation time''
</blockquote>
**"Maximum of bed and suspended adaptation lengths" &ndash; Temporally and spatially constant total-load adaptation time that uses a maximum suspended load adaptation length and maximum bed load adaptation length.
*"Constant time" &ndash; temporally and spatially constant total-load adaptation time is used for the whole domain.
***''Bed load adaptation method'' &ndash; Specifies the bed load adaptation coefficient method. Options include:
<blockquote>
****"Constant Length" &ndash; Allows specifying a ''Bed load adaptation length''.
*''Total load adaptation time''
****"Constant Time" &ndash; Specifies the bed-load adaptation time.
</blockquote>
****"Depth Dependent" &ndash; Allows specifying a ''Bed load adaptation depth factor''.
*"Maximum of bed and suspended adaptation lengths" &ndash; temporally and spatially constant total-load adaptation time that uses a maximum suspended load adaptation length and maximum bed load adaptation length.
***''Suspended load adaptation method'' &ndash; Specifies the suspended load adaptation coefficient method. Options include:
<blockquote>
****"Constant length" &ndash; Allows specifying a ''Suspended adaptation length''.
*''Bed load adaptation method'' &ndash; Specifies the bed load adaptation coefficient method. Options include:
****"Constant time" &ndash; Allows specifying a ''Suspended adaptation time''.
<blockquote>
****"Constant coefficient" &ndash; Allows specifying a ''Suspended adaptation coefficient''.
*"Constant Length" &ndash; allows specifying a ''Bed load adaptation length''.
****"Armanini and Di Silvio"
*"Constant Time" &ndash; specifies the bed-load adaptation time.
****"Lin"
*"Depth Dependent" &ndash; allows specifying a ''Bed load adaptation depth factor''.
****"Gallappatti"
</blockquote>
**"Weighted average of bed and suspended adaptation lengths" &ndash; Has options similar to the "Maximum of bed and suspended adaptation lengths" option. A temporally and spatially constant total-load adaptation time that uses a suspended load adaptation length, a bed load adaptation length, and a fraction of suspended load of the total load.
*''Suspended load adaptation method'' &ndash; Specifies the suspended load adaptation coefficient method. Options include:
<blockquote>
*"Constant length" &ndash; allows specifying a ''Suspended adaptation length''.
*"Constant time" &ndash; allows specifying a ''Suspended adaptation time''.
*"Constant coefficient" &ndash; allows specifying a ''Suspended adaptation coefficient''.
*"Armanini and Di Silvio"
*"Lin"
*"Gallappatti"
</blockquote>
</blockquote>
*"Weighted average of bed and suspended adaptation lengths" &ndash; has options similar to the "Maximum of bed and suspended adaptation lengths" option. A temporally and spatially constant total-load adaptation time that uses a suspended load adaptation length, a bed load adaptation length, and a fraction of suspended load of the total load.
</blockquote>


===Size Classes===
===Size Classes===
The transported sediment material is discretized into different groups each representing the sediments within a specific size range.
The transported sediment material is discretized into different groups each representing the sediments within a specific size range.
*''Sediment size class diameters'' &ndash; To add a sediment class, click on the [[File:Add button.png]] button. To remove a sediment class, click on the [[File:Remove button.png]] button.
*''Sediment size class diameters'' &ndash; To add a sediment class, click on the '''Add Row''' [[File:Row-add.svg|16 px]] button. To remove a sediment class, click on the '''Delete Row''' [[File:Row-delete.svg|16 px]] button.
<blockquote>
**''Diameter'' &ndash; Sediment size class characteristic diameter.
*''Diameter'' &ndash; sediment size class characteristic diameter.
**''Fall Velocity Method'' &ndash; Sediment size class fall velocity formula.
*''Fall Velocity Method'' &ndash; sediment size class fall velocity formula.
**''Fall Velocity'' &ndash; Sediment size class fall velocity.
*''Fall Velocity'' &ndash; sediment size class fall velocity.
**''Cory Shape Factor'' &ndash; Sediment size class Corey Shape Factor. Used in the Wu and Wang (2006) sediment fall velocity formula.
*''Cory Shape Factor'' &ndash; sediment size class Corey Shape Factor. Used in the Wu and Wang (2006) sediment fall velocity formula.
**''Critical Sheer Method'' &ndash; Sediment size class characteristic critical shear stress formula.
*''Critical Sheer Method'' &ndash; sediment size class characteristic critical shear stress formula.
**''Critical Sheer Stress (Pa)'' &ndash; Sediment size class characteristic critical shear stress.
*''Critical Sheer Stress (Pa)'' &ndash; sediment size class characteristic critical shear stress.
</blockquote>


===Bed Composition===
===Bed Composition===
The initial bed layer thickness and composition are specified at least one layer for the whole grid.
The initial bed layer thickness and composition are specified at least one layer for the whole grid.
*''Bed layer block'' &ndash; To add a bed layer block, click on the [[File:Add button.png]] button. To remove a bed layer block, click on the [[File:Remove button.png]] button.
*''Enable simplified mulitple grain size definitions''
<blockquote>
*''Maximum number of bed layers''
*''Layer ID'' &ndash; specifies the bed layer number from the surface. If not specified then set the sequential bed layer block number.
*''Minimum bed layer thickness''
*''Thickness Dataset'' &ndash; specifies the file name and dataset path (within the file) for the bed layer thickness dataset.
*''Maximum bed layer thickness''
Percentile Diameters &ndash; indicate the percentage of diameters smaller than a specific diameter.
*''Mixing layer thickness'' &ndash; Can use either "Constant" or "Automatic".
{|
*''Mixing layer thickness'' &ndash; Set a value for constant layer thickness mixing.
*''Bed layer block'' &ndash; To add a bed layer block, click on the '''Add Row''' [[File:Row-add.svg|16 px]] button. To remove a bed layer block, click on the '''Delete Row''' [[File:Row-delete.svg|16 px]] button.
**''Layer ID'' &ndash; Specifies the bed layer number from the surface. If not specified then set the sequential bed layer block number.
**''Layer Thickness Type''
**''Layer Thickness Dataset'' &ndash; Specifies the file name and dataset path (within the file) for the bed layer thickness dataset.
**''Layer Thickness Constant''
::Percentile Diameters &ndash; Indicate the percentage of diameters smaller than a specific diameter.
::{|
|-
|-
|width="100"|
|width="100"|
Line 344: Line 333:
*''D95''
*''D95''
|}
|}
</blockquote>


===Avalanching===
===Avalanching===
Avalanching is the process of sediment sliding when the critical angle of repose is reached.
Avalanching is the process of sediment sliding when the critical angle of repose is reached.
*''Calculate Avalanching'' &ndash; turns on or off the avalanching.
*''Calculate Avalanching'' &ndash; Turns on or off the avalanching.
*''Critical bed slope'' &ndash; specifies the sediment repose angle. Avalanching is activated when the bed slope exceeds the repose angle.
*''Critical bed slope'' &ndash; Specifies the sediment repose angle. Avalanching is activated when the bed slope exceeds the repose angle.
*''Maximum number of iterations (implicit only)'' &ndash; maximum number of iterations for implicit solution scheme. When using the explicit scheme, one iteration is performed every time step.
*''Maximum number of iterations (implicit only)'' &ndash; Maximum number of iterations for implicit solution scheme. When using the explicit scheme, one iteration is performed every time step.


===Hardbottom===
===Hardbottom===
A morphologic constraint that provides the capability to simulate mixed bottom types within a single simulation.
A morphologic constraint that provides the capability to simulate mixed bottom types within a single simulation.
*''Hardbottom depth'' &ndash; Toggling on this option and using the '''Select''' button will bring up a ''Dataset'' dialog. The ''Dataset'' dialog has the following options:
*''Hardbottom depth'' &ndash; Turning on this option and using the '''Dataset''' button will bring up a ''Select hardbottom dataset'' dialog.
<blockquote>
* '''Create ''' &ndash; brings up the ''Dataset Toolbox'' where a new dataset can be created using the ''Data Calculator''.
* '''Select ''' &ndash; brings up an option to select an existing dataset already in the project.
* '''Unselect''' &ndash; removes the selected or created dataset.
</blockquote>


==Related Topics==
==Related Topics==
Line 367: Line 350:
{{Template:Navbox SMS}}
{{Template:Navbox SMS}}


[[Category:CMS-Flow|M]]
[[Category:CMS-Flow|Model]]
[[Category:CMS Dialogs]]
[[Category:CMS Dialogs|model]]
[[Category:SMS Model Control|C]]
[[Category:SMS Model Control|C]]
[[Category:External Links]]
[[Category:External Links]]

Latest revision as of 19:47, 17 March 2021


The CMS-Flow Model Control dialog allows viewing and editing the current parameters that affect how CMS-Flow runs and what options are to be included in the current simulation. The Model Control dialog is access by right-clicking on the CMS-Flow simulation object and selecting the Model Control command.

The dialog includes several tabs which partition the parameters into related groups. The tabs and their related parameters include:

General

Specifies general flow model parameters, controlling which model options the simulation will employ. The controls include:

CMS-Flow Model Control dialog showing the General tab

Time Control

This section sets the starting time, duration and hydraulic time step. The Ramp duration defines the length of an incremental loading portion at the beginning of the simulation. Controls include:

  • Start date/time – The hour and day at which to begin the model. This will be the first time step listed in any solution files.
  • Simulation duration – the length of the simulation in hours.
  • Ramp duration – The period of time in days at which to allow the model to “build up” or “ramp up” to a legitimate solution. Aids in the convergence of the model.
  • Second order skewness correction – Turns on or off the second order skewness correction which account for non-orthogonality in the telescoping grids.

Hot Start

These controls allow specifying a previously saved hot start file to be used as initial conditions or instruct CMS-Flow to save hot start files for future use.

  • Initial conditions file
  • Write Hot Start output file
  • Time to write out
  • Automatic recurring Hot Start file
  • Interval for writing recurring Hot Start file

See CMS-Flow Hot Start File for more information.

Solution Scheme

CMS-Flow now has two solution schemes. These include the traditional "explicit" scheme. This method requires that flow be tracked through each element, resulting in hydrodynamic time steps in the order of one to two seconds. The new option is an "implicit" scheme which uses finite volume technology, supports much larger time steps resulting in fewer time steps (shorter run times) and is identically mass conserving. When the implicit scheme is being used, one of the following matrix solver types should be specified.

  • Solution scheme – Can be set as "Implicit" or "Explicit".
  • Matric solver – Can be specified when using the "Implicit" option. Options are "Gauss-Seidel", "Gauss-Seidel-SOR", "BiCGSTab", or "GMRES".

Threads

CMS-Flow can take advantage of multiple processors using Open-MP parallelization technology. This control allows specifying the maximum number of threads that the engine should occupy.

  • Number of threads – Determines the number of threads used for parallel processing.

Flow

CMS-Flow Model Control dialog showing the Flow tab

Specifies general hydrodynamic or flow model parameters, controlling which model options the simulation will employ. The controls include:

Hydrodynamic Time Step

This control allows setting the hydrodynamic time step for the model. If the explicit solution scheme is being used, a recommended time step will be calculated based on grid cell size and depths.

  • Hydrodynamic time step – Sets the time step for the hydrodynamics.
  • Wetting and drying depth – Sets the minimum depth for wet cells.
  • Wave fluxes – Turns on and off the wave volume flux velocities.
  • Roller fluxes – Turns on or off the contribution to the wave volume flux velocities due to the surface roller in the surf zone. Only used if surface roller model is turned on.
  • Average latitude for Coriolis – Specifies the average latitude for the grid which is used for the Coriolis parameter.

Bottom and Wall Friction

Friction datasets can be created and specified to define a spatially variable bottom roughness to provide a resistance to flow. This value has little impact in deep ocean applications but can be important in shallow regions.

  • Wave-current bottom friction coefficient – This is a user editable dataset. The available dataset types are:
    • "Quadratic"
    • "Soulsby (1995) Data2"
    • "Soulsby (1995) Data13"
    • "Fredsoe (1984)"
    • "Huynh-Thanh and Temperville (1991)"
  • Coefficient – Used for quadratic combined wave-current mean bed shear stress calculation.
  • Bed-slope friction coefficient – Specifies whether to include the bed slope friction factor or not in the calculation of the bed friction.
  • Wall friction – Turns on or off wall friction.
  • Bottom roughness dataset – This section allows selecting a bottom roughness dataset located in the project.
    • Bottom roughness type – The type of bottom roughness dataset can be selected. Available types include: "Mannings N", "Bottom friction coefficient", and "Roughness height".
    • Bottom roughness – Selecting the Dataset button will open the Select bottom roughness dataset dialog where the desired dataset can be chosen.

Turbulence Parameters

Specifies turbulence parameters.

  • Turbulence Model – Specifies the turbulence model used: "Subgrid", "Falconer", "Parabolic", or "Mixing length".
  • Edit Turbulence Parameters – Allows editing the parameters of the turbulence model. (Not recommended)
    • Base value – Constant contribution of eddy viscosity.
    • Current bottom coefficient – Coefficient related to the contribution to eddy viscosity from the bottom shear.
    • Current horizontal coefficient– Coefficient related to the contribution to eddy viscosity from horizontal velocity gradients.
    • Wave bottom coefficient – Coefficient related to the wave bottom friction contribution to eddy viscosity.
    • Wave breaking coefficient – Coefficient related to the wave breaking contribution to eddy viscosity.

Salinity/Temperature

CMS-Flow Model Control dialog showing the Salinity/Temperature tab

Specifies model parameters relating to salinity and temperature modeling in CMS-Flow. The controls include:

Water Properties

  • Water density – Assumed to be constant for the simulation. If not specified, calculated based on the water temperature and salinity.
  • Constant water temperature – Used in the calculation of the water kinematic viscosity and water density if not specified.

Salinity

  • Calculate salinity – Turning on this option allows specifying the salinity options. If this is option is not used, salinity will not be included in the model run.
  • Initial condition – Salinity transport requires that each cell have an initial value for salinity concentration (measured in ppt). CMS-Flow allows this value to start as a constant for each cell, in which case, during the initial (or ramp time)of the simulation the concentrations are distributing to natural values.
    • "Global concentration" – This control specifies an initial concentration for the entire domain. The value 0.0 ppt (fresh water) is a commonly used value.
    • "Spatially varied" – This option allows to bring up a Dataset dialog where it is possible to create or select a spatially varied dataset that will be used by CMS-Flow as the initial concentration at each cell.

Temperature

  • Calculate temperature – Turning on this option allows specifying the temperature options. If this is option is not used, temperature will not be included in the model run.
  • Initial condition – CMS-Flow allows this value to start as a constant for each cell, in which case, during the initial (or ramp time)of the simulation the concentrations are distributing to natural values.
    • "Global concentration" – This control specifies an initial concentration for the entire domain. The value 0.0 ppt (fresh water) is a commonly used value.
    • "Spatially varied" – This option allows to bring up a Dataset dialog where it is possible to create or select a spatially varied dataset that will be used by CMS-Flow as the initial concentration at each cell.

Atmospheric Parameters

To add atmospheric parameters, click on the Add Row Row-add.svg button. To remove atmospheric parameters, click on the Delete Row Row-delete.svg button.

After creating a row for atmospheric parameters, the following parameters can be entered:

  • Time
  • Air Temp
  • Dewpoint
  • Cloud Cover
  • Solar Radiation

Wave Data

CMS-Flow Model Control dialog showing the Wave tab using the "Inline Steering" option

CMS-Flow includes three options on how to use wave data.

None

No wave data is imputed into the model.

Single wave condition

The effects of waves are input to the model in the form of spatially varying datasets. These datasets must already exist on the grid. Simply select which dataset to use.

  • Significant wave height
  • Peak wave period
  • Mean wave direction
  • Wave breaking dissipation
  • Wave radiation stress gradients
  • Surface roller stress gradients

Clicking on the Dataset button under any of the options with being up a Select Dataset dialog where a dataset in the project can be chosen.

Inline steering

  • CMS-Wave file – Location of the grid file or the simulation file. Can either "Browse for file" or use the "Wave grid".
  • Steering Interval – Sets the recurring hot start output time. Option to use a "Constant" value or "Automatic" value.
  • Wave Water Level Prediction – Determines the method used to calculate the water levels passed to the wave model. Option to select "Tidal", "Last time step", or "Tidal plus variation" (default value).
  • Extrapolation Distances – If checked this will write out FLOW_EXTRAPOLATION_DISTANCE and WAVE_EXTRAPOLATION_DISTANCE cards.
    • Flow to Wave – Determines the extrapolation distance used for flow variables on the wave grid. Option to set a "User specified" value or "Automatic" value.
    • Wave to Flow – Determines the extrapolation distance used for wave variables on the flow grid. Option to set a "User specified" value or "Automatic" value.

Wind Data

CMS-Flow Model Control dialog showing the Wind tab

Turns on the option to tell CMS to include wind calculations in the simulation. Wind is simulated in CMS-Flow as a spatially constant, but temporally varying quantity. The model does not currently support tropical cyclonic winds.

For more wind file information, see: CMS-Flow Wind Forcing on the CIRP wiki.

None

No wind data is imputed into the model.

Spatially constant

  • Parameters – Set through the time series editor below. Clicking the Add Row Row-add.svg button will add a row to the editor and clicking the Delete Row Row-delete.svg button will remove a row. The follow options can be specified in each row:
    • Time (hr) – Specify time of wind measurement.
    • Direction (deg) – Specify the variation in direction of the wind in the simulation.
    • Velocity (m/s) – Specify the variation of wind velocity in the simulation.
  • Anemometer height (m)

Meteororological stations

This option allows inserting data for multiple locations

  • Mereorological stations – This section contains a properties editor where each station can be defined. A station is added using the Add Row Row-add.svg button or removed a selected row using the Delete Row Row-delete.svg button. The options are:
    • Name – The designated name of the station.
    • X(m) – X-axis location of meteorologic station.
    • Y(m) – Y-axis location of meteorologic station.
    • Height (m)
    • Direction Curve – Launches an XY Series Editor window.
  • Parameters – Set through the time series editor below. Clicking the Add Row Row-add.svg button will add a row to the editor and clicking the Delete Row Row-delete.svg button will remove a selected row. The follow options can be specified in each row:
    • Time (hr) – Specify time of wind measurement.
    • Direction (deg) – Specify the variation in direction of the wind in the simulation.
    • Velocity (m/s) – Specify the variation of wind velocity in the simulation.

Temporally and spatially varying from file

The File Type chosen will determine the rest of the options available for wind type. There are three File Type options available:

  • "Navy fleet numeric with pressure "
  • "OWI/PBL"
  • "Single ASCII file"

Navy fleet and ASCII files require the following input under "Parameters":

  • Number of values (X)
  • Number of values (Y)
  • Minimum X location
  • Maximum Y location
  • Time increment(s)
  • Distance between X values (m)
  • Distance between Y values (m)

Alternatively, the "XY File" option can be selected and a file imported with the above parameters.

OWI/PBL requires three different files:

  • Oceanweather Wind File
  • Oceanweather Pressure File
  • Oceanweather XY File

Output

CMS-Flow Model Control dialog showing the Output tab

This dialog allows specifying global output options for the simulation. This controls the datasets created by the engine which consist of spatially and temporally varied quantities (values per cell at each output time value).

These output datasets are stored in their respective XMDF (*.h5) files (e.g. current velocity in vel.h5 and water surface elevation in wse.h5). In previous versions of CMS-Flow all the datasets were stored in a single solution (sol.h5) file, though that is not an option in current versions.

Output Times Lists

Due to the potentially long simulation times, CMS-Flow does not output at a constant interval during the simulation. Instead, define one or more lists of times. Select one time list for each dataset output by the engine. The selected quantity will be saved at each time in the time list.

CMS-Flow supports up to four different and individual sets of time values. The options for each list include:

  • Start time (hrs)
  • Increment (hrs)
  • End time (hrs)

Each list can have multiple time sets. To add a time set, click on the Add Row Row-add.svg button. To remove a time set, click on the Delete Row Row-delete.svg button.

Output Datasets

CMS-Flow can output each of the following datasets. For each group, a time list must be specified. The optional datasets may turned off/on by clicking on their checkboxes in the output dataset tree.

  • Water Surface Elevation
  • Current Velocity
    • Current Magnitude (optional)
    • Current Velocity
  • Morphology
    • Depth (through time)
    • Morphology Change (optional)
  • Transport
    • Sediment Total-Load Capacity (optional)
    • Sediment Total-Load Concentration (optional)
    • Fraction Suspended (optional)
    • Total Sediment Transport
    • Salinity Concentration (optional)
  • Waves
    • Wave Height
    • Wave Period
    • Wave Height Vector
    • Wave Dissipation (optional)
  • Wind
    • Wind Speed (optional)
    • Wind Speed Vector
  • Eddy Viscosity

Statistical Output

CMS-Flow includes the ability to perform statistical evaluations of the time series solution computed for each cell over the user specified time range. Additional outputs containing steady state datasets for minimum, maximum, average, mean, etc... will be created in the solution. Statistical data can be written out for the following:

  • Hydrodynamics
  • Sediment Transport
  • Salinity

The options are turned on by toggles. For any option that is turn on, specify the following:

  • Start time (hrs)
  • Increment (hrs)
  • End time (hrs)

Output Options

Output can be written out in ASCII format and the XMDF files can be compressed. These options are turned on by toggle boxes. All datasets created by the model will be labeled with a simulation label and quantity label.

The following file output options are available:

  • Tecplot snap shot (*.dat) and history files (*.his)
  • SMS Super ASCII files (*.sup, *.xy, *.dat)
  • XMDF file compression
  • Simulation label – Specify a name for output files.

Sediment Transport

CMS-Flow Model Control dialog showing the Sediment Transport tab

Sediment transport options can be specified by toggling on the Calculate Sediment Transport option in the Model Control. Once this option is selected, sediment transport data will be calculated during the model run.

More information on sediment transport can be found at: Two-Dimensional Depth-Averaged Circulation Model CMS-M2D: Version 3.0, Report 2, Sediment Transport and Morphology Change[1]

The options for sediment transport are:

Timing

The sediment transport and morphologic time steps are the time steps at which the transport and bed change equations are calculated.

  • Morphologic change start time – Sets start time for the morphology change calculation.

Formulation

  • "Equilibrium Total Load" – Assumes both the bed load and suspended load to be in equilibrium. The bed change is solved using a simple mass balance equation known as the Exner equation.
  • "Equilibrium Bed load plus Nonequilibrium Susp Load" – Conducted separately the calculations of suspended load and bed load. The bed load is assumed to be in equilibrium and is included in the bed change equation while the suspended load is solved through the solution of an advection-diffusion equation. Actually the advection diffusion equation is a non-equilibrium formulation, but because the bed load is assumed to be in equilibrium, this model is referred to the "Equilibrium A-D" model.
  • "Nonequilibrium Total Load" – Assumes neither the bed nor suspended loads to be in equilibrium. The suspended- and bed-load transport equations are combined into a single equation and thus there is one less empirical parameter to estimate (adaptation length).

Transport Formula

  • Transport Formula – Selects the transport formula.
    • "Lund-CIRP"
    • "van Rijn"
    • "Soulsby-van Rijn"
    • "Watanabe"
  • Concentration Profile – Selects the concentration profile to be used either in the equilibrium A-D or NET models. In the A-D model, it is used to estimate the near bed concentration, whereas in the NET, it is used in the total load correction factor.
    • "Exponential"
    • "Rouse"
    • "Lund-CIRP"
    • "van Rijn"
  • Watanabe Transbort Rate Coefficient – Sets the empirical coefficient which goes into the Watanabe transport formula.

Properties

  • Sediment Density – Sets the sediment density in kg/m^3.
  • Sediment Porosity – Sets the sediment porosity.

Scaling Factors and Coefficients

  • Bed load scaling factor – Calibration factor for bed load transport capacity formula
  • Suspended load scaling factor – Calibration factor for suspended load transport capacity formula
  • Morphologic acceleration factor – Directly multiplies by calculated bed change.
  • Bed slope diffusion coefficient
  • Hiding and exposure coefficient

Adaptation

The adaptation coefficient is an important parameter to consider in setting up the CMS sediment transport model. The sensitivity of results to the adaptation coefficient depends on the spatial and temporal scales of the problem.

  • Total load adaptation method
    • "Constant length" – Temporally and spatially total load adaptation length is used for the whole domain.
      • Total load adaptation length
    • "Constant time" – Temporally and spatially constant total-load adaptation time is used for the whole domain.
      • Total load adaptation time
    • "Maximum of bed and suspended adaptation lengths" – Temporally and spatially constant total-load adaptation time that uses a maximum suspended load adaptation length and maximum bed load adaptation length.
      • Bed load adaptation method – Specifies the bed load adaptation coefficient method. Options include:
        • "Constant Length" – Allows specifying a Bed load adaptation length.
        • "Constant Time" – Specifies the bed-load adaptation time.
        • "Depth Dependent" – Allows specifying a Bed load adaptation depth factor.
      • Suspended load adaptation method – Specifies the suspended load adaptation coefficient method. Options include:
        • "Constant length" – Allows specifying a Suspended adaptation length.
        • "Constant time" – Allows specifying a Suspended adaptation time.
        • "Constant coefficient" – Allows specifying a Suspended adaptation coefficient.
        • "Armanini and Di Silvio"
        • "Lin"
        • "Gallappatti"
    • "Weighted average of bed and suspended adaptation lengths" – Has options similar to the "Maximum of bed and suspended adaptation lengths" option. A temporally and spatially constant total-load adaptation time that uses a suspended load adaptation length, a bed load adaptation length, and a fraction of suspended load of the total load.

Size Classes

The transported sediment material is discretized into different groups each representing the sediments within a specific size range.

  • Sediment size class diameters – To add a sediment class, click on the Add Row Row-add.svg button. To remove a sediment class, click on the Delete Row Row-delete.svg button.
    • Diameter – Sediment size class characteristic diameter.
    • Fall Velocity Method – Sediment size class fall velocity formula.
    • Fall Velocity – Sediment size class fall velocity.
    • Cory Shape Factor – Sediment size class Corey Shape Factor. Used in the Wu and Wang (2006) sediment fall velocity formula.
    • Critical Sheer Method – Sediment size class characteristic critical shear stress formula.
    • Critical Sheer Stress (Pa) – Sediment size class characteristic critical shear stress.

Bed Composition

The initial bed layer thickness and composition are specified at least one layer for the whole grid.

  • Enable simplified mulitple grain size definitions
  • Maximum number of bed layers
  • Minimum bed layer thickness
  • Maximum bed layer thickness
  • Mixing layer thickness – Can use either "Constant" or "Automatic".
  • Mixing layer thickness – Set a value for constant layer thickness mixing.
  • Bed layer block – To add a bed layer block, click on the Add Row Row-add.svg button. To remove a bed layer block, click on the Delete Row Row-delete.svg button.
    • Layer ID – Specifies the bed layer number from the surface. If not specified then set the sequential bed layer block number.
    • Layer Thickness Type
    • Layer Thickness Dataset – Specifies the file name and dataset path (within the file) for the bed layer thickness dataset.
    • Layer Thickness Constant
Percentile Diameters – Indicate the percentage of diameters smaller than a specific diameter.
  • D05
  • D10
  • D16
  • D20
  • D30
  • D35
  • D50
  • D65
  • D84
  • D90
  • D95

Avalanching

Avalanching is the process of sediment sliding when the critical angle of repose is reached.

  • Calculate Avalanching – Turns on or off the avalanching.
  • Critical bed slope – Specifies the sediment repose angle. Avalanching is activated when the bed slope exceeds the repose angle.
  • Maximum number of iterations (implicit only) – Maximum number of iterations for implicit solution scheme. When using the explicit scheme, one iteration is performed every time step.

Hardbottom

A morphologic constraint that provides the capability to simulate mixed bottom types within a single simulation.

  • Hardbottom depth – Turning on this option and using the Dataset button will bring up a Select hardbottom dataset dialog.

Related Topics