Model help:RouseVanoniEquilibrium: Difference between revisions

From CSDMS
No edit summary
m Text replacement - "http://csdms.colorado.edu/wiki/" to "https://csdms.colorado.edu/wiki/"
 
(7 intermediate revisions by 2 users not shown)
Line 3: Line 3:
1) Log in to the wiki
1) Log in to the wiki
2) Create a new page for each model, by using the following URL:
2) Create a new page for each model, by using the following URL:
   * http://csdms.colorado.edu/wiki/Model help:<modelname>
   * https://csdms.colorado.edu/wiki/Model help:<modelname>
   * Replace <modelname> with the name of a model
   * Replace <modelname> with the name of a model
3) Than follow the link "edit this page"
3) Than follow the link "edit this page"
Line 19: Line 19:


==Model parameters==
==Model parameters==
= First tab header =
= Input Files and Directories =
{|{{Prettytable}} class = "wikitable unsortable"  cellspacing="0" cellpadding="0" style="margin:0em 0em 0em 0;"
{|{{Prettytable}} class = "wikitable unsortable"  cellspacing="0" cellpadding="0" style="margin:0em 0em 0em 0;"
|-
|-
!Parameter!!Description!!Unit
!Parameter!!Description!!Unit
|-valign="top"
|-valign="top"
|width="20%"|<span class="remove_this_tag">First parameter</span>
|width="20%"|Input directory
|width="60%"|<span class="remove_this_tag">Description parameter</span>
|width="60%"|path to input files
|width="20%"|<span class="remove_this_tag">[Units]</span>
|width="20%"|
|-
|Site prefix
|Site prefix for Input/Output files
|
|-
|Case prefix
|Case prefix for Input/Output files
|
|-
|}
|}


= Second tab header =
= Run Parameters =
{|{{Prettytable}} class = "wikitable unsortable"  cellspacing="0"  cellpadding="0" style="margin:0em 0em 0em 0;"
{|{{Prettytable}} class = "wikitable unsortable"  cellspacing="0"  cellpadding="0" style="margin:0em 0em 0em 0;"
|-
|-
!Parameter!!Description!!Unit
!Parameter!!Description!!Unit
|-valign="top"
|-valign="top"
|width="20%"|<span class="remove_this_tag">First parameter</span>
|width="20%"|non-dimensional distance from the bed
|width="60%"|<span class="remove_this_tag">Description parameter</span>
|width="60%"|non-dimensional height in the water column
|width="20%"|<span class="remove_this_tag">[Units]</span>
|width="20%"| -
|-
|vs settling velocity
|settling velocity of the particles
| cm / s
|-
|u<sup>*</sup> shear velocity
|
| m / s
|-
|}
|}


= Etc. tab header =
= About =
{|{{Prettytable}} class = "wikitable unsortable"  cellspacing="0"  cellpadding="0" style="margin:0em 0em 0em 0;"
|-
!Parameter!!Description!!Unit
|-valign="top"
|width="20%"|Model name
|width="60%"|name of the model
|width="20%"| -
|-
|Author name
|name of the model author
| -
|-
|}
<headertabs/>
<headertabs/>
</div>


==Uses ports==
==Uses ports==
Line 50: Line 80:


==Main equations==
==Main equations==
* Non-dimensional expression of the Rouse-Vanoni profile
::::{|
::::{|
|width=500px|<math>{\frac{c}{c_{b}}} = \left ( {\frac{\left ( 1 - \sigma \right ) / \sigma}{\left ( 1 - \sigma \right ) / \sigma _{b} }}\right ) ^ {\frac{V_{s}}{\kappa u_{*}}}  </math>
|width=500px|<math>{\frac{c}{c_{b}}} = \left ( {\frac{\left ( 1 - \zeta \right ) / \zeta}{\left ( 1 - \zeta \right ) / \zeta _{b} }}\right ) ^ {\frac{V_{s}}{\kappa u_{*}}}  </math>
|width=50px align="right"|(1)
|width=50px align="right"|(1)
|}
|}
* Vertical coordinate in the cross section
::::{|
::::{|
|width=500px|<math>\sigma = {\frac{z}{H}} </math>
|width=500px|<math>\zeta = {\frac{z}{H}} </math>
|width=50px align="right"|(2)
|width=50px align="right"|(2)
|}
|}
* Position near the bed surface where the volume concentration of suspended sediment is equals to c<sub>b</sub>
::::{|
::::{|
|width=500px|<math>\sigma _{b} = {\frac{b}{H}} </math>
|width=500px|<math>\zeta _{b} = {\frac{b}{H}} </math>
|width=50px align="right"|(3)
|width=50px align="right"|(3)
|}
|}
* Concentration of suspended sediment in the water column at ζ=ζ<sub>b</sub> averaged over turbulence
::::{|
::::{|
|width=500px|<math>\bar{c_{b} } = E </math>
|width=500px|<math>c_{b} = E </math>
|width=50px align="right"|(4)
|width=50px align="right"|(4)
|}
|}
Line 75: Line 109:
| H
| H
| water depth
| water depth
| -
| L
|-
|-
| ζ
| ζ
| vertical coordinate in the cross section, ζ = 0 on the bed surface and ζ = H on the water surface
| vertical coordinate in the cross section, ζ = 0 on the bed surface and ζ = H on the water surface
| -
| L
|-
|-
| ζ<sub>b</sub>
| ζ<sub>b</sub>
| position near the bed surface where the volumetric concentration of suspended sediment is equal to C<sub>b</sub>
| position near the bed surface where the volumetric concentration of suspended sediment is equal to C<sub>b</sub>
| -
| L
|-
|-
| u<sup>*</sup>
| u<sup>*</sup>
| shear velocity
| shear velocity
| -
| L / T
|-
|-
| v<sub>s</sub>
| v<sub>s</sub>
| particle settling velocity computed with the formulation presented by Dietrich (1982)
| particle settling velocity computed with the formulation presented by Dietrich (1982)
| -
| L / T
|-
|-
| c
| c
| concentration of suspended sediment in the water column at elevation ζ averaged over turbulence.
| concentration of suspended sediment in the water column at elevation ζ averaged over turbulence.
| -
| M / L<sup>3</sup>
|-
|-
| k
| κ
| the constant of VonKarman, set equal to 0.4
| the constant of Von Karman, set equal to 0.4
| -
| -
|-
|-
Line 109: Line 143:
| -
| -
|-
|-
| E
| dimensionless rate of entrainment of bed sediment into suspension, equals to E<sub>s</sub> / v<sub>s</sub>
| -
|-
| E<sub>s</sub>
| volume rate of entrainment of bed sediment into suspension per unit bed area per unit time
| -
|-
|}
|}


Line 117: Line 159:
| z
| z
| non-dimensional vertical coordinate, defined as ζ / H
| non-dimensional vertical coordinate, defined as ζ / H
| -
|-
| c/c<sub>b</sub>
| volumetric concentration averaged over the turbulence
| -
| -
|-
|-
|}
|}
   </div>
   </div>
</div>
</div>
==Notes==
==Notes==
To compute the equilibrium profile the user can choose between:
To compute the equilibrium profile the user can choose between:
Line 136: Line 181:


<span class="remove_this_tag">Follow the next steps to include images / movies of simulations:</span>
<span class="remove_this_tag">Follow the next steps to include images / movies of simulations:</span>
* <span class="remove_this_tag">Upload file: http://csdms.colorado.edu/wiki/Special:Upload</span>
* <span class="remove_this_tag">Upload file: https://csdms.colorado.edu/wiki/Special:Upload</span>
* <span class="remove_this_tag">Create link to the file on your page: <nowiki>[[Image:<file name>]]</nowiki>.</span>
* <span class="remove_this_tag">Create link to the file on your page: <nowiki>[[Image:<file name>]]</nowiki>.</span>


Line 148: Line 193:


==Links==
==Links==
[[http://csdms.colorado.edu/wiki/Model:RouseVanoniEquilibrium Model:RouseVanoniEquilibrium]]
[[Model:RouseVanoniEquilibrium]]


[[Category:Utility components]]
[[Category:Utility components]]

Latest revision as of 17:18, 19 February 2018

The CSDMS Help System
The CSDMS Help System

RouseVanoniEquilibrium

This Program is used to calculate the Rouse-Vanoni profile of suspended sediment.

Model introduction

This model is working as a profile calculator for Rouse-Vanoni Equilibrium Suspended Sediment.

Model parameters

Parameter Description Unit
Input directory path to input files
Site prefix Site prefix for Input/Output files
Case prefix Case prefix for Input/Output files
Parameter Description Unit
non-dimensional distance from the bed non-dimensional height in the water column -
vs settling velocity settling velocity of the particles cm / s
u* shear velocity m / s
Parameter Description Unit
Model name name of the model -
Author name name of the model author -

Uses ports

This will be something that the CSDMS facility will add

Provides ports

This will be something that the CSDMS facility will add

Main equations

  • Non-dimensional expression of the Rouse-Vanoni profile
<math>{\frac{c}{c_{b}}} = \left ( {\frac{\left ( 1 - \zeta \right ) / \zeta}{\left ( 1 - \zeta \right ) / \zeta _{b} }}\right ) ^ {\frac{V_{s}}{\kappa u_{*}}} </math> (1)
  • Vertical coordinate in the cross section
<math>\zeta = {\frac{z}{H}} </math> (2)
  • Position near the bed surface where the volume concentration of suspended sediment is equals to cb
<math>\zeta _{b} = {\frac{b}{H}} </math> (3)
  • Concentration of suspended sediment in the water column at ζ=ζb averaged over turbulence
<math>c_{b} = E </math> (4)

Notes

To compute the equilibrium profile the user can choose between:

a) the grid of the excel workbook RTe-bookRouseSpreadsheetFun.xls. This grid has 22 points in the vertical direction. The lowest 19 are equally spaced between z = b and z = b + 18(1-b)/19. The upper three points are located at z = 0.98, z = 0.995 and z = 1, where the concentration of suspended sediment goes to zero.

b) an equally spaced grid with a user specified number of points in the vertical.


Examples

An example run with input parameters, BLD files, as well as a figure / movie of the output

Follow the next steps to include images / movies of simulations:

See also: Help:Images or Help:Movies

Developer(s)

Gary Parker

References

Dietrich, E. W., 1982, Settling velocity of natural particles, Water Resources Research, 18 (6), 1626-1982.

Links

Model:RouseVanoniEquilibrium