View source for CMS-Flow Multiple-sized Sediment Transport

← CMS-Flow Multiple-sized Sediment Transport
You do not have permission to edit this page, for the following reason:
The action you have requested is limited to users in the group: CIRP.
You can view and copy the source of this page.
[[Image:Mixing_Terms.png|thumb|right|500px|Figure  1. ''CMS-Flow  Model Control'' : ''Model Parameters'' tab in SMS 11.0.]]
All of  the CMS-Flow model parameters, settings, and output options are  controlled from the ''CMS-Flow Model Control'' window (Figure 1). The  window has several tabs including the ''Flow'' tab in which most of the  general settings are set for CMS-Flow. To open the ''CMS-Flow Model  Control'' window, click on ''CMS-Flow'' | ''Model Control''. The first  tab will be the ''Flow'' tab. There are several sections within the tab  including ''Time Control'' and ''Hot Start'' options. 


= Grain Size Specification =

{|  border="1"
! Card  !! Arguments !!  Example !! Description
|-
| SEDIMENT_SIZE_CLASS_NUMBER || INTEGER || 3  || Specifies the number of grain size classes. 
|-
| MULTIPLE_GRAIN_SIZES || INTEGER  [REAL, REAL,..., REAL]  || 3 0.1 0.2 0.3 || Specifies the number of grain sizes followed by the grain sizes for each size class in mm.  
|-
| SEDIMENT_SIZE_CLASS_DIAMETERS || INTEGER  [REAL,  REAL,..., REAL] || 3 0.1 0.2 0.3 || Specifies the number of grain sizes followed by the grain sizes for each size class in mm.  Same as ULTIPLE_GRAIN_SIZES. 
|-
| SEDIMENT_SIZE_CLASS_LIMITS ||  INTEGER   [REAL,  REAL,..., REAL] || 4 0.07 0.15 0.26 0.34 || Specifies the size classes limits. The first entry is the number of size class limits which is one greater than the number of size classes.
|}

= Fractional Bed Composition =

{|  border="1"
! Card  !! Arguments !!  Default/Format !! Range !! Description
|-
| BED_COMPOSITION_INPUT || CHARACTER || D50_SIGMA <nowiki>|</nowiki> D16_D50_D84 <nowiki>|</nowiki> D35_D50_D90  <nowiki>|</nowiki> SIZE_CLASS_FRACTIONS <nowiki>|</nowiki> FRACTIONS_DATASET || Selects the method for specifying the bed material  composition.
|}

== D50 Dataset and Standard Deviation ==
{|  border="1"
! Card  !! Arguments !!   Default/Format !! Range !! Description
|-
| D50_DATASET || CHARACTER  || none || ||
|-
| SEDIMENT_STANDARD_DEVIATION || REAL ||  || ||
|}

== D16, D50, and D84 Datasets ==
{|  border="1"
! Card  !! Arguments !! Default/Format !! Description
|-
| D16_DATASET || CHARACTER CHARACTER || [file name] [dataset path and name] || Specifies the D16 dataset path and file name.
|-
| D50_DATASET || CHARACTER CHARACTER <nowiki>|</nowiki> CHARACTER  || [dataset path and name] <nowiki>|</nowiki> [file name] [dataset path and name ]|| Specifies the D50 dataset path and file name. If the file is not specified than it is assumed to be the model parameters file name (*_mp.h5). 
|-
| D84_DATASET || CHARACTER CHARACTER  || [file name] [dataset path and name]|| Specifies the D50 dataset path and file name. 
|-
| CUSTOM_DATASET || CHARACTER CHARACTER  || [file name]  [dataset path and name]|| Specifies a custom dataset path and file name. The custom dataset can be used for any additional user defined dataset. The name of the dataset must be equal to the variable name. For example the D16 dataset must be named D16 and cannot be myD16. 
|}

=== Custom Datasets ===
The first approach of specifying the D16 and D84 datasets is by using the ''Custom Input Datasets'' section under the ''Input'' tab of the ''CMS-Flow Model Control'' window. The advantage of using this approach is that the user can edit the datasets once they are created without having to map each dataset as the ''Elevation'' dataset. It also avoids having to specify the dataset files and names manually in the *.cmcards file. The steps for specifying the D16 and D84 datasets are outlined below:

:1 Open ''CMS-Flow Model Control'' window and go to the ''Input'' tab.
:2 Create the D16 and D84 datasets using the ''Custom Input Datasets'' section on the upper right of the ''Input'' tab.
::2.1 To create the D16 dataset, click on the ''New'' buttom and a window will appear titled ''New Editable Dataset''. 
::2.2 Name the dataset D16 for the D16 dataset or D84 for the D84 dataset. The names must be correct for CMS to be able to interpret the dataset. 
::2.3 Set the initial values by either specifying a spatially constant value or selecting a current dataset.
::2.4 Click ''OK'' in the ''New Editable Dataset'' window
::2.5 Repeat steps 2.1 through 2.3 for the D84 dataset.
::2.6 Click ''OK'' in the ''CMS-Flow Model Control'' window 
"3 Save the CMS-Flow project.

{| border="0"
| [[image:Create_D16.png|thumb|400px|Figure 2. Creating Custom  Datasets for D16 and D84.]] 
| [[image:D16_D50_D84_Project_Explorer.png|thumb|300px|Figure 3. SMS project explorer showing Custom Datasets for D16 and D84.]]
|}

<br style="clear:both" />
[[image:Input_Datasets_D16_D84.png|thumb|left|400px|  Figure 3. SMS project explorer showing Custom Datasets for D16 and D84.  ]]

<br style="clear:both" />

=== Exported Datasets ===
[[image:Create_D16_Data_Calculator.png|thumb|right|500px| Figure 3. SMS  project explorer showing Custom Datasets for D16 and D84. ]]
An alternate approach for specifying datasets is by exporting them into XMDF files and then specifying the file names and paths in the ''Advanced'' cards section of the *.cmcmards file. The advantage of this approach is that is allows more flexibility in specifying project alternatives and also works for SMS versions 10.1 and earlier. 

[[image:Cannot_Edit_D16.png|thumb|right|500px| Figure 3. SMS    project explorer showing Custom Datasets for D16 and D84. ]]

[[image:Map_D16_to_Elevation.png|thumb|right|500px| Figure 3.  SMS     project  explorer showing Custom Datasets for D16 and D84. ]]

[[image:Select_D16_Dataset.png|thumb|right|500px| Figure 3.  SMS      project  explorer showing Custom Datasets for D16 and D84. ]]

[[image:D16_Elevation_Dataset.png|thumb|left|500px|  Figure 3. SMS   project explorer showing Custom Datasets for D16 and  D84. ]]

[[image:Export_D16_D84_Explorer.png|thumb|left|500px| Figure 3. SMS    project  explorer showing Custom Datasets for D16 and D84. ]]

<br style="clear:both" />

== D35, D50, and D90 Datasets ==
{|  border="1"
! Card  !! Arguments !!    Default/Format !! Range !! Description
|-
|-
| D35_DATASET || CHARACTER  || none || ||
|-
| D50_DATASET || CHARACTER  || none || ||
|-
| D90_DATASET || CHARACTER  || none || ||
|}

== Size Class Fractions ==
For this case, the fractional bed compositions are specified for each size class for all cells and all bed layers.
The fractional bed compositions must sum to 1.0. 

{|  border="1"
! Card  !! Arguments !!  Example !! Description
|-
| SEDIMENT_SIZE_CLASS_FRACTIONS || INTEGER [REAL,  REAL,..., REAL] || 3 0.2 0.5 0.3  || Specifies the fractional composition for each size class for all cells and bed layers. The first entry is the number of grain size classes. 
|}

== Fractional Composition Dataset ==

{|  border="1"
! Card  !! Arguments !!  Default/Format !! Range !! Description
|-
| BED_FRACTIONAL_COMPOSITION_DATASET || CHARACTER CHARACTER  || [<grid  file>] [<grid  name>//"Datasets/<Name>"] || Fractional  bed composition file. Necessary when setting BED_COMPOSITION_INPUT to  FRACTION_DATASET. 
|}

= Bed Layer Thickness =
'''Table  1. CMS-Flow cards related to the general  parameters'''
{|  border="1"
! Card  !!  Arguments !! Default/Format !! Range !! Description
|-
| BED_LAYER_THICKNESS_INPUT || CHARACTER || NONE || NONE <nowiki>|</nowiki> CONSTANT <nowiki>|</nowiki> LAYER_THICKNESS <nowiki>|</nowiki> LAYER_DATASET || ||
|-
|  BED_LAYER_THICKNESS_DATASET || CHARACTER CHARACTER  || none || [file] [path]  || Specifies the bed layer thickness file and dataset path. 
|-
| BED_LAYERS_MAX_NUMBER || INTEGER  ||  || ||
|-
| BED_LAYERS_CONSTANT_THICKNESS || INTEGER   [REAL,  REAL,..., REAL] ||  || ||
|-
|  BED_LAYERS_THICKNESS || INTEGER       [REAL,  REAL,..., REAL] ||  || ||
|-
| BED_LAYERS_CONSTANT_THICKNESS || INTEGER   [REAL,  REAL,..., REAL] ||  || ||
|-
|  BED_LAYERS_CONSTANT_THICKNESS || INTEGER  [REAL,  REAL,..., REAL] ||  ||  ||
|}

= Mixing Layer =

{|  border="1"
! Card  !! Arguments !!  Default/Format !! Range !! Description
|-
| MIXING_LAYER_CONSTANT_THICKNESS ||  INTEGER  [REAL,  REAL,..., REAL] ||  || ||
|-
| MIXING_LAYER_MIN_THICKNESS || INTEGER  [REAL,  REAL,...,  REAL] ||  || ||
|}

= Parameters =
The  general parameters are the water density and temperature. The CMS-Flow  cards for the general parameters are described in the table below. 

{|  border="1"
! Card  !! Arguments !!  Default/Format !! Range !! Description
|-
| HIDING_EXPOSURE_COEFFICIENT || REAL ||  1025 ||  - ||Water density in  kg/m^3. 
|-
| HIDING_EXPOSURE_COEFF ||  REAL  || 15 || - || Water temperature in degrees  Celcius.
|}


= Boundary and Initial Conditions =
{|  border="1"
! Card  !! Arguments !!  Default/Format !! Range  !! Description
|-
| SEDIMENT_INFLOW_LOADING_FACTOR || REAL ||   1025 ||  - ||Water density in  kg/m^3. 
|-
| SEDIMENT_FLUX_CELLSTRING || REAL ||    1025 ||  - ||Water density in  kg/m^3. 
|}

<br  style="clear:both" />

= Output Files and Datasets =

{|  border="1"
! Card  !! Arguments !!   Default/Format !! Range  !! Description
|-
| BED_OUT_TIMES_LIST || INTEGER ||   1025 ||  - ||Water density in   kg/m^3. 
|-
| SEDMIX_OUT_TIMES_LIST || INTEGER ||   1025 ||   - ||Water density in   kg/m^3. 
|}

<br  style="clear:both" />

= Examples =

* Example 1

 SEDIMENT_MAX_ITERATIONS             30    
 SEDIMENT_STATISTICS                 120.0 720.0    
 BED_COMPOSITION_INPUT               D50_SIGMA       
 MULTIPLE_GRAIN_SIZES                6 0.1 0.126 0.16 0.2 0.25 0.31
 SEDIMENT_STANDARD_DEVIATION         1.3       
 BED_LAYER_CONSTANT_THICKNESS        0.5       
 MIXING_LAYER_CONSTANT_THICKNESS     0.1      
 MIXING_LAYER_MIN_THICKNESS          0.05      
 HIDING_EXPOSURE_COEFFICIENT         1.0       
 SEDMIX_OUT_TIMES_LIST               2    
 BED_OUT_TIMES_LIST                  2    
 CALC_MORPH_DURING_RAMP              OFF   

* Example 2

 SEDIMENT_MAX_ITER                   30 
 BED_COMPOSITION_INPUT               D50_SIGMA  
 SEDIMENT_STANDARD_DEVATION          1.5
 MULTIPLE_GRAIN_SIZES                5 0.08 0.12 0.17 0.28 0.45
 BED_LAYER_CONSTANT_THICKNESS        0.5
 MIXING_LAYER_CONSTANT_THICKNESS     0.02       
 MIXING_LAYER_MIN_THICKNESS          0.01 

----
[[CMS#Documentation  Portal | Documentation Portal]]
Template used on this page:
Template:Equation (view source)
Return to CMS-Flow Multiple-sized Sediment Transport.
Retrieved from "https://cirpwiki.info/wiki/CMS-Flow_Multiple-sized_Sediment_Transport"
View source for CMS-Flow Multiple-sized Sediment Transport

Navigation menu

Search
