Model help:WPHydResAMBL: 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 23: Line 23:
<div id=CMT_MODEL_PARAMETERS>
<div id=CMT_MODEL_PARAMETERS>
==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%"|Bed slope
|width="60%"|<span class="remove_this_tag">Description parameter</span>
|width="60%"|
|width="20%"|<span class="remove_this_tag">[Units]</span>
|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
|
| -
|-
|}
|}


= 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 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
| mm
| 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
| mm
| 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>
| mm
| L
|-
|-
| R
| R
| submerged specific gravity of sediment
| submerged specific gravity of sediment
| -
|-
| n
| factor in the roughness height calculation
| -
| -
|-
|-
| H
| H
| low end value of water depth due to skin friction
| low end value of water depth due to skin friction
| m
| L
|-
|-
| s
| s
| step size for water depth due to skin friction
| step size for water depth due to skin friction
| m
| -
|-
|-
| N
| N
Line 137: Line 195:
| -
| -
|-
|-
| a
| α<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
| m
| L
|-
|-
| τ<sub>sg</sub>
| τ<sub>sg</sub>
| shields stress due to skin friction
| shields stress due to skin friction
| N / m<sup>2</sup>
| -
|-
|-
| U
| U
| flow velocity
| flow velocity
| m / s
| L / T
|-
| γ
| parameter with no physical meaning (used in calculations of H)
| -
|-
|-
| q<sub>w</sub>
| q<sub>w</sub>
| flow rate
| flow rate
| m<sup>2</sup> / s
| L<sup>2</sup> / T
|-
| τ
| actual shields stress
| N / m<sup>2</sup>
|-
|-
| Fr
| Fr
Line 169: Line 219:
| -
| -
|-
|-
| u<sup>*</sup>
| u<sub>*</sub>
| shear velocity
| shear velocity
| m / s
| L / T
|-
|-
| u<sup>*</sup>s
| u<sub>*s</sub>
| shear velocity due to skin friction
| shear velocity due to skin friction
| m / s
| L / T
|-
|-
| q<sub>b</sub>
| q<sub>b</sub>
| bedload transport rate
| bedload transport rate
| m<sup>2</sup> / s
| 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: 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 205: Line 273:


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


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

Latest revision as of 17:15, 19 February 2018

The CSDMS Help System
The CSDMS Help System

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

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
Bed slope -
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 -
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

<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)

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:

See also: Help:Images or Help:Movies

Developer(s)

Gary Parker

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

Links