User Guide 011: Difference between revisions
No edit summary |
No edit summary |
||
(2 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
---- | |||
=Notes<nowiki>:</nowiki>= | =Notes<nowiki>:</nowiki>= | ||
Line 16: | Line 18: | ||
:• A good and simple way of estimating the grain size classed based only on the size limits of the distribution is by distributing the diameters logarithmically<nowiki>:</nowiki> | :• A good and simple way of estimating the grain size classed based only on the size limits of the distribution is by distributing the diameters logarithmically<nowiki>:</nowiki> | ||
{{Equation|<math>d_k = exp \left[ln d_1 + ln(d_N / d_1)\frac{k-1}{N-1} \right]</math>|2-22}} | {{Equation|<math>d_k = exp \left[ln \ d_1 + ln(d_N / d_1)\frac{k-1}{N-1} \right]</math>|2-22}} | ||
where ''N'' is the number of sediment size classes, ''k'' indicates the sediment size class, and the subscript indicates the size class num-ber. This leads diameters more closely spaced in the finer grain sizes and more loosely spaced in the coarser grain sizes. Since the sediment transport is larger for the finer grain sizes, it makes sense to give more resolution near the finer grain sizes. | where ''N'' is the number of sediment size classes, ''k'' indicates the sediment size class, and the subscript indicates the size class num-ber. This leads diameters more closely spaced in the finer grain sizes and more loosely spaced in the coarser grain sizes. Since the sediment transport is larger for the finer grain sizes, it makes sense to give more resolution near the finer grain sizes. | ||
Line 38: | Line 40: | ||
[[File:fig_2-84.png]] | [[File:fig_2-84.png]] | ||
Figure 2-84. Sediment size class Fall Velocity Method options in the Size Class section within the Sediment tab of the CMS-Flow Model Control window in SMS 11.1. | Figure 2-84. Sediment size class ''Fall Velocity Method'' options in the ''Size Class'' section within the ''Sediment'' tab of the ''CMS-Flow Model Control'' window in SMS 11.1. | ||
The cards used to specify the sediment fall velocity are described in the table below. | The cards used to specify the sediment fall velocity are described in the table below. | ||
Table 2-74. CMS-Flow cards used for specifying the sediment size class fall velocity. | |||
{|class="wikitable" | |||
|- | |||
!Input | |||
!Format | |||
!Notes | |||
|- | |||
|Fall Velocity | |||
|[card=FALL_VELOCITY, parent=SedClass, | |||
exclusion=wsform] | |||
[name=wsfall, type=float, default=none, | |||
range=(wsfall>0.0 ’m/s’)] | |||
[name=wsfallUnits, type=char, , | |||
options=VelUnits default=’m/s’] | |||
|Sediment size class fall velocity. | |||
|- | |||
|Fall Velocity Formula | |||
|[card=FALL_VELOCITY_FORMULA, parent=SedClass] | |||
[name=wsform, type=char, | |||
options=(SOULSBY,WU_WANG), default=none] | |||
|Sediment size class fall velocity formula. | |||
|- | |||
|Corey | |||
Shape | |||
Factor | |||
|[card=COREY_SHAPE_FACTOR, parent=SedClass] | |||
[name=Corey, type=float, default=0.7, | |||
range=(0.2<corey<1.0), | |||
dependence=(wsform=WU_WANG)] | |||
|Sediment size class Corey Shape Factor. Used in the Wu and Wang (2006) sediment fall velocity formula. | |||
|} | |||
The Soulsby (1997) formula is given by | The Soulsby (1997) formula is given by | ||
{{Equation|<math>\omega_s = \frac{v}{d}\left[(10.36^2 + 1.049d_* ^3)^1/2 | {{Equation|<math>\omega_s = \frac{v}{d}\left[(10.36^2 + 1.049d_* ^3)^{1/2} -10.36 \right]</math>|2-23}} | ||
where d<sub>*</sub> is the dimensionless grain size | where d<sub>*</sub> is the dimensionless grain size | ||
Line 58: | Line 91: | ||
{{Equation|<math> \omega_s = \frac{M_\nu}{N_d}\left[\sqrt{\frac{1}{4} \left(\frac{4N}{3M^2} d_* ^3 \right)^{1/n}} - \frac{1}{2} \right]^n</math>|2-25}} | {{Equation|<math> \omega_s = \frac{M_\nu}{N_d}\left[\sqrt{\frac{1}{4} \left(\frac{4N}{3M^2} d_* ^3 \right)^{1/n}} - \frac{1}{2} \right]^n</math>|2-25}} | ||
where ''M = 53.5 exp(-0.65F<sub>S</sub>) , N = 5.65 exp(-2.5F<sub>S</sub>) , n = 0.7 + 0.9F<sub>S</sub>''. Here F<sub>S</sub> is the Corey shape factor defined as <math | where ''M = 53.5 exp(-0.65F<sub>S</sub>) , N = 5.65 exp(-2.5F<sub>S</sub>) , n = 0.7 + 0.9F<sub>S</sub>''. Here F<sub>S</sub> is the Corey shape factor defined as <math> F_S = d_S / \sqrt{d_I d_L} </math>in which d<sub>s</sub> ,d<sub>I</sub> , and d<sub>L</sub> are the diameters of the short, intermediate and long mutually perpendicular axes. Naturally worn quartz sands have a typical Corey shape factor of 0.7 and calcareous sand of about 0.55. | ||
=Notes<nowiki>:</nowiki>= | =Notes<nowiki>:</nowiki>= | ||
Line 87: | Line 120: | ||
The cards used to specify the sediment size class critical shear stress are described in the table below. | The cards used to specify the sediment size class critical shear stress are described in the table below. | ||
Table 2-75. CMS-Flow cards used for specifying the critical shear stress. | |||
{|class="wikitable" | |||
|- | |||
!Input | |||
!Format | |||
!Notes | |||
|- | |||
|Critical Shields | |||
Parameter | |||
|[card=SHIELDS_PARAMETER, parent=SedClass] | |||
[name=thetacr, type=float, default=none, | |||
range=(thetacr>0.0)] | |||
|Sediment size class characteristic diameter. | |||
|- | |||
|Critical | |||
Shear | |||
Stress | |||
|[card=(CRITICAL_SHEAR,CRITICAL_STRESS, | |||
parent=SedClass)] | |||
[name=taucr, type=float, default=none, | |||
range=(taucr>0.0)] | |||
[name=taucrUnits, type=char, | |||
options=PresUnits, default=’Pa’] | |||
|Sediment size class characteristic critical shear stress. | |||
|- | |||
|Critical | |||
Shear | |||
Stress | |||
Formula | |||
|[card=(CRITICAL_SHEAR_FORMULA, | |||
CRITICAL_STRES_FORMULA)]] | |||
[name=wsform, type=char, | |||
options=(SOULSBY,WU_WANG), | |||
default=SOULSBY] | |||
|Sediment size class characteristic critical shear stress formula. | |||
|} | |||
The critical shear stress, <math>\tau_{cr}</math> , is related to the Shields parameter, <math>\Theta_{cr}</math> , by | The critical shear stress, <math>\tau_{cr}</math> , is related to the Shields parameter, <math>\Theta_{cr}</math> , by | ||
Line 95: | Line 163: | ||
Soulsby (1997) proposed the following formula for the Shields parameter | Soulsby (1997) proposed the following formula for the Shields parameter | ||
{{Equation|<math>\Theta_{cr} = \frac{0.3}{1 + 1.2d_*} + 0. | {{Equation|<math>\Theta_{cr} = \frac{0.3}{1 + 1.2d_*} + 0.055[1 - exp(-0.22d_*)]</math>|2-27}} | ||
The formula by Wu and Wang (1999) is given by | The formula by Wu and Wang (1999) is given by | ||
Line 110: | Line 178: | ||
=Notes | =Notes:= | ||
:• For noncohesive sediments, it is NOT recommended to use the sediment fall velocity, or shape factor as calibration parameters. These parameters should be estimated using field or literature data. If not measurements are available then the default formula should be used. | :• For noncohesive sediments, it is NOT recommended to use the sediment fall velocity, or shape factor as calibration parameters. These parameters should be estimated using field or literature data. If not measurements are available then the default formula should be used. | ||
Line 118: | Line 186: | ||
In the example below a single sediment size is specified. Since there is only one sediment size class, the bed sorting and gradation is not considered. | In the example below a single sediment size is specified. Since there is only one sediment size class, the bed sorting and gradation is not considered. | ||
Example 2-72. Single-size sediment transport size class specification. | |||
---- | |||
--SEDIMENT_SIZE_CLASS_BEGIN | |||
DIAMETER 0.2 ‘mm’ !Positive is upwards | |||
SEDIMENT_SIZE_CLASS_END | |||
-- | |||
In the following example three sediment size classes are considered which allows the model to track the bed composition. It is noted that not the same input parameters have to be specified for all sediment size classes. Any parameters which are not specified are set the default value. | In the following example three sediment size classes are considered which allows the model to track the bed composition. It is noted that not the same input parameters have to be specified for all sediment size classes. Any parameters which are not specified are set the default value. | ||
Example 2-73. Multiple-sized sediment transport size class specification. | |||
---- | |||
SEDIMENT_SIZE_CLASS_BEGIN | |||
DIAMETER 0.2 ‘mm’ !Positive is upwards | |||
!All other values left as default | |||
SEDIMENT_SIZE_CLASS_END | |||
SEDIMENT_SIZE_CLASS_BEGIN | |||
DIAMETER 0.3 ‘mm’ !Positive is upwards | |||
FALL_VELOCITY 0.043 ‘m/s’ !measured | |||
CRITICAL_SHEAR 0.25 ‘Pa' | |||
SEDIMENT_SIZE_CLASS_END | |||
SEDIMENT_SIZE_CLASS_BEGIN | |||
NAME "Sand 3" !Optional | |||
DIAMETER 0.4 ‘mm’ !Units option, card required | |||
FALL_VELOCITY_FORMULA SOULSBY !{SOULSBY} | WU_WANG, card optional | |||
CRITICAL_SHEAR_FORMULA SOULSBY !{SOULSBY} | WU_WANG, card optional | |||
SEDIMENT_SIZE_CLASS_END | |||
---- | |||
=Transport Model= | =Transport Model= | ||
Line 129: | Line 225: | ||
Table 2-76 gives a description, default value, and range for the sediment transport models. | Table 2-76 gives a description, default value, and range for the sediment transport models. | ||
{|class="wikitable" | |||
|- | |||
!Card | |||
!Format | |||
!Notes | |||
|- | |||
|Sediment | |||
Transport Model | | |||
[card=SED_TRANS_FORMULATION] | |||
[name=SedModel, type=char, | |||
options=(EXNER,A-D,NET), default=NET] | |||
|Specifies the sediment transport model | |||
|} | |||
Example 2-74. Specifying the sediment transport model. | |||
=Notes | ---- | ||
SEDIMENT_TRANS_FORMULATION NET !EXNER | A-D | NET | |||
---- | |||
=Notes: = | |||
:• When selecting the equilibrium total load model, the <span style="color:#0000FF"> SED_TRAN_FORMULATION </span> card is set to either <span style="color:#0000FF"> WATANABE</span> or <span style="color:#0000FF"> LUND_CIRP </span>depending on the transport formula chosen. When se-lecting the equilibrium A-D model, the transport formula is speci-fied through the concentration profile formula (described below). | :• When selecting the equilibrium total load model, the <span style="color:#0000FF"> SED_TRAN_FORMULATION </span> card is set to either <span style="color:#0000FF"> WATANABE</span> or <span style="color:#0000FF"> LUND_CIRP </span>depending on the transport formula chosen. When se-lecting the equilibrium A-D model, the transport formula is speci-fied through the concentration profile formula (described below). | ||
Line 154: | Line 267: | ||
=Nonequilibrium Total Load= | =Nonequilibrium Total Load= | ||
In this approach, neither the bed nor suspended loads are assumed to be in equilibrium. The suspended- and bed-load transport equations are combined into a single equation and thus there is one less empirical | In this approach, neither the bed nor suspended loads are assumed 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). | ||
=Sediment Transport Formula= | =Sediment Transport Formula= | ||
Line 169: | Line 282: | ||
Table 2-77 gives a description, default value, and range for the sediment transport formulae. | Table 2-77 gives a description, default value, and range for the sediment transport formulae. | ||
{|class="wikitable" | |||
|- | |||
!Card | |||
!Arguments | |||
!Notes | |||
|- | |||
|Sediment | |||
Transport | |||
Formula | |||
|[cards=(TRANSPORT_FORMULA, | |||
NET_TRANSPORT_CAPACITY), | |||
versions=(<4.00.00)]] | |||
[name=TransForm, type=char, | |||
default=none, | |||
options=(LUND-CIRP, | |||
VAN_RIJN,SOULSBY,WATANABE)] | |||
|Selects the transport formula. Note that SOULSBY is only available in v>=4.0 | |||
|- | |||
|Concentration | |||
Profile | |||
|[cards=CONCENTRATION_PROFILE] | |||
[name=ConcPro, type=char, | |||
options=(LUND-CIRP,VAN_RIJN, | |||
EXPONENTIAL,ROUSE), | |||
default=EXPONENTIAL] | |||
|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. | |||
|- | |||
|Watanabe | |||
coefficient | |||
|[cards=A_COEFFICIENT_WATANABE] | |||
[name=SedWatA, type=float, | |||
default=0.1, range=(0.05-<SedWatA<0.5)] | |||
[name= SedTransDtUnits, | |||
type=char, optional=true, | |||
options=TimeUnits), | |||
default=’s’] | |||
|Empirical coefficient which goes into the Watanabe transport formula. | |||
|} | |||
Example 2-75. Specifying the sediment transport formula, concentration profile, and Watanabe coefficient. | |||
---- | |||
TRANSPORT_FORMULATION WATANABE !LUND-CIRP | VAN_RIJN | etc. | |||
CONCENTRATION_PROFILE EXPONENTIAL !ROUSE | EXPONENTIAL | |||
A_WATANABE_COEFFICIENTE 0.2 | |||
---- | |||
=Notes<nowiki>:</nowiki>= | =Notes<nowiki>:</nowiki>= | ||
Line 194: | Line 352: | ||
The bed- and suspended-load transport scaling factors multiply directly by the transport capacity or near-bed sediment concentration calculated from the transport formula. Error! Reference source not found. gives a description, default value, and range for the bed- and suspended-load scaling factors. | The bed- and suspended-load transport scaling factors multiply directly by the transport capacity or near-bed sediment concentration calculated from the transport formula. Error! Reference source not found. gives a description, default value, and range for the bed- and suspended-load scaling factors. | ||
Table 2-78. CMS-Flow card used for specifying the global sediment properties. | |||
{|class="wikitable" | |||
|- | |||
!Input | |||
!Format | |||
!Notes | |||
|- | |||
|Bed Load | |||
Scaling Factor | |||
|[card=BED_LOAD_SCALE_FACTOR] | |||
[name=SedBedScale, type=float, default=1.0, | |||
typical=(0.5>SedBedScale<2.0)] | |||
|Calibration factor for bed load transport capacity formula | |||
|- | |||
|Suspended Load | |||
Scaling Factor | |||
|[card=BED_LOAD_SCALE_FACTOR] | |||
[name=SedSuspScale, type=float, default=1.0, | |||
typical=(0.5>SedSuspScale<2.0)] | |||
|Calibration factor for suspended load transport capacity formula | |||
|} | |||
Example 2-76. Specifying the sediment transport scaling factors. | |||
---- | |||
BED_LOAD_SCALE_FACTOR 0.7 !default = 1.0 | |||
SUSP_LOAD_SCALE_FACTOR 0.8 !default = 1.0 | |||
---- | |||
=Note | =Note:= | ||
:• The transport scaling factors should be one of the first parameters used in calibrating a sediment transport model. The scaling factors can be calibrated using measured sediment transport rates or morphology change. In general, larger scaling factors will produce larger bed change. | :• The transport scaling factors should be one of the first parameters used in calibrating a sediment transport model. The scaling factors can be calibrated using measured sediment transport rates or morphology change. In general, larger scaling factors will produce larger bed change. | ||
Line 210: | Line 396: | ||
The morphologic scaling factor is directly multiplied by the calculated bed change at every time step and is intended as a means of speeding up the computational time. It is only recommended for periodic boundary conditions or conditions that do not change rapidly over time. Table 2-79 gives a description, default value, and range for the morphologic acceleration factor. | The morphologic scaling factor is directly multiplied by the calculated bed change at every time step and is intended as a means of speeding up the computational time. It is only recommended for periodic boundary conditions or conditions that do not change rapidly over time. Table 2-79 gives a description, default value, and range for the morphologic acceleration factor. | ||
Table 2-79. CMS card used to specify the morphology acceleration factor. | |||
{|class="wikitable" | |||
|- | |||
!Input | |||
!Format | |||
!Notes | |||
|- | |||
|Morphologic | |||
Acceleration | |||
Factor | |||
|[card=MORPH_ACCEL_FACTOR] | |||
[name=MorphFac, type=float, default=1.0, | |||
range=(1.0>MorphFac<100)] | |||
|Morphologic acceleration factor. Directly multiplies by calculated bed change. | |||
|} | |||
Example 2-77. Specifying the morphologic acceleration factor. | |||
---- | |||
MORPH_ACCEL_FACTOR 2.0 !default is 1.0 | |||
---- | |||
=Note<nowiki>:</nowiki> = | =Note<nowiki>:</nowiki> = | ||
Line 224: | Line 429: | ||
The sediment mixing coefficient is calculated as the eddy viscosity divided by the Schmidt number. For simplicity the Schmidt number is assumed to be constant and the default value is 1.0. Table 2-80 gives a description, default value, and range for the Schmidt number. | The sediment mixing coefficient is calculated as the eddy viscosity divided by the Schmidt number. For simplicity the Schmidt number is assumed to be constant and the default value is 1.0. Table 2-80 gives a description, default value, and range for the Schmidt number. | ||
Table 2-80. CMS card used to specify the Schmidt number | |||
{|class="wikitable" | |||
|- | |||
!Input | |||
!Format | |||
!Notes | |||
|- | |||
|Schmidt | |||
Number | |||
|[card=SCHMIDT_NUMBER] | |||
[name=Schmidt, type=float, default=1.0, | |||
typical=(0.3>Schmidt<2.0)] | |||
|Controls the sediment mixing strength | |||
|} | |||
The example below demonstrates how the Schmidth number is specified in the CMS-Flow Model Control file. | The example below demonstrates how the Schmidth number is specified in the CMS-Flow Model Control file. | ||
Example 2 78. Specifying the Schmidt number. | |||
---- | |||
SCHMIDT_NUMBER 1.5 !default is 1.0, OPTIONAL | |||
---- | |||
=Note | =Note:= | ||
:• The Schmidt number should NOT be used as a calibration number and should only be changed in sensitivity analysis or model testing. | :• The Schmidt number should NOT be used as a calibration number and should only be changed in sensitivity analysis or model testing. | ||
Line 252: | Line 476: | ||
[[File:fig_2-86.png]] | [[File:fig_2-86.png]] | ||
Figure 2-86. Adaptation section within the Sediment tab of the CMS-Flow Model Control window in SMS 11.1 | Figure 2-86. ''Adaptation'' section within the ''Sediment'' tab of the ''CMS-Flow Model Control'' window in SMS 11.1 | ||
=Constant Length= | =Constant Length= | ||
Line 260: | Line 484: | ||
{{Equation|<math>\alpha_t = Uh/(L_t \omega_s )</math>|2-29}} | {{Equation|<math>\alpha_t = Uh/(L_t \omega_s )</math>|2-29}} | ||
where | where <math>\omega_s</math> is the sediment fall velocity of the transport grain size, for single size sediment transport, or the median grain size, in the case of multiple-sized sediment transport. | ||
=Constant Time= | =Constant Time= | ||
Line 290: | Line 514: | ||
The CMS cards related to the total load adaptation coefficient are de-scribed in the table below. | The CMS cards related to the total load adaptation coefficient are de-scribed in the table below. | ||
Table 2-81. CMS card used to specify the total-load adaptation coefficient. | |||
{|class="wikitable" | |||
|- | |||
!Input | |||
!Format | |||
!Notes | |||
|- | |||
|Total-load | |||
Adaptation | |||
Method | |||
|[cards=ADAPTATION_METHOD_TOTAL, | |||
versions=(<4.00.00)]] | |||
[name=SedAdaptMethTotal, type=char, | |||
default=none, options=(CONSTANT_LENGTH, | |||
CONSTANT_TIME,WGHT_AVG_BED_SUSP_LENGTH, | |||
MAX_BED_SUSP_LENGTH)] | |||
|Specifies the total-load adaptation coefficient method | |||
|- | |||
|Total-load | |||
Adaptation | |||
Length | |||
|[cards=ADAPTATION_LENGTH_TOTAL] | |||
[name=SedAdaptLenTotal, type=real, | |||
default=10.0, | |||
range=(0.05-<SedAdaptLenTotal<0.5)] | |||
[name=SedAdaptLenTotalUnits, type=char, | |||
optional=true, options=DistUnits), | |||
default=’m’, dependencies=(SedAdaptMethTotal= (CONSTANT_LENGTH, | |||
WGHT_AVG_BED_SUSP_LENGTH, | |||
MAX_BED_SUSP_LENGTH))] | |||
|Specifies the total-load adaptation length | |||
|- | |||
|Total-load | |||
Adaptation | |||
Time | |||
|[cards=ADAPTATION_TIME_TOTAL] | |||
[name=SedAdaptLenTotal, type=real, | |||
default=10.0, | |||
range=(0.05-<SedAdaptLenTotal<0.5)] | |||
[name=SedAdaptLenTotalUnits, type=char, | |||
optional=true, options=DistUnits), | |||
default=’s’, dependencies= | |||
(SedAdaptMethTotal=CONSTANT_TIME)] | |||
|Specifies the total-load adaptation time | |||
|} | |||
=Note | |||
=Note:= | |||
:• If the total-load adaptation length is set to -1.0, then the maximum of the bed- and suspended-load adaptation lengths is used. This is the input format used by SMS. | :• If the total-load adaptation length is set to -1.0, then the maximum of the bed- and suspended-load adaptation lengths is used. This is the input format used by SMS. | ||
=Recommendations | =Recommendations:= | ||
:• When first setting up a sediment transport model, it is recom-mended to use a spatially constant total load adaptation length for simplicity. | :• When first setting up a sediment transport model, it is recom-mended to use a spatially constant total load adaptation length for simplicity. | ||
Line 308: | Line 577: | ||
The bed load adaptation parameters only need to be specified if the total-load adaption coefficient is set as a function of the bed load adaptation length. The CMS cards related to the bed load adaptation length are de-scribed in the table below. | The bed load adaptation parameters only need to be specified if the total-load adaption coefficient is set as a function of the bed load adaptation length. The CMS cards related to the bed load adaptation length are de-scribed in the table below. | ||
Table 2-82. CMS card used to specify the bed-load adaptation coefficient. | |||
{|class="wikitable" | |||
|- | |||
!Input | |||
!Format | |||
!Notes | |||
|- | |||
|Bed-load | |||
Adaptation | |||
Method | |||
|[cards=ADAPTATION_METHOD_BED, | |||
versions=(<4.00.00)]] | |||
[name=SedAdaptMethBed, type=char, | |||
default=none, options=(CONSTANT_LENGTH, | |||
CONSTANT_TIME,DEPTH_DEPENDANT), | |||
dependencies=(SedAdaptMethTotal= | |||
(WGHT_AVG_BED_SUSP_LENGTH, | |||
MAX_BED_SUSP_LENGTH)] | |||
|Specifies the bed-load adaptation coefficient method. | |||
|- | |||
|Bed-load | |||
Adaptation | |||
Length | |||
|[cards=ADAPTATION_LENGTH_BED] | |||
[name=SedAdaptLenBed, type=real, | |||
default=10.0] | |||
[name=SedAdaptLenBedUnits, type=char, | |||
optional=true, options=DistUnits), | |||
default=’m’, | |||
dependencies=(SedAdaptMethBed= | |||
CONSTANT_LENGTH)] | |||
|Specifies the bed-load adaptation length. | |||
|- | |||
Bed-load | |||
|Adaptation | |||
Time | |||
|[cards=ADAPTATION_TIME_TOTAL] | |||
[name=SedAdaptTimeBed, type=real, | |||
default=10.0] | |||
[name=SedAdaptTimeBedUnits, type=char, | |||
optional=true, options=DistUnits), | |||
default=’s’, dependencies= | |||
(SedAdaptMethBed=CONSTANT_TIME)]] | |||
|Specifies the bed-load adaptation time | |||
|- | |||
|Bed-load | |||
Adaptation | |||
Length Factor | |||
|[cards=ADAPTATION_DEPTH_FACTOR_BED] | |||
[name=SedAdaptLenFacBed, type=real, | |||
default=10.0] | |||
[name=SedAdaptLenFacBedUnits, type=char, | |||
optional=true, options=DistUnits), | |||
default=’s’, | |||
dependencies=(SedAdaptMethTotal= | |||
(WGHT_AVG_BED_SUSP_LENGTH, | |||
MAX_BED_SUSP_LENGTH)]] | |||
|Specifies the bed-load adaptation length factor which multiplies by the local total water depth. | |||
|} | |||
=Note | =Note:= | ||
:• If the total-load adaptation length is set to a negative number, then the value is interpreted as being the bed-load adaptation length depth factor. The bed-load adaptation length is therefore calculated as the depth times the positive depth factor. | :• If the total-load adaptation length is set to a negative number, then the value is interpreted as being the bed-load adaptation length depth factor. The bed-load adaptation length is therefore calculated as the depth times the positive depth factor. | ||
=Recommendations | =Recommendations:= | ||
:• Based on experience, it is recommended to use a constant bed load length of at least one to three times the grid resolution. | :• Based on experience, it is recommended to use a constant bed load length of at least one to three times the grid resolution. | ||
Line 322: | Line 650: | ||
The suspended load adaptation parameters only need to be specified if the total load adaption coefficient is set as a function of the suspended-load adaptation length. The CMS cards related to the suspended-load adaptation coefficient are described in the table below. | The suspended load adaptation parameters only need to be specified if the total load adaption coefficient is set as a function of the suspended-load adaptation length. The CMS cards related to the suspended-load adaptation coefficient are described in the table below. | ||
Table 2-83. CMS card used to specify the suspended-load adaptation coefficient. | |||
{|class="wikitable" | |||
|- | |||
Input | |||
Format | |||
Notes | |||
|- | |||
|Suspended-load | |||
Adaptation | |||
Method | |||
|[cards=ADAPTATION_METHOD_SUSPENDED, | |||
versions=(<4.00.00)]] | |||
[name=SedAdaptMethSusp, type=char, | |||
default=none, options=(CONSTANT_LENGTH, | |||
CONSTANT_TIME,CONSTANT_ALPHA, | |||
ARMANINI_DISILVIO,LIN,GALLAPPATTI), | |||
dependencies=(SedAdaptMethTotal= | |||
(WGHT_AVG_BED_SUSP_LENGTH, | |||
MAX_BED_SUSP_LENGTH))] | |||
|Specifies the suspended-load adaptation coefficient method. | |||
|- | |||
|Suspended-load | |||
Adaptation | |||
Length | |||
|[cards=ADAPTATION_LENGTH_SUSPENDED] | |||
[name=SedAdaptLenSusp, type=real, default=10.0] | |||
[name=SedAdaptLenSuspUnits, type=char, | |||
optional=true, options=DistUnits), | |||
default=’m’, dependencies=(SedAdaptMethSusp= | |||
CONSTANT_LENGTH)] | |||
|Specifies the suspended-load adaptation length. | |||
|- | |||
|Suspended-load | |||
Adaptation | |||
Time | |||
|[cards=ADAPTATION_TIME_SUSPENDED] | |||
[name=SedAdaptTimeSusp, type=real, default=10.0] | |||
[name=SedAdaptTimeSuspUnits, type=char, | |||
optional=true, options=DistUnits), | |||
default=’s’, dependencies=(SedAdaptMethSusp= | |||
CONSTANT_TIME)]] | |||
|Specifies the suspended-load adaptation time | |||
|- | |||
|Suspended-load | |||
Adaptation | |||
Coefficient | |||
|[cards=ADAPTATION_COEFFICIENT_SUSPENDED] | |||
[name=SedAdaptCoeffSusp, type=real, default=10.0] | |||
[name=SedAdaptCoeffSuspUnits, type=char, | |||
optional=true, options=DistUnits), | |||
default=’s’, dependencies=(SedAdaptMethSusp= | |||
CONSTANT_ALPHA)]] | |||
|Specifies the suspended-load adaptation Coefficient | |||
|} | |||
=Notes | =Notes:= | ||
:• By default, SMS writes the CMS-Flow card <span style="color:#0000FF"> ADAPTATION_COEFF_SUSPENDED </span> . However, this card is outdated and can be confused with the card <span style="color:#0000FF"> ADAPTATION_COEFFICIENT_SUSPENDED</span> (see table above). In-stead, it is recommended for the user to use the <span style="color:#0000FF"> ADAPTATION_METHOD_SUSPENDED </span>to specify the method for the suspended-load adaptation coefficient. | :• By default, SMS writes the CMS-Flow card <span style="color:#0000FF"> ADAPTATION_COEFF_SUSPENDED </span> . However, this card is outdated and can be confused with the card <span style="color:#0000FF"> ADAPTATION_COEFFICIENT_SUSPENDED</span> (see table above). In-stead, it is recommended for the user to use the <span style="color:#0000FF"> ADAPTATION_METHOD_SUSPENDED </span>to specify the method for the suspended-load adaptation coefficient. | ||
Line 332: | Line 714: | ||
The first example shown below demonstrates the simplest method for specifying the total load adaptation length which is with a constant value. It is noted that if the card <span style="color:#0000FF"> ADAPTATION_LENGTH_TOTAL </span>is specified, then the total load adaptation method is automatically set to a constant length. The way this option is specified in the SMS 11.1 interface is shown in Figure 2-86. | The first example shown below demonstrates the simplest method for specifying the total load adaptation length which is with a constant value. It is noted that if the card <span style="color:#0000FF"> ADAPTATION_LENGTH_TOTAL </span>is specified, then the total load adaptation method is automatically set to a constant length. The way this option is specified in the SMS 11.1 interface is shown in Figure 2-86. | ||
Example 2-79. Constant Total-load Adaptation Length. | |||
---- | |||
ADAPTATION_METHOD_TOTAL CONSTANT_LENGTH !optional | |||
ADAPTATION_LENGTH_TOTAL 10.0 ‘m' | |||
---- | |||
The following example uses a more complicated formulation for calculat-ing the total load adaptation method. The total load adaptation length is calculated as the weighted average of the bed and suspended loads. The average weights for the bed and suspended loads are given by the fraction of each load relative to the total load. The bed load adaptation length is calculated as a function of the water depth ''(L<sub>b</sub> = 7h)'' while the suspended load adaptation length is calculated using the formulation of Armanini and di Silvio (1986). The figure below shows how to setup the adaptation parameters in the SMS 11.1 interface for this example. | The following example uses a more complicated formulation for calculat-ing the total load adaptation method. The total load adaptation length is calculated as the weighted average of the bed and suspended loads. The average weights for the bed and suspended loads are given by the fraction of each load relative to the total load. The bed load adaptation length is calculated as a function of the water depth ''(L<sub>b</sub> = 7h)'' while the suspended load adaptation length is calculated using the formulation of Armanini and di Silvio (1986). The figure below shows how to setup the adaptation parameters in the SMS 11.1 interface for this example. |
Latest revision as of 15:15, 8 May 2015
Notes:
- • The size classes are constant for the whole domain.
- • The fraction of each sediment size class in the bed describes the bed composition.
- • Increasing the number of sediment size classes increases the com-putational time because each size class requires its own governing equations.
- • If not size classes are specified, then a single transport grain size is used based on the mean of the median grain size diameter for the surface bed layer
.
Recommendations:
- • It is NOT recommended to use more 8-9 sediment size classes, be-cause of the increased computational time. For most cases, 3-5 sediment size classes are sufficient.
- • A good and simple way of estimating the grain size classed based only on the size limits of the distribution is by distributing the diameters logarithmically:
(2-22) |
where N is the number of sediment size classes, k indicates the sediment size class, and the subscript indicates the size class num-ber. This leads diameters more closely spaced in the finer grain sizes and more loosely spaced in the coarser grain sizes. Since the sediment transport is larger for the finer grain sizes, it makes sense to give more resolution near the finer grain sizes.
- • The size class diameter should be chosen carefully so that encom-pass the whole range of sediment sizes found in the bed.
A Matlab example how to select the sediment size classes based on a median grain size and geometric standard deviation is given in Appendix E.
Fall Velocity
The user may select one of several sediment size class fall velocity formulas to calculate the fall velocity. It is noted that the fall velocity should not be used as a calibration parameter. There are three options for the sediment fall velocity:
- 1. User-specified
- 2. Soulsby (1997)
- 3. Wu and Wang (2006)
The options for the sediment fall velocity can be selected with within the Size Class section within the Sediment tab of the CMS-Flow Model Control window (see figure below).
Figure 2-84. Sediment size class Fall Velocity Method options in the Size Class section within the Sediment tab of the CMS-Flow Model Control window in SMS 11.1.
The cards used to specify the sediment fall velocity are described in the table below.
Table 2-74. CMS-Flow cards used for specifying the sediment size class fall velocity.
Input | Format | Notes |
---|---|---|
Fall Velocity | [card=FALL_VELOCITY, parent=SedClass,
exclusion=wsform] [name=wsfall, type=float, default=none, range=(wsfall>0.0 ’m/s’)] [name=wsfallUnits, type=char, , options=VelUnits default=’m/s’] |
Sediment size class fall velocity. |
Fall Velocity Formula | [card=FALL_VELOCITY_FORMULA, parent=SedClass]
[name=wsform, type=char, options=(SOULSBY,WU_WANG), default=none] |
Sediment size class fall velocity formula. |
Corey
Shape Factor |
[card=COREY_SHAPE_FACTOR, parent=SedClass]
[name=Corey, type=float, default=0.7, range=(0.2<corey<1.0), dependence=(wsform=WU_WANG)] |
Sediment size class Corey Shape Factor. Used in the Wu and Wang (2006) sediment fall velocity formula. |
The Soulsby (1997) formula is given by
(2-23) |
where d* is the dimensionless grain size
(2-24) |
where d50 is the median grain size, s is the sediment specific gravity, g is the gravitational constant, is the kinematic viscosity.
The Wu and Wang (2006) formula includes the effect of the sediment shape through and is given by
(2-25) |
where M = 53.5 exp(-0.65FS) , N = 5.65 exp(-2.5FS) , n = 0.7 + 0.9FS. Here FS is the Corey shape factor defined as in which ds ,dI , and dL are the diameters of the short, intermediate and long mutually perpendicular axes. Naturally worn quartz sands have a typical Corey shape factor of 0.7 and calcareous sand of about 0.55.
Notes:
- • For noncohesive sediments, it is NOT recommended to use the sediment fall velocity, or shape factor as calibration parameters. These parameters should be estimated using field or literature data. If not measurements are available then the default formula should be used.
- • For high sediment concentrations, the sediment fall velocity can be reduced. However, because the effects are important for high concentrations, the effect can usually be ignored.
- • Decreasing the shape factor decreases the sediment fall velocity.
Critical Shear Stress
When using the Lund-CIRP or Watanabe transport formula, the option is given to modify the critical shear stress for incipient motion. In the case of the Soulsby-van Rijn, and van Rijn transport formula, the depth-averaged critical velocities are used and cannot be modified by the user. Therefore this section is only applicable to the Lund-CIRP and Watanabe transport formula. There are three options for the critical shear stress for incipient motion:
- 4. User-Specified
- 5. Soulsby (1997)
- 6. Wu and Wang (1999)
The options for the sediment size class critical shear stress can be selected with within the Size Class section within the Sediment tab of the CMS-Flow Model Control window (see figure below).
Figure 2-85. Sediment size class Critical Shear Method options in the Size Class section within the Sediment tab of the CMS-Flow Model Control window in SMS 11.1.
The cards used to specify the sediment size class critical shear stress are described in the table below.
Table 2-75. CMS-Flow cards used for specifying the critical shear stress.
Input | Format | Notes |
---|---|---|
Critical Shields
Parameter |
[card=SHIELDS_PARAMETER, parent=SedClass]
[name=thetacr, type=float, default=none, range=(thetacr>0.0)] |
Sediment size class characteristic diameter. |
Critical
Shear Stress |
[card=(CRITICAL_SHEAR,CRITICAL_STRESS,
parent=SedClass)] [name=taucr, type=float, default=none, range=(taucr>0.0)] [name=taucrUnits, type=char, options=PresUnits, default=’Pa’] |
Sediment size class characteristic critical shear stress. |
Critical
Shear Stress Formula |
[card=(CRITICAL_SHEAR_FORMULA,
CRITICAL_STRES_FORMULA)]] [name=wsform, type=char, options=(SOULSBY,WU_WANG), default=SOULSBY] |
Sediment size class characteristic critical shear stress formula. |
The critical shear stress, , is related to the Shields parameter, , by
(2-26) |
Soulsby (1997) proposed the following formula for the Shields parameter
(2-27) |
The formula by Wu and Wang (1999) is given by
(2-28) |
Notes:
- • For noncohesive sediments, it is NOT recommended to use the sediment fall velocity, or shape factor as calibration parameters. These parameters should be estimated using field or literature data. If not measurements are available then the default formula should be used.
Examples
In the example below a single sediment size is specified. Since there is only one sediment size class, the bed sorting and gradation is not considered.
Example 2-72. Single-size sediment transport size class specification.
--SEDIMENT_SIZE_CLASS_BEGIN
DIAMETER 0.2 ‘mm’ !Positive is upwards
SEDIMENT_SIZE_CLASS_END --
In the following example three sediment size classes are considered which allows the model to track the bed composition. It is noted that not the same input parameters have to be specified for all sediment size classes. Any parameters which are not specified are set the default value.
Example 2-73. Multiple-sized sediment transport size class specification.
SEDIMENT_SIZE_CLASS_BEGIN
DIAMETER 0.2 ‘mm’ !Positive is upwards !All other values left as default
SEDIMENT_SIZE_CLASS_END SEDIMENT_SIZE_CLASS_BEGIN
DIAMETER 0.3 ‘mm’ !Positive is upwards FALL_VELOCITY 0.043 ‘m/s’ !measured CRITICAL_SHEAR 0.25 ‘Pa'
SEDIMENT_SIZE_CLASS_END SEDIMENT_SIZE_CLASS_BEGIN
NAME "Sand 3" !Optional DIAMETER 0.4 ‘mm’ !Units option, card required FALL_VELOCITY_FORMULA SOULSBY !{SOULSBY} | WU_WANG, card optional CRITICAL_SHEAR_FORMULA SOULSBY !{SOULSBY} | WU_WANG, card optional
SEDIMENT_SIZE_CLASS_END
Transport Model
There are currently three sediment transport models available in CMS: (1) Equilibrium total load, (2) Equilibrium bed load plus advection-diffusion for suspended load, and (3) Non-equilibrium total load. The first two models are selected by unchecking the checkbox which says "Use non-equilibrium transport" and selecting either "Total load" for the first model, or "Advection-diffusion" for the second next to input item named "Formulation". The third model is selected by checking the box "Use non-equilibrium transport".
Table 2-76 gives a description, default value, and range for the sediment transport models.
Card | Format | Notes |
---|---|---|
Sediment
Transport Model | [card=SED_TRANS_FORMULATION] [name=SedModel, type=char, options=(EXNER,A-D,NET), default=NET] |
Specifies the sediment transport model |
Example 2-74. Specifying the sediment transport model.
SEDIMENT_TRANS_FORMULATION NET !EXNER | A-D | NET
Notes:
- • When selecting the equilibrium total load model, the SED_TRAN_FORMULATION card is set to either WATANABE or LUND_CIRP depending on the transport formula chosen. When se-lecting the equilibrium A-D model, the transport formula is speci-fied through the concentration profile formula (described below).
- • All three sediment transport models are available with the explicit solver, while only the NET is available only with the implicit time stepping scheme.
- • Only the Nonequilibrium Total Load model is available in CMS versions 4.0 and greater at the moment. Plans are under way to in-clude the Equilibrium Bed plus Advection-Diffusion Suspended Load model as an option, but the Equilibrium Total Load model will likely be discontinued.
A description of each sediment transport model is described in the sections below.
Equilibrium Total load
In this model, both the bed load and suspended load are assumed to be in equilibrium. The bed change is solved using a simple mass balance equation known as the Exner equation.
Equilibrium Bed load plus Advection-Diffusion Suspended Load
Calculations of suspended load and bed load are conducted separately. 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
In this approach, neither the bed nor suspended loads are assumed 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).
Sediment Transport Formula
The near bed sediment concentration or concentration capacity are calcu-lated with one of the following transport formula:
- • Lund-CIRP (2006)
- • Van Rijn (1998)
- • Watanabe (1987)
- • Soulsby-van Rijn (1997) (>=V4.0)
Table 2-77 gives a description, default value, and range for the sediment transport formulae.
Card | Arguments | Notes |
---|---|---|
Sediment
Transport Formula |
[cards=(TRANSPORT_FORMULA,
NET_TRANSPORT_CAPACITY), versions=(<4.00.00)]] [name=TransForm, type=char, default=none, options=(LUND-CIRP, VAN_RIJN,SOULSBY,WATANABE)] |
Selects the transport formula. Note that SOULSBY is only available in v>=4.0 |
Concentration
Profile |
[cards=CONCENTRATION_PROFILE]
[name=ConcPro, type=char, options=(LUND-CIRP,VAN_RIJN, EXPONENTIAL,ROUSE), default=EXPONENTIAL] |
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. |
Watanabe
coefficient |
[cards=A_COEFFICIENT_WATANABE]
[name=SedWatA, type=float, default=0.1, range=(0.05-<SedWatA<0.5)] [name= SedTransDtUnits, type=char, optional=true, options=TimeUnits), default=’s’] |
Empirical coefficient which goes into the Watanabe transport formula. |
Example 2-75. Specifying the sediment transport formula, concentration profile, and Watanabe coefficient.
TRANSPORT_FORMULATION WATANABE !LUND-CIRP | VAN_RIJN | etc. CONCENTRATION_PROFILE EXPONENTIAL !ROUSE | EXPONENTIAL A_WATANABE_COEFFICIENTE 0.2
Notes:
- • Different transport formula may produce very different results in morphology change.
- • The Lund-CIRP does well in predicting the surf zone sediment transport but tends to overestimate the transport rates near the wetting and drying limit and in deep water (>10 m).
- • The van Rijn transport formula tends to underestimate the trans-port for conditions near the critical shear stress of motion. The for-mula also tends to underestimate the transport close to the shore-line.
- • The Watanabe formula tends to underestimate the transport in deep water (>10 m).
Recommendations:
- • For every sediment transport project, it is recommended to test several sediment transport formula to observe the sensitivity of the results to the sediment transport formula. The sediment transport formula is perhaps the most important parameter of any sediment transport model and the largest source error.
Scaling Factors
Transport Scaling Factors
The bed- and suspended-load transport scaling factors multiply directly by the transport capacity or near-bed sediment concentration calculated from the transport formula. Error! Reference source not found. gives a description, default value, and range for the bed- and suspended-load scaling factors.
Table 2-78. CMS-Flow card used for specifying the global sediment properties.
Input | Format | Notes |
---|---|---|
Bed Load
Scaling Factor |
[card=BED_LOAD_SCALE_FACTOR]
[name=SedBedScale, type=float, default=1.0, typical=(0.5>SedBedScale<2.0)] |
Calibration factor for bed load transport capacity formula |
Suspended Load
Scaling Factor |
[card=BED_LOAD_SCALE_FACTOR]
[name=SedSuspScale, type=float, default=1.0, typical=(0.5>SedSuspScale<2.0)] |
Calibration factor for suspended load transport capacity formula |
Example 2-76. Specifying the sediment transport scaling factors.
BED_LOAD_SCALE_FACTOR 0.7 !default = 1.0 SUSP_LOAD_SCALE_FACTOR 0.8 !default = 1.0
Note:
- • The transport scaling factors should be one of the first parameters used in calibrating a sediment transport model. The scaling factors can be calibrated using measured sediment transport rates or morphology change. In general, larger scaling factors will produce larger bed change.
- • Due to the large uncertainty in the transport formula, it is generally common to use scaling factors in the range of 0.5-2.0. However values between 0.2 and 5.0 are not unreasonable given the uncertainty in the equilibrium sediment transport formula.
- • For simplicity, the same transport scaling factors are applied for the whole solution domain and for all sediment sizes.
Morphologic Acceleration Factor
The morphologic scaling factor is directly multiplied by the calculated bed change at every time step and is intended as a means of speeding up the computational time. It is only recommended for periodic boundary conditions or conditions that do not change rapidly over time. Table 2-79 gives a description, default value, and range for the morphologic acceleration factor.
Table 2-79. CMS card used to specify the morphology acceleration factor.
Input | Format | Notes |
---|---|---|
Morphologic
Acceleration Factor |
[card=MORPH_ACCEL_FACTOR]
[name=MorphFac, type=float, default=1.0, range=(1.0>MorphFac<100)] |
Morphologic acceleration factor. Directly multiplies by calculated bed change. |
Example 2-77. Specifying the morphologic acceleration factor.
MORPH_ACCEL_FACTOR 2.0 !default is 1.0
Note:
- • The morphologic scaling factor is NOT a calibration parameter. It should only be used in cases with periodic forcing and boundary conditions and even then it should be used with caution. It is NOT recommended to use larger values than 20-30.
- • The acceleration factor may be used to turn off the morphology change by setting it to zero.
Schmidt Number
The sediment mixing coefficient is calculated as the eddy viscosity divided by the Schmidt number. For simplicity the Schmidt number is assumed to be constant and the default value is 1.0. Table 2-80 gives a description, default value, and range for the Schmidt number.
Table 2-80. CMS card used to specify the Schmidt number
Input | Format | Notes |
---|---|---|
Schmidt
Number |
[card=SCHMIDT_NUMBER]
[name=Schmidt, type=float, default=1.0, typical=(0.3>Schmidt<2.0)] |
Controls the sediment mixing strength |
The example below demonstrates how the Schmidth number is specified in the CMS-Flow Model Control file.
Example 2 78. Specifying the Schmidt number.
SCHMIDT_NUMBER 1.5 !default is 1.0, OPTIONAL
Note:
- • The Schmidt number should NOT be used as a calibration number and should only be changed in sensitivity analysis or model testing.
Adaptation Coefficient
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. For example, if a high resolution grid is used to model short-term dynamics of a nearshore disposal site or a small inlet, then the adaptation coefficient is likely to be important. However, if a relatively coarse grid is used to study sediment pathways in a large estuary entrance, then the adaptation coefficient will not be important.
Total Load
There are four methods for calculating the total load adaptation coefficient in CMS:
- 1. Constant length
- 2. Constant time
- 3. Maximum of bed and suspended load lengths
- 4. Weighted average of bed and suspended load lengths
Figure 2-86. Adaptation section within the Sediment tab of the CMS-Flow Model Control window in SMS 11.1
Constant Length
A temporally and spatially total load adaptation length is used for the whole domain. The total load adaptation coefficient is calculated as
(2-29) |
where is the sediment fall velocity of the transport grain size, for single size sediment transport, or the median grain size, in the case of multiple-sized sediment transport.
Constant Time
A temporally and spatially constant total-load adaptation time is used for the whole domain. The total load adaptation coefficient is calculated as
(2-30) |
where is the sediment fall velocity of the transport grain size for single size sediment transport, or the median grain size, in the case of multiple-sized sediment transport.
Maximum of Bed and Suspended Load Lengths
A temporally and spatially constant total-load adaptation time is used for
( 2-31) |
where ls is the suspended load adaptation length and Lb is the bed load adaptation length. The methods for determining Lb and Ls are described in subsequent sections.
Weighted Average of Bed and Suspended Load Lengths
A temporally and spatially constant total-load adaptation time is used
(2-32) |
where Ls is the suspended load adaptation length, Lb is the bed load adaptation length, and rs is the fraction of suspended load of the total load.
The methods for determining Lb and Ls are described in subsequent sections.
The CMS cards related to the total load adaptation coefficient are de-scribed in the table below.
Table 2-81. CMS card used to specify the total-load adaptation coefficient.
Input | Format | Notes |
---|---|---|
Total-load
Adaptation Method |
[cards=ADAPTATION_METHOD_TOTAL,
versions=(<4.00.00)]] [name=SedAdaptMethTotal, type=char, default=none, options=(CONSTANT_LENGTH, CONSTANT_TIME,WGHT_AVG_BED_SUSP_LENGTH, MAX_BED_SUSP_LENGTH)] |
Specifies the total-load adaptation coefficient method |
Total-load
Adaptation Length |
[cards=ADAPTATION_LENGTH_TOTAL]
[name=SedAdaptLenTotal, type=real, default=10.0, range=(0.05-<SedAdaptLenTotal<0.5)] [name=SedAdaptLenTotalUnits, type=char, optional=true, options=DistUnits), default=’m’, dependencies=(SedAdaptMethTotal= (CONSTANT_LENGTH, WGHT_AVG_BED_SUSP_LENGTH, MAX_BED_SUSP_LENGTH))] |
Specifies the total-load adaptation length |
Total-load
Adaptation Time |
[cards=ADAPTATION_TIME_TOTAL]
[name=SedAdaptLenTotal, type=real, default=10.0, range=(0.05-<SedAdaptLenTotal<0.5)] [name=SedAdaptLenTotalUnits, type=char, optional=true, options=DistUnits), default=’s’, dependencies= (SedAdaptMethTotal=CONSTANT_TIME)] |
Specifies the total-load adaptation time |
Note:
- • If the total-load adaptation length is set to -1.0, then the maximum of the bed- and suspended-load adaptation lengths is used. This is the input format used by SMS.
Recommendations:
- • When first setting up a sediment transport model, it is recom-mended to use a spatially constant total load adaptation length for simplicity.
- • If the user is not sure of the sensitivity of the results to the adapta-tion length for the specific project, then it is recommended to test different total load adaptation lengths; for example 5, 10, and 50 meters. This will provide an insight into the sensitivity of the results to the adaptation length. In many cases, the results are not found to be sensitive and the default value of 10 m can be used. If the results are found to be more tests are necessary in determining to optimal method and parameters for calculating the adaptation length.
- • WGHT_AVG_BED_SUSP_LENGTH is the most physically accurate method for determining the total load adaptation length. However, it can lead to relatively small adaptation lengths which cause insta-bilities, especially for large computational time steps. If this occurs then it is recommended to use M AX_BED_SUSP_LENGTH.
Bed Load
The bed load adaptation parameters only need to be specified if the total-load adaption coefficient is set as a function of the bed load adaptation length. The CMS cards related to the bed load adaptation length are de-scribed in the table below.
Table 2-82. CMS card used to specify the bed-load adaptation coefficient.
Bed-loadInput | Format | Notes |
---|---|---|
Bed-load
Adaptation Method |
[cards=ADAPTATION_METHOD_BED,
versions=(<4.00.00)]] [name=SedAdaptMethBed, type=char, default=none, options=(CONSTANT_LENGTH, CONSTANT_TIME,DEPTH_DEPENDANT), dependencies=(SedAdaptMethTotal= (WGHT_AVG_BED_SUSP_LENGTH, MAX_BED_SUSP_LENGTH)] |
Specifies the bed-load adaptation coefficient method. |
Bed-load
Adaptation Length |
[cards=ADAPTATION_LENGTH_BED]
[name=SedAdaptLenBed, type=real, default=10.0] [name=SedAdaptLenBedUnits, type=char, optional=true, options=DistUnits), default=’m’, dependencies=(SedAdaptMethBed= CONSTANT_LENGTH)] |
Specifies the bed-load adaptation length. |
Adaptation
Time |
[cards=ADAPTATION_TIME_TOTAL]
[name=SedAdaptTimeBed, type=real, default=10.0] [name=SedAdaptTimeBedUnits, type=char, optional=true, options=DistUnits), default=’s’, dependencies= (SedAdaptMethBed=CONSTANT_TIME)]] |
Specifies the bed-load adaptation time |
Bed-load
Adaptation Length Factor |
[cards=ADAPTATION_DEPTH_FACTOR_BED]
[name=SedAdaptLenFacBed, type=real, default=10.0] [name=SedAdaptLenFacBedUnits, type=char, optional=true, options=DistUnits), default=’s’, dependencies=(SedAdaptMethTotal= (WGHT_AVG_BED_SUSP_LENGTH, MAX_BED_SUSP_LENGTH)]] |
Specifies the bed-load adaptation length factor which multiplies by the local total water depth. |
Note:
- • If the total-load adaptation length is set to a negative number, then the value is interpreted as being the bed-load adaptation length depth factor. The bed-load adaptation length is therefore calculated as the depth times the positive depth factor.
Recommendations:
- • Based on experience, it is recommended to use a constant bed load length of at least one to three times the grid resolution.
Suspended Load
The suspended load adaptation parameters only need to be specified if the total load adaption coefficient is set as a function of the suspended-load adaptation length. The CMS cards related to the suspended-load adaptation coefficient are described in the table below.
Table 2-83. CMS card used to specify the suspended-load adaptation coefficient.
Input Format NotesSuspended-load
Adaptation Method |
[cards=ADAPTATION_METHOD_SUSPENDED,
versions=(<4.00.00)]] [name=SedAdaptMethSusp, type=char, default=none, options=(CONSTANT_LENGTH, CONSTANT_TIME,CONSTANT_ALPHA, ARMANINI_DISILVIO,LIN,GALLAPPATTI), dependencies=(SedAdaptMethTotal= (WGHT_AVG_BED_SUSP_LENGTH, MAX_BED_SUSP_LENGTH))] |
Specifies the suspended-load adaptation coefficient method. |
Suspended-load
Adaptation Length |
[cards=ADAPTATION_LENGTH_SUSPENDED]
[name=SedAdaptLenSusp, type=real, default=10.0] [name=SedAdaptLenSuspUnits, type=char, optional=true, options=DistUnits), default=’m’, dependencies=(SedAdaptMethSusp= CONSTANT_LENGTH)] |
Specifies the suspended-load adaptation length. |
Suspended-load
Adaptation Time |
[cards=ADAPTATION_TIME_SUSPENDED]
[name=SedAdaptTimeSusp, type=real, default=10.0] [name=SedAdaptTimeSuspUnits, type=char, optional=true, options=DistUnits), default=’s’, dependencies=(SedAdaptMethSusp= CONSTANT_TIME)]] |
Specifies the suspended-load adaptation time |
Suspended-load
Adaptation Coefficient |
[cards=ADAPTATION_COEFFICIENT_SUSPENDED]
[name=SedAdaptCoeffSusp, type=real, default=10.0] [name=SedAdaptCoeffSuspUnits, type=char, optional=true, options=DistUnits), default=’s’, dependencies=(SedAdaptMethSusp= CONSTANT_ALPHA)]] |
Specifies the suspended-load adaptation Coefficient |
Notes:
- • By default, SMS writes the CMS-Flow card ADAPTATION_COEFF_SUSPENDED . However, this card is outdated and can be confused with the card ADAPTATION_COEFFICIENT_SUSPENDED (see table above). In-stead, it is recommended for the user to use the ADAPTATION_METHOD_SUSPENDED to specify the method for the suspended-load adaptation coefficient.
Examples
The first example shown below demonstrates the simplest method for specifying the total load adaptation length which is with a constant value. It is noted that if the card ADAPTATION_LENGTH_TOTAL is specified, then the total load adaptation method is automatically set to a constant length. The way this option is specified in the SMS 11.1 interface is shown in Figure 2-86.
Example 2-79. Constant Total-load Adaptation Length.
ADAPTATION_METHOD_TOTAL CONSTANT_LENGTH !optional ADAPTATION_LENGTH_TOTAL 10.0 ‘m'
The following example uses a more complicated formulation for calculat-ing the total load adaptation method. The total load adaptation length is calculated as the weighted average of the bed and suspended loads. The average weights for the bed and suspended loads are given by the fraction of each load relative to the total load. The bed load adaptation length is calculated as a function of the water depth (Lb = 7h) while the suspended load adaptation length is calculated using the formulation of Armanini and di Silvio (1986). The figure below shows how to setup the adaptation parameters in the SMS 11.1 interface for this example.