Model help:Acronym1: Difference between revisions

From CSDMS
No edit summary
No edit summary
Line 65: Line 65:
|}
|}
::::{|
::::{|
|width=500px|<math>D_{i}= Sqrt \left (D_{b, i} D_{b, i+1} \right )  </math>
|width=530px|<math>D_{i}= Sqrt \left (D_{b, i} D_{b, i+1} \right )  </math>
|width=50p=x align="right"|(3)
|width=50p=x align="right"|(3)
|}
|}
::::{|
::::{|
|width=500px|<math>F_{i}= \left ( F_{f, i} - F_{f, i+1} \right ) / 100  </math>
|width=530px|<math>F_{i}= \left ( F_{f, i} - F_{f, i+1} \right ) / 100  </math>
|width=50p=x align="right"|(4)
|width=50p=x align="right"|(4)
|}
|}
Line 89: Line 89:
|}
|}
::::{|
::::{|
|width=500px|<math>W_{i}^*= {\frac{Rgq_{bi}}{F_{i}u_{*} ^3}}= 0.00218 G \left (\Phi \right )  </math>
|width=530px|<math>W_{i}^*= {\frac{Rgq_{bi}}{F_{i}u_{*} ^3}}= 0.00218 G \left (\Phi \right )  </math>
|width=50p=x align="right"|(9)
|width=50p=x align="right"|(9)
|}
|}
::::{|
::::{|
|width=500px|<math>\phi= \omega \phi_{sgo} \left ( {\frac{D_{i}} {D_{sg}}} \right )^ \left (-0.0951 \right )  </math>
|width=530px|<math>\phi= \omega \phi_{sgo} \left ( {\frac{D_{i}} {D_{sg}}} \right )^ \left (-0.0951 \right )  </math>
|width=50p=x align="right"|(10)
|width=50p=x align="right"|(10)
|}
|}
::::{|
::::{|
|width=500px|<math> \Phi= {\frac{\tau_{sg} ^*}{\tau_{ssrg} ^*}}  </math>
|width=530px|<math> \Phi= {\frac{\tau_{sg} ^*}{\tau_{ssrg} ^*}}  </math>
|width=50p=x align="right"|(11)
|width=50p=x align="right"|(11)
|}
|}
::::{|
::::{|
|width=500px|<math>\tau_{sg} ^*={\frac{u_{*} ^2}{Rg D_{sg}}}  </math>
|width=530px|<math>\tau_{sg} ^*={\frac{u_{*} ^2}{Rg D_{sg}}}  </math>
|width=50p=x align="right"|(12)
|width=50p=x align="right"|(12)
|}
|}
* φ> 1.59
* φ> 1.59
::::{|
::::{|
|width=500px|<math> G \left ( \Phi \right )= 5474 \left ( 1 - {\frac{0.853}{\Phi}} \right ) ^ \left (4.5 \right )  </math>
|width=530px|<math> G \left ( \Phi \right )= 5474 \left ( 1 - {\frac{0.853}{\Phi}} \right ) ^ \left (4.5 \right )  </math>
|width=50p=x align="right"|(13)
|width=50p=x align="right"|(13)
|}
|}
* 1<=φ<=1.59
* 1<=φ<=1.59
::::{|
::::{|
|width=500px|<math> G\left (\Phi \right )= exp\left ( 14.2\left ( \Phi - 1\right ) - 9.28 \left ( \Phi - 1 \right )^2  \right )  </math>
|width=530px|<math> G\left (\Phi \right )= exp\left ( 14.2\left ( \Phi - 1\right ) - 9.28 \left ( \Phi - 1 \right )^2  \right )  </math>
|width=50p=x align="right"|(14)
|width=50p=x align="right"|(14)
|}
|}
* φ< 1
* φ< 1
::::{|
::::{|
|width=500px|<math> G\left (\Phi \right )= \Phi ^\left (14.2 \right )  </math>
|width=530px|<math> G\left (\Phi \right )= \Phi ^\left (14.2 \right )  </math>
|width=50p=x align="right"|(15)
|width=50p=x align="right"|(15)
|}
|}
::::{|
::::{|
|width=500px|<math>\omega= 1 + {\frac{\sigma}{\sigma_{O} \left ( \Phi_{sgo} \right ) }} \left ( \omega_{O} \left ( \Phi_{sgo} \right ) - 1 \right )  </math>
|width=530px|<math>\omega= 1 + {\frac{\sigma}{\sigma_{O} \left ( \Phi_{sgo} \right ) }} \left ( \omega_{O} \left ( \Phi_{sgo} \right ) - 1 \right )  </math>
|width=50p=x align="right"|(16)
|width=50p=x align="right"|(16)
|}
|}
::::{|
::::{|
|width=500px|<math>q_{bT}= \Sigma q_{bi}  </math>
|width=530px|<math>q_{bT}= \Sigma q_{bi}  </math>
|width=50p=x align="right"|(17)
|width=50p=x align="right"|(17)
|}
|}
::::{|
::::{|
|width=500px|<math>p_{i}= {\frac{q_{bi}}{q_{bT}}}  </math>
|width=530px|<math>p_{i}= {\frac{q_{bi}}{q_{bT}}}  </math>
|width=50p=x align="right"|(18)
|width=50p=x align="right"|(18)
|}
|}
::::{|
::::{|
|width=500px|<math>D_{lg}= 2 ^\left (\psi_{l} \right )  </math>
|width=530px|<math>D_{lg}= 2 ^\left (\psi_{l} \right )  </math>
|width=50p=x align="right"|(19)
|width=50p=x align="right"|(19)
|}
|}
::::{|
::::{|
|width=500px|<math>\Psi_{l}= \Sigma \Psi_{i} p_{i}  </math>
|width=530px|<math>\Psi_{l}= \Sigma \Psi_{i} p_{i}  </math>
|width=50p=x align="right"|(20)
|width=50p=x align="right"|(20)
|}
|}
::::{|
::::{|
|width=500px|<math>\delta_{lg}= 2 ^\left ( \delta_{l} \right )  </math>
|width=530px|<math>\delta_{lg}= 2 ^\left ( \delta_{l} \right )  </math>
|width=50p=x align="right"|(21)
|width=50p=x align="right"|(21)
|}
|}
::::{|
::::{|
|width=500px|<math>\delta_{l} ^2= \Sigma \left ( \Psi_{i} - \Psi_{l} \right )^2 p_{i}  </math>
|width=530px|<math>\delta_{l} ^2= \Sigma \left ( \Psi_{i} - \Psi_{l} \right )^2 p_{i}  </math>
|width=50p=x align="right"|(22)
|width=50p=x align="right"|(22)
|}
|}
::::{|
::::{|
|width=500px|<math>D_{lx}= 2 ^\left (\Psi_{lx} \right )  </math>
|width=530px|<math>D_{lx}= 2 ^\left (\Psi_{lx} \right )  </math>
|width=50p=x align="right"|(23)
|width=50p=x align="right"|(23)
|}
|}
::::{|
::::{|
|width=500px|<math>\Psi_{lx}= \Psi_{b, i+1} + {\frac{\Psi_{b, j} - \Psi_{b, i+1}}{p_{f, i} - p_{f, i+1}}}\left ( x - p_{f, i+1} \right ) </math>
|width=530px|<math>\Psi_{lx}= \Psi_{b, i+1} + {\frac{\Psi_{b, j} - \Psi_{b, i+1}}{p_{f, i} - p_{f, i+1}}}\left ( x - p_{f, i+1} \right ) </math>
|width=50p=x align="right"|(24)
|width=50p=x align="right"|(24)
|}
|}
::::{|
::::{|
|width=500px|<math>\Psi_{b, i}= Ln_{2} \left ( D_{b, j} \right )  </math>
|width=530px|<math>\Psi_{b, i}= Ln_{2} \left ( D_{b, j} \right )  </math>
|width=50p=x align="right"|(25)
|width=50p=x align="right"|(25)
|}
|}
<div class="NavFrame collapsed" style="text-align:left">
  <div class="NavHead">Nomenclature</div>
  <div class="NavContent">
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| D<sub>i</sub>
| characteristic grain size (for i =1~N)
| mm
|-
| F<sub>i</sub>
| surface layer (for i =1~N)
| -
|-
| ψ
| grain sizes
| mm
|-
| D<sub>sg</sub>
| geometric mean size of the surface material
| mm
|-
| σ<sub>sg</sub>
| geometric standard deviations
| -
|-
| σ
| arithmetic standard deviations
| -
|-
| ρ
| density of water
| kg/m<sup>3</sup>
|-
| ρ<sub>s</sub>
| density of sediment
| kg/m<sup>3</sup>
|-
| R
| submerged specific density of sediment
| -
|-
| g
| acceleration of gravity
| m / s<sup>2</sup>
|-
| τ<sub>b</sub>
| boundary shear stress on the bed
| kg / (m s)
|-
| u
| shear velocity on the bed
| m / s
|-
| q<sub>bi</sub>
| volume gravel bedload transport per unit width of grains in the ith size range
| m <sup>2</sup>
|-
| u<sub>*</sub>
| shear velocity
| m / s
|-
| D<sub>lg</sub>
| geometric mean of the bedload
| mm
|-
| σ<sub>lg</sub>
| geometric standard deviation of the bedload
| -
|- 
| D<sub>sx</sub>
| size in the surface material, such that x percentage of the material is finer
| mm
|-
| D<sub>lx</sub>
| size in the bedload material, such that x percentage of the material is finer
| -
|- 
| D<sub>sx</sub>
| size in the surface material, such that x percentage of the material is finer
| mm
|-
|}
'''Output'''
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| q<sub>bT</sub>
| total volume gravel bedload transport rate per unit width summed over all sizes
| -
|-
| v
| flow velocity
| m / s
|-
| τ<sub>sg</sub>
| shield stress
| kg / (m s)
|-
|}
  </div>
</div>
==Notes==
==Notes==
<span class="remove_this_tag">Any notes, comments, you want to share with the user</span>  
* Note on equations
In order to implement the equations 10~16, it is necessary to specify a) the surface grain size distribution (D<sub>f</sub>,i, F<sub>f</sub>,i) and b) the shear velocity u<sub>∗</sub>.  This results in a predicted values of q<sub>bi</sub>.


<span class="remove_this_tag">Numerical scheme</span>
If the boundary shear stress at the bed includes a component of form drag, the component must be removed before computing u<sub>∗</sub>.
 
Once the parameters q<sub>bi</sub> are known the total volume bedload transport rate per unit width q<sub>bT</sub> and the fractions pi in the bedload can be calculated as equations 17, 18.
 
The results are presented in terms of q<sub>bT</sub> and the grain size distribution of the bedload, which is computed from the values of pi.  These same fractions pi are used to compute the geometric mean and geometric standard deviation of the bedload D<sub>lg</sub> and σ<sub>lg</sub>, respectively, from the relations of equations 19, 20, 21, 22.
 
The percent finer in the bedload p<sub>f,i</sub> for the grain size D<sub>f,i</sub> is obtained from the fractions p<sub>i</sub> as follows:
p<sub>f,1</sub> = 100
p<sub>f,i</sub> = p<sub>f,i-1</sub> - 100 p<sub>i-1</sub> (i=2~N+1)
 
Let D<sub>sx</sub> and D<sub>lx</sub> denote sizes in the surface and bedload material, respectively, such that x percent of the material is finer.  For example, if x = 50 then Ds50 and D<sub>l50</sub> denote the median sizes of the surface and bedload material, respectively.  Once F<sub>f,i</sub> is specified (p<sub>f</sub>,i is computed) the value D<sub>sx</sub> (D<sub>lx</sub>) can be computed by interpolation.  The interpolation should be done using a logarithmic scale for grain size.  For example, consider the computation of Dlx where p<sub>f,i</sub> ≤ x ≤ p<sub>f,i+1</sub>.  Then we got equation 23, 24, using equation 25.




Line 175: Line 290:


==Developer(s)==
==Developer(s)==
<span class="remove_this_tag">Name of the module developer(s)</span>
[[User:Gparker|Gary Parker ]]


==References==
==References==
<span class="remove_this_tag">Key papers</span>
* Parker, G.  1990a  Surface based bedload transport relation for gravel rivers.  Journal of Hydraulic Research, 28(4), 417 436.
 
* Parker, G.  1990b  The "ACRONYM" series of Pascal programs for computing bedload transport in gravel rivers.  External Memorandum M 220, St. Anthony Falls Hydraulic Laboratory, University of Minnesota.


==Links==
==Links==
<span class="remove_this_tag">Any link, eg. to the model questionnaire, etc.</span>
* [[http://csdms.colorado.edu/wiki/Model:Acronym1 Model:Acronym1]]


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

Revision as of 14:38, 12 April 2011

The CSDMS Help System

Acronym1

The Acronym1 programs implement the Parker (1990a) surface-based bedload transport relation in order to compute gravel bedload transport rates.

Model introduction

The gravel is divided into N grain size ranges bounded by N+1 sizes Db,i, i = 1 to N+1. The grain size distribution of the surface (active) layer of the bed is specified in terms of the N+1 pairs (Db,i, Ff,i), i = 1..N+1, where Ff,i denotes the percent finer in the surface layer. Here Db,1 must be the coarsest size, such that Ff,1 = 100, and Db,N+1 must be the finest size, such that Ff,N+1 = 0.

The finest size must equal or exceed 2 mm. That is, the sand must be removed from the surface size distribution, and the fractions appropriately renormalized, in determining the surface grain size distribution to be input into Acronym1.


Model parameters

Parameter Description Unit
First parameter Description parameter [Units]
Parameter Description Unit
First parameter Description parameter [Units]

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

  • Grain Size:
[math]\displaystyle{ \Psi= LN_{2}\left (D\right) = {\frac{log_{10}\left (D\right)}{log_{10}\left (2\right)}} }[/math] (1)
[math]\displaystyle{ \Psi_{i}= LN_{2}\left ( D_{i}\right) = {\frac{log_{10}\left (D_{i}\right)}{log_{10}\left (2\right)}} }[/math] (2)
[math]\displaystyle{ D_{i}= Sqrt \left (D_{b, i} D_{b, i+1} \right ) }[/math] (3)
[math]\displaystyle{ F_{i}= \left ( F_{f, i} - F_{f, i+1} \right ) / 100 }[/math] (4)
[math]\displaystyle{ D_{sg}=2^\Psi_{s} }[/math] (5)
[math]\displaystyle{ \Psi_{s}= \Sigma \Psi_{i} F{i} }[/math] (6)
[math]\displaystyle{ \sigma_{sg}= 2 ^\sigma }[/math] (7)
[math]\displaystyle{ \sigma ^2= \Sigma \left (\Psi_{i} - \Psi \right )^2 F_{i} }[/math] (8)
[math]\displaystyle{ W_{i}^*= {\frac{Rgq_{bi}}{F_{i}u_{*} ^3}}= 0.00218 G \left (\Phi \right ) }[/math] (9)
[math]\displaystyle{ \phi= \omega \phi_{sgo} \left ( {\frac{D_{i}} {D_{sg}}} \right )^ \left (-0.0951 \right ) }[/math] (10)
[math]\displaystyle{ \Phi= {\frac{\tau_{sg} ^*}{\tau_{ssrg} ^*}} }[/math] (11)
[math]\displaystyle{ \tau_{sg} ^*={\frac{u_{*} ^2}{Rg D_{sg}}} }[/math] (12)
  • φ> 1.59
[math]\displaystyle{ G \left ( \Phi \right )= 5474 \left ( 1 - {\frac{0.853}{\Phi}} \right ) ^ \left (4.5 \right ) }[/math] (13)
  • 1<=φ<=1.59
[math]\displaystyle{ G\left (\Phi \right )= exp\left ( 14.2\left ( \Phi - 1\right ) - 9.28 \left ( \Phi - 1 \right )^2 \right ) }[/math] (14)
  • φ< 1
[math]\displaystyle{ G\left (\Phi \right )= \Phi ^\left (14.2 \right ) }[/math] (15)
[math]\displaystyle{ \omega= 1 + {\frac{\sigma}{\sigma_{O} \left ( \Phi_{sgo} \right ) }} \left ( \omega_{O} \left ( \Phi_{sgo} \right ) - 1 \right ) }[/math] (16)
[math]\displaystyle{ q_{bT}= \Sigma q_{bi} }[/math] (17)
[math]\displaystyle{ p_{i}= {\frac{q_{bi}}{q_{bT}}} }[/math] (18)
[math]\displaystyle{ D_{lg}= 2 ^\left (\psi_{l} \right ) }[/math] (19)
[math]\displaystyle{ \Psi_{l}= \Sigma \Psi_{i} p_{i} }[/math] (20)
[math]\displaystyle{ \delta_{lg}= 2 ^\left ( \delta_{l} \right ) }[/math] (21)
[math]\displaystyle{ \delta_{l} ^2= \Sigma \left ( \Psi_{i} - \Psi_{l} \right )^2 p_{i} }[/math] (22)
[math]\displaystyle{ D_{lx}= 2 ^\left (\Psi_{lx} \right ) }[/math] (23)
[math]\displaystyle{ \Psi_{lx}= \Psi_{b, i+1} + {\frac{\Psi_{b, j} - \Psi_{b, i+1}}{p_{f, i} - p_{f, i+1}}}\left ( x - p_{f, i+1} \right ) }[/math] (24)
[math]\displaystyle{ \Psi_{b, i}= Ln_{2} \left ( D_{b, j} \right ) }[/math] (25)

Notes

  • Note on equations

In order to implement the equations 10~16, it is necessary to specify a) the surface grain size distribution (Df,i, Ff,i) and b) the shear velocity u. This results in a predicted values of qbi.

If the boundary shear stress at the bed includes a component of form drag, the component must be removed before computing u.

Once the parameters qbi are known the total volume bedload transport rate per unit width qbT and the fractions pi in the bedload can be calculated as equations 17, 18.

The results are presented in terms of qbT and the grain size distribution of the bedload, which is computed from the values of pi. These same fractions pi are used to compute the geometric mean and geometric standard deviation of the bedload Dlg and σlg, respectively, from the relations of equations 19, 20, 21, 22.

The percent finer in the bedload pf,i for the grain size Df,i is obtained from the fractions pi as follows: pf,1 = 100 pf,i = pf,i-1 - 100 pi-1 (i=2~N+1)

Let Dsx and Dlx denote sizes in the surface and bedload material, respectively, such that x percent of the material is finer. For example, if x = 50 then Ds50 and Dl50 denote the median sizes of the surface and bedload material, respectively. Once Ff,i is specified (pf,i is computed) the value Dsx (Dlx) can be computed by interpolation. The interpolation should be done using a logarithmic scale for grain size. For example, consider the computation of Dlx where pf,i ≤ x ≤ pf,i+1. Then we got equation 23, 24, using equation 25.


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

  • Parker, G. 1990a Surface based bedload transport relation for gravel rivers. Journal of Hydraulic Research, 28(4), 417 436.
  • Parker, G. 1990b The "ACRONYM" series of Pascal programs for computing bedload transport in gravel rivers. External Memorandum M 220, St. Anthony Falls Hydraulic Laboratory, University of Minnesota.

Links