Model help:WPHydResAMBL: Difference between revisions

From CSDMS
Created page with "<!-- How to create a new "Model help" page: 1) Log in to the wiki 2) Create a new page for each model, by using the following URL: * http://csdms.colorado.edu/wiki/Model help:..."
 
m Text replacement - "http://csdms.colorado.edu/wiki/" to "https://csdms.colorado.edu/wiki/"
 
(8 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 59: Line 109:
|}
|}
::::{|
::::{|
|width=500px|<math>U = 8.32 sqrt \left ( g H_{s} S \right ) \left ( {\frac{H_{s}}{k_{s}}} \right ) ^ \left ( {\frac{1}{6}} \right ) </math>
|width=500px|<math>U = 8.32 \sqrt { g H_{s} S } \left ( {\frac{H_{s}}{k_{s}}} \right ) ^ \left ( {\frac{1}{6}} \right ) </math>
|width=50px align="right"|(2)
|width=50px align="right"|(2)
|}
|}
Line 67: Line 117:
|}
|}
::::{|
::::{|
|width=500px|<math>H = \left ( \Gamma {\frac{R D_{s50}}{S}} \left ( {\frac{sqrt \left ( g \right )}{U}} \right ) ^ \left ( 0.7 \right ) \right ) ^ \left ( {\frac{20}{13}} \right ) </math>
|width=500px|<math>H = [ \Gamma {\frac{R D_{s50}}{S}} \left ( {\frac{\sqrt { g }}{U}} \right ) ^ \left ( 0.7 \right ) ] ^ \left ( {\frac{20}{13}} \right ) </math>
|width=50px align="right"|(4)
|width=50px align="right"|(4)
|}
|}
Line 79: Line 129:
|}
|}
::::{|
::::{|
|width=500px|<math>Fr = {\frac{U}{sqrt \left ( g H \right )}} </math>
|width=500px|<math>Fr = {\frac{U}{\sqrt { g H }}} </math>
|width=50px align="right"|(7)
|width=50px align="right"|(7)
|}
|}
::::{|
::::{|
|width=500px|<math>u_{*} = sqrt \left ( g H S \right ) </math>
|width=500px|<math>u_{*} = \sqrt { g H S } </math>
|width=50px align="right"|(8)
|width=50px align="right"|(8)
|}
|}
::::{|
::::{|
|width=500px|<math>u_{*s} = sqrt \left ( g H_{s} S \right ) </math>
|width=500px|<math>u_{*s} = \sqrt { g H_{s} S } </math>
|width=50px align="right"|(9)
|width=50px align="right"|(9)
|}
|}
::::{|
::::{|
|width=500px|<math>q_{b} = sqrt \left ( R g D_{50} \right ) D_{50} \left ( \tau _{s} ^* - 0.05 \right ) \left ( sqrt \left ( \tau _{s} ^* \right ) - sqrt \left ( 0.05 \right ) \right ) </math>
|width=500px|<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>
|width=50px align="right"|(10)
|width=50px align="right"|(10)
|}
|}
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
| -
| -
|-
| 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
| -
|-
| α<sub>strat</sub>
| factor for stratification (if not included it will be assumed 1)
| -
|-
| H<sub>s</sub>
| water depth due to the skin friction
| L
|-
| τ<sub>sg</sub>
| shields stress due to skin friction
| -
|-
| U
| flow velocity
| L / T
|-
| q<sub>w</sub>
| flow rate
| L<sup>2</sup> / T
|-
| Fr
| Froude number
| -
|-
| u<sub>*</sub>
| shear velocity
| L / T
|-
| u<sub>*s</sub>
| shear velocity due to skin friction
| L / T
|-
| q<sub>b</sub>
| 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 125: Line 252:
</div>
</div>
==Notes==
==Notes==
<span class="remove_this_tag">Any notes, comments, you want to share with the user</span>
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.
 
<span class="remove_this_tag">Numerical scheme</span>


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.


==Examples==
==Examples==
Line 134: 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 147: 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

Retrieved from "https://csdms.colorado.edu/csdms_wiki/index.php?title=Model_help:WPHydResAMBL&oldid=216378"