Model help:WPHydResAMBL: 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 23: | Line 23: | ||
<div id=CMT_MODEL_PARAMETERS> | <div id=CMT_MODEL_PARAMETERS> | ||
==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%"|Bed slope | ||
|width="60%"| | |width="60%"| | ||
|width="20%"| | |width="20%"| - | ||
|- | |||
|Submerged specific gravity of sediment | |||
| | |||
| - | |||
|- | |||
|Median sediment size (D50) | |||
| | |||
| mm | |||
|- | |||
|90% passing sediment size (D90) | |||
| grain diameter such that 90% of the distribution is finer | |||
| mm | |||
|- | |||
|factor such that ks = n * D90 | |||
| | |||
| - | |||
|- | |||
|low end value of Hs | |||
| low end value of water depth due to skin friction | |||
| m | |||
|- | |||
|step size for Hs | |||
| step size for water depth due to skin friction | |||
| m | |||
|- | |||
|number of steps to make for Hs | |||
| | |||
| - | |||
|- | |||
|} | |} | ||
= | = 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 100: | Line 150: | ||
{| {{Prettytable}} class="wikitable sortable" | {| {{Prettytable}} class="wikitable sortable" | ||
!Symbol!!Description!!Unit | !Symbol!!Description!!Unit | ||
|- | |||
| τ<sup>*</sup> | |||
| actual shields stress | |||
| - | |||
|- | |||
| τ<sub>s</sub><sup>*</sup> | |||
|Shields stress due to skin friction | |||
| - | |||
|- | |- | ||
| S | | S | ||
Line 107: | Line 165: | ||
| D<sub>50</sub> | | D<sub>50</sub> | ||
| median sediment size | | median sediment size | ||
| | | L | ||
|- | |- | ||
| D<sub>90</sub> | | D<sub>90</sub> | ||
| size such that 90% of the sediment is finer | | size such that 90% of the sediment is finer | ||
| | | L | ||
|- | |||
| D<sub>s90</sub> | |||
| size such that 90% of the sediment is finer in surface layer | |||
| L | |||
|- | |- | ||
| n<sub>k</sub> | | n<sub>k</sub> | ||
| factor such that k<sub>s</sub> = n<sub>k</sub> D<sub>s90</sub> | | factor such that k<sub>s</sub> = n<sub>k</sub> D<sub>s90</sub> | ||
| | | L | ||
|- | |- | ||
| R | | R | ||
| submerged specific gravity of sediment | | submerged specific gravity of sediment | ||
| - | | - | ||
|- | |- | ||
| H | | H | ||
| low end value of water depth due to skin friction | | low end value of water depth due to skin friction | ||
| | | L | ||
|- | |- | ||
| s | | s | ||
| step size for water depth due to skin friction | | step size for water depth due to skin friction | ||
| | | - | ||
|- | |- | ||
| N | | N | ||
Line 137: | Line 195: | ||
| - | | - | ||
|- | |- | ||
| | | α<sub>strat</sub> | ||
| factor for stratification (if not included it will be assumed 1) | | factor for stratification (if not included it will be assumed 1) | ||
| - | | - | ||
Line 143: | Line 201: | ||
| H<sub>s</sub> | | H<sub>s</sub> | ||
| water depth due to the skin friction | | water depth due to the skin friction | ||
| | | L | ||
|- | |- | ||
| τ<sub>sg</sub> | | τ<sub>sg</sub> | ||
| shields stress due to skin friction | | shields stress due to skin friction | ||
| | | - | ||
|- | |- | ||
| U | | U | ||
| flow velocity | | flow velocity | ||
| | | L / T | ||
|- | |- | ||
| q<sub>w</sub> | | q<sub>w</sub> | ||
| flow rate | | flow rate | ||
| | | L<sup>2</sup> / T | ||
|- | |- | ||
| Fr | | Fr | ||
Line 169: | Line 219: | ||
| - | | - | ||
|- | |- | ||
| u< | | u<sub>*</sub> | ||
| shear velocity | | shear velocity | ||
| | | L / T | ||
|- | |- | ||
| u< | | u<sub>*s</sub> | ||
| shear velocity due to skin friction | | shear velocity due to skin friction | ||
| | | L / T | ||
|- | |- | ||
| q<sub>b</sub> | | q<sub>b</sub> | ||
| bedload transport rate | | bedload transport rate | ||
| | | L<sup>2</sup> / T | ||
|- | |||
| g | |||
| acceleration due to gravity | |||
| L / T<sup>2</sup> | |||
|- | |||
| k<sub>s</sub> | |||
| grain roughness height associated with skin friction | |||
| | |||
|- | |||
| Γ | |||
| parameter with no physical meaning (used to calculate H) | |||
| | |||
|- | |||
| D<sub>s50</sub> | |||
| median size of surface layer sediment | |||
| L | |||
|- | |- | ||
|} | |} | ||
Line 186: | Line 252: | ||
</div> | </div> | ||
==Notes== | ==Notes== | ||
This program uses the Wright-Parker formulation to calculate flow resistance, and the Ashida-Michiue formulation to calculate the water depth against water discharge and bedload transport, as well as calculating the flow velocity, shear velocities, shear stress, and several other parameters. | |||
The program takes the inputs given above; the α<sub>strat</sub> is an optional parameter that may be entered; if the user chooses not to include it, it will automatically be set to 1, and stratification will not be taken into account. | The program takes the inputs given above; the α<sub>strat</sub> is an optional parameter that may be entered; if the user chooses not to include it, it will automatically be set to 1, and stratification will not be taken into account. | ||
Line 192: | Line 260: | ||
<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 205: | Line 273: | ||
==Links== | ==Links== | ||
* [[ | * [[Model:WPHydResAMBL]] | ||
[[Category:Utility components]] | [[Category:Utility components]] |
Latest revision as of 17:15, 19 February 2018
WPHydResAMBL
This model is an implementation of the Wright-Parker (2004) formulation for hydraulic resistance combined with the Ashida-Michiue (1972) bedload formulation.
Model introduction
This model is a Depth-Discharge and Bedload Calculator, uses: 1. Wright-Parker formulation for flow resistance (without stratification correction) 2. Ashida-Michiue formulation for bedload transport.
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
<math>\tau_{s} ^* = {\frac{H_{s} S}{R D_{50}}} </math> (1)
<math>U = 8.32 \sqrt { g H_{s} S } \left ( {\frac{H_{s}}{k_{s}}} \right ) ^ \left ( {\frac{1}{6}} \right ) </math> (2)
<math>\Gamma = \left ( {\frac{\tau _{s} ^* - 0.05 }{0.7}} \right ) ^ \left ( {\frac{5}{4}} \right ) </math> (3)
<math>H = [ \Gamma {\frac{R D_{s50}}{S}} \left ( {\frac{\sqrt { g }}{U}} \right ) ^ \left ( 0.7 \right ) ] ^ \left ( {\frac{20}{13}} \right ) </math> (4)
<math>q_{w} = U H </math> (5)
<math>\tau ^* = {\frac{H S}{R D_{50}}} </math> (6)
<math>Fr = {\frac{U}{\sqrt { g H }}} </math> (7)
<math>u_{*} = \sqrt { g H S } </math> (8)
<math>u_{*s} = \sqrt { g H_{s} S } </math> (9)
<math>q_{b} = \sqrt { R g D_{50} } D_{50} \left ( \tau _{s} ^* - 0.05 \right ) \left ( \sqrt { \tau _{s} ^* } - \sqrt { 0.05 } \right ) </math> (10)
Symbol | Description | Unit |
---|---|---|
τ* | actual shields stress | - |
τs* | Shields stress due to skin friction | - |
S | bed slope | - |
D50 | median sediment size | L |
D90 | size such that 90% of the sediment is finer | L |
Ds90 | size such that 90% of the sediment is finer in surface layer | L |
nk | factor such that ks = nk Ds90 | L |
R | submerged specific gravity of sediment | - |
H | low end value of water depth due to skin friction | L |
s | step size for water depth due to skin friction | - |
N | number of steps to make | - |
αstrat | factor for stratification (if not included it will be assumed 1) | - |
Hs | water depth due to the skin friction | L |
τsg | shields stress due to skin friction | - |
U | flow velocity | L / T |
qw | flow rate | L2 / T |
Fr | Froude number | - |
u* | shear velocity | L / T |
u*s | shear velocity due to skin friction | L / T |
qb | bedload transport rate | L2 / T |
g | acceleration due to gravity | L / T2 |
ks | grain roughness height associated with skin friction | |
Γ | parameter with no physical meaning (used to calculate H) | |
Ds50 | median size of surface layer sediment | L |
Notes
This program uses the Wright-Parker formulation to calculate flow resistance, and the Ashida-Michiue formulation to calculate the water depth against water discharge and bedload transport, as well as calculating the flow velocity, shear velocities, shear stress, and several other parameters.
The program takes the inputs given above; the αstrat is an optional parameter that may be entered; if the user chooses not to include it, it will automatically be set to 1, and stratification will not be taken into account.
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
- Wright, S. and Parker, G., 2004, Flow resistance and suspended load in sand-bed rivers: simplified stratification model, Journal of Hydraulic Engineering.
- Ashida, K. and M. Michiue, 1972, Study on hydraulic resistance and bedload transport rate in alluvial streams, Transactions, Japan Society of Civil