Model help:FallVelocity: Difference between revisions
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: | ||
* | * 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 20: | Line 20: | ||
==Model parameters== | ==Model parameters== | ||
= | = 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%"| | |width="20%"|Input directory | ||
|width="60%"| | |width="60%"|path to input files | ||
|width="20%"| | |width="20%"| | ||
|- | |||
|Site prefix | |||
|Site prefix for Input/Output files | |||
| | |||
|- | |||
|Case prefix | |||
|Case prefix for Input/Output files | |||
| | |||
|- | |||
|} | |} | ||
= | = 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%"| | |width="20%"|kinematic viscosity of water (ν) | ||
|width="60%"| | |width="60%"| | ||
|width="20%"|< | |width="20%"| m<sup>2</sup> / s | ||
|- | |||
|Submerged specific gravity of sediment (R) | |||
| | |||
| - | |||
|- | |||
|Grain size (D) | |||
| | |||
| mm | |||
|- | |||
|Acceleration due to gravity (g) | |||
| | |||
| - | |||
|- | |||
|} | |} | ||
= | = 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/> | ||
==Uses ports== | ==Uses ports== | ||
Line 51: | Line 85: | ||
==Main equations== | ==Main equations== | ||
* Explicit particle Reynolds number | |||
::::{| | ::::{| | ||
|width=800px|<math>Re_{p} = {\frac{\sqrt { R g D } D}{\nu}} </math> | |width=800px|<math>Re_{p} = {\frac{\sqrt { R g D } D}{\nu}} </math> | ||
|width=50px align="right"|(1) | |width=50px align="right"|(1) | ||
|} | |} | ||
* Dimensionless fall velocity | |||
::::{| | ::::{| | ||
|width=800px|<math>R_{f} = {\ | |width=800px|<math>R_{f} = exp \left ( -b_{1} + b_{2} ln \left ( Re_{p} \right ) - b_{3} \left ( ln \left ( Re_{p} \right ) \right ) ^2 - b_{4} \left ( ln \left ( Re_{p} \right ) \right ) ^3 + b_{5} \left ( ln \left ( Re_{p} \right ) \right ) ^4 \right ) </math> | ||
|width=50px align="right"|(2) | |width=50px align="right"|(2) | ||
|} | |} | ||
* fall velocity | |||
::::{| | ::::{| | ||
|width=800px|<math>R_{f} = | |width=800px|<math>R_{f} = {\frac{v_{s}}{\sqrt { R g D }}} </math> | ||
|width=50px align="right"|(3) | |width=50px align="right"|(3) | ||
|} | |} | ||
Line 72: | Line 109: | ||
| g | | g | ||
| gravitational acceleration | | gravitational acceleration | ||
| | | L / T<sup>2</sup> | ||
|- | |- | ||
| ν | | ν | ||
| kinematic viscosity of water | | kinematic viscosity of water | ||
| | | L<sup>2</sup> / T | ||
|- | |- | ||
| R | | R | ||
Line 84: | Line 121: | ||
| D | | D | ||
| grain size | | grain size | ||
| | | L | ||
|- | |- | ||
| ρ<sub>s</sub> | | ρ<sub>s</sub> | ||
| sediment density | | sediment density | ||
| | | M / L<sup>3</sup> | ||
|- | |- | ||
| ρ | | ρ | ||
| water density | | water density | ||
| | | M / L<sup>3</sup> | ||
|- | |- | ||
|} | |} | ||
Line 100: | Line 137: | ||
!Symbol!!Description!!Unit | !Symbol!!Description!!Unit | ||
|- | |- | ||
| | | v<sub>s</sub> | ||
| fall velocity | | fall velocity | ||
| | | L / T | ||
|- | |- | ||
| Re<sub>p</sub> | | Re<sub>p</sub> | ||
Line 117: | Line 154: | ||
==Notes== | ==Notes== | ||
b<sub>1</sub>, b<sub>2</sub>, b<sub>3</sub>, b<sub>4</sub>, b<sub>5</sub> are all parameters from Dietrich(1982). | |||
This formulation is only valid for Reynold’s numbers less than or equal to 2.5·10<sup>6</sup>. If Re<sub>p</sub> is greater than this upper limit, the function will alert the user, and exit the program. | |||
==Examples== | ==Examples== | ||
Line 124: | Line 162: | ||
<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: | * <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 136: | Line 174: | ||
==Links== | ==Links== | ||
*[[ | *[[Model:FallVelocity]] | ||
[[Category:Utility components]] | [[Category:Utility components]] |
Latest revision as of 17:16, 19 February 2018

FallVelocity
This model is used to calculate Particle fall velocity.
Model introduction
This model calculate fall velocity for spheres. Uses formulation of Dietrich (1982).
Model parameters
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
- Explicit particle Reynolds number
<math>Re_{p} = {\frac{\sqrt { R g D } D}{\nu}} </math> (1)
- Dimensionless fall velocity
<math>R_{f} = exp \left ( -b_{1} + b_{2} ln \left ( Re_{p} \right ) - b_{3} \left ( ln \left ( Re_{p} \right ) \right ) ^2 - b_{4} \left ( ln \left ( Re_{p} \right ) \right ) ^3 + b_{5} \left ( ln \left ( Re_{p} \right ) \right ) ^4 \right ) </math> (2)
- fall velocity
<math>R_{f} = {\frac{v_{s}}{\sqrt { R g D }}} </math> (3)
Symbol | Description | Unit |
---|---|---|
g | gravitational acceleration | L / T2 |
ν | kinematic viscosity of water | L2 / T |
R | submerged specific gravity of sediment, defined as (ρs -ρ) /ρ | - |
D | grain size | L |
ρs | sediment density | M / L3 |
ρ | water density | M / L3 |
Output
Symbol | Description | Unit |
---|---|---|
vs | fall velocity | L / T |
Rep | explicit particle Reynolds no. | - |
Rf | dimensionless fall velocity | - |
Notes
b1, b2, b3, b4, b5 are all parameters from Dietrich(1982).
This formulation is only valid for Reynold’s numbers less than or equal to 2.5·106. If Rep is greater than this upper limit, the function will alert the user, and exit the program.
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:
- Upload file: https://csdms.colorado.edu/wiki/Special:Upload
- Create link to the file on your page: [[Image:<file name>]].
See also: Help:Images or Help:Movies
Developer(s)
References
Dietrich, E. W., 1982, Settling velocity of natural particles, Water Resources Research, 18 (6), 1626-1982.