Model help:AgDegNormGravMixPW: Difference between revisions

From CSDMS
No edit summary
No edit summary
Line 54: Line 54:


==Main equations==
==Main equations==
<span class="remove_this_tag">A list of the key equations. HTML format is supported; latex format will be supported in the future</span>
* Exner equation of conservation of channel bed sediment
::::{|
|width=530px|<math> \left ( 1 - \lambda _{p} \right ) {\frac{\partial \eta}{\partial t}} = - I_{f} {\frac{\partial q_{bT}}{\partial x}} </math>
|width=50p=x align="right"|(1)
|}
* Characteristic diameter
::::{|
|width=530px|<math> D_{i} = \left ( D_{b,i} \ast D_{b,i+1} \right ) ^ \left ( {\frac{1}{2}} \right ) </math>
|width=50p=x align="right"|(2)
|}
::::{|
|width=530px|<math> f_{i} = f_{f,i+1} - f_{f,i} </math>
|width=50p=x align="right"|(3)
|}
* The conservation of sediment in each grain size range
::::{|
|width=530px|<math> \left ( 1 - \lambda _{p} \right ) [L_{a} {\frac{\partial F_{i}}{\partial t}} + \left ( F_{i} - f_{li} \right ) {\frac{\partial L_{a}}{\partial t}}] = -I_{f} {\frac{\partial q_{bT} p_{i}}{\partial x}} + I_{f} f_{li} {\frac{\partial q_{bT}}{\partial x}} </math>
|width=50p=x align="right"|(4)
|}
* Fraction of sediment in the ith grain size range at the active-layer substrate interface (if ∂η / ∂t > 0)
::::{|
|width=530px|<math> f_{li} = \alpha F_{i} + \left ( 1 - \alpha \right ) p_{i}  </math>
|width=50p=x align="right"|(5)
|}
* Fraction of sediment in the ith grain size range at the active-layer substrate interface (if ∂η / ∂t < 0)
::::{|
|width=530px|<math> f_{li} = f_{sub,i}  </math>
|width=50p=x align="right"|(6)
|}
* Roughness height due to skin friction
::::{|
|width=530px|<math> k_{s} = n_{k} D_{s90}  </math>
|width=50p=x align="right"|(7)
|}
::::{|
|width=530px|<math> L_{a} = n_{a} D_{s90}  </math>
|width=50p=x align="right"|(8)
|}
* Non-dimensional bed shear stress
::::{|
|width=530px|<math> \tau _{sg} ^* = {\frac{\tau_{b}}{\left ( \rho _{s} - \rho \right ) g D_{sg}}}  </math>
|width=50p=x align="right"|(9)
|}


<div class="NavFrame collapsed" style="text-align:left">
<div class="NavFrame collapsed" style="text-align:left">
Line 133: Line 175:
| coefficient, Cf, in the Chezy formulation
| coefficient, Cf, in the Chezy formulation
| -
| -
|}
|-
 
| q<sub>w</sub>
'''Output'''
| the characteristic flood discharge per unit channel width
{| {{Prettytable}} class="wikitable sortable"
| -
!Symbol!!Description!!Unit
|- 
| I<sub>f</sub>
| flood intermittency
| -
|-
| q<sub>bTf</sub>
| the volumetric gravel input rate per unit channel width
| -
|-
| η<sub>d</sub>
| the downstream bed elevation
| m
|- 
| λ<sub>p</sub>
| the bed porosity
| -
|-
| S<sub>l</sub>
| the initial bed slope
| -
|-
| D<sub>bi</sub>
| the bound diameter
| -
|-
| n<sub>k</sub>
| dimensionless coefficient typically between 2 and 5
| -
|-
| Δt
| time step
| year
|-
| Ntoprint
| number of time steps to printout
| -
|-
| Nprint
| number of printouts
| -
|-
| a<sub>U</sub>
| upwinding coefficient (1=full upwind, 0.5=central difference)
| -
|-
| α<sub>r</sub>
| coefficient to compute the roughness height
| -
|-
| n<sub>a</sub>
| coefficient to compute the thickness of the active layer
| -
|-
| α
| the parameter that governs the grain size distribution of the sediment at the active layer-substrate interface during bed aggradation
| -
|-
|-
| x
| x
Line 146: Line 243:
| slope of the bed surface
| slope of the bed surface
| -
| -
|-
| u<sub>*</sub>
| shear velocity
| m / s
|-
| p<sub>feed</sub>
| GSD of the feed
| tons / year
|-
| F<sub>fs</sub>
| GSD of the substrate
| -
|-
| F<sub>f</sub>
| GSD of the final surface
| -
|-
| η
| bed elevation
| m
|-
| f<sub>fi</sub>
| the mass fraction of the sample that is finer than D<sub>bi</sub>
| -
|-
| f<sub>i</sub>
| the fraction of sample in the ith size range
| -
|-
| p<sub>i</sub>
| the fraction of sediment in the ith grain size range in the bedload
| -
|-
| α
| a user specified parameter
| -
|-
| f<sub>sub,i</sub>
| the fraction of substrate material in the ith range
| -
|-
| ψ<sub>s</sub>
| boundary shear stress due to skin friction
| -
|-
| k<sub>c</sub>
| composite roughness height for the Manning-Strickler formulation
| -
|-
| k<sub>s</sub>
| roughness height due to skin friction
| -
|-
| F<sub>fi</sub>
| grain size distributions of the active layer
| -
|-
|}
'''Output'''
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
|-
| H
| H
| water depth
| water depth
| m
| m
|-
| u<sub>*</sub>
| shear velocity
| m / s
|-
|-
| τ<sub>sg</sub>
| τ<sub>sg</sub>
Line 167: Line 322:
| m<sup>2</sup> / s
| m<sup>2</sup> / s
|-
|-
| q<sub>bf</sub>
| q<sub>bTf</sub>
| upstream feed rate
| upstream feed rate
| tons / year
| tons / year
|-
|-
| d<sub>sg</sub>
| D<sub>sg</sub>
| geometric mean grain size on the bed surface
| geometric mean grain size on the bed surface
| mm
| mm
|-
|-
| d<sub>90s</sub>
| D<sub>s90</sub>
| the diameter such that 90% of the bed surface is finer
| the diameter such that 90% of the bed surface is finer
| mm
| mm
|-
| p<sub>feed</sub>
| GSD of the feed
| tons / year
|-
| F<sub>fs</sub>
| GSD of the substrate
| -
|-
| F<sub>f</sub>
| GSD of the final surface
| -
|-
|-
|}
|}
Line 196: Line 339:


==Notes==
==Notes==
The program AgDegNormGravMixPW is an extension of AgDegNormal for sediment mixtures in gravel bed rivers where the channel bed material is transported as bedload only.  Gravel-bed rivers tend to be poorly-sorted.  During floods, bed material load consists almost exclusively of bedload.  (Sand is often transported in copious quantities as washload during floods.)  The surface material (armor or pavement) tends to be coarser than the substrate.  By definition the median size D<sub>sub50</sub> or geometric mean size D<sub>subg</sub> of the substrate is in the gravel range, but the substrate may contain up to 30% sand in the interstices of an otherwise clast-supported deposit.
The grain size distributions of the sediment feed, initial surface material and substrate material must be specified. It is assumed that the grain size distribution of the sediment feed rate does not change in time, the initial grain size distribution of the surface material is the same at every node, the grain size distribution of the substrate is the same at every node and does not vary in the vertical. These constraints are easy to relax.
The grain size distributions of the sediment feed, initial surface material and substrate material must be specified. It is assumed that the grain size distribution of the sediment feed rate does not change in time, the initial grain size distribution of the surface material is the same at every node, the grain size distribution of the substrate is the same at every node and does not vary in the vertical. These constraints are easy to relax.


Line 208: Line 353:
In performing the calculation, the following control parameters must be specified:
In performing the calculation, the following control parameters must be specified:
M = number of spatial intervals, so that the spatial step length = L/M; dt = time step length; Ntoprint = number of time steps to a printout; Nprint = number of printouts in the calculation.  
M = number of spatial intervals, so that the spatial step length = L/M; dt = time step length; Ntoprint = number of time steps to a printout; Nprint = number of printouts in the calculation.  
* Note on model running
In the case of the load relation due to Parker (1990), the grain size distributions are automatically renormalized because the relation is for the transport of gravel only in the case of the load relation due to Wilcock-Crowe (2003), the sand and the fine sediment are retained for the computation
The user will be prompted by the program as to which bedload relation he would like to use.
The input grain size distributions may be on a 0-100% or a 0.00-1.00 scale, and the program will automatically scale.
The input grain size distributions must have bounds at 0% and 100% (1.00) to properly perform the calculation. If the user does not input the bounds the program will automatically interpolate upper and lower bounds D<sub>bU</sub> and D<sub>bL</sub> such that f<sub>fU</sub> = 100 (1.00) and f<sub>fL</sub> = 0
The water depth is calculated using a Chézy formulation, when only the Chézy coefficient is specified in the input text file.  The Manning-Strickler formulation is implemented, when only the coefficients αr and nk are given in the inputfile.  When all the three parameters are present, the program will ask the user which formulation they would like to use.


==Examples==
==Examples==

Revision as of 19:34, 21 April 2011

The CSDMS Help System

AgDegNormGravMixPW

This is the calculator for aggradation and degradation of sediment mixtures in gravel-bed streams.

Model introduction

This program computes the time evolution of the long profile of a river of constant width carrying a mixture of gravel sizes, the downstream end of which has a prescribed elevation. In particular, the program computes the time evolution of the spatial profiles of bed elevation, total gravel bedload transport rate and grain size distribution of the surface (active) layer of the bed. The river has constant width. The upstream point, at which sediment is fed, is fixed in the horizontal to be at x = 0. The vertical elevation of the upstream point may change freely as the bed aggrades or degrades. The reach has constant length L, so that the downstream point is fixed in the horizontal at x = L. This downstream point has a user-specified initial elevation hdI.

Gravel bedload transport of mixtures is computed with a user-specified selection of the Parker (1990), or Wilcock-Crowe (2003) surface-based formulations for gravel transport. Sand and finer material must first be excluded from the grain size distributions, which then must be renormalized for gravel content only, in the case of the Parker (1990) relation. In the case of the Wilcock-Crowe (2003) relation, the sand is retained in the computation.

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

  • Exner equation of conservation of channel bed sediment
[math]\displaystyle{ \left ( 1 - \lambda _{p} \right ) {\frac{\partial \eta}{\partial t}} = - I_{f} {\frac{\partial q_{bT}}{\partial x}} }[/math] (1)
  • Characteristic diameter
[math]\displaystyle{ D_{i} = \left ( D_{b,i} \ast D_{b,i+1} \right ) ^ \left ( {\frac{1}{2}} \right ) }[/math] (2)
[math]\displaystyle{ f_{i} = f_{f,i+1} - f_{f,i} }[/math] (3)
  • The conservation of sediment in each grain size range
[math]\displaystyle{ \left ( 1 - \lambda _{p} \right ) [L_{a} {\frac{\partial F_{i}}{\partial t}} + \left ( F_{i} - f_{li} \right ) {\frac{\partial L_{a}}{\partial t}}] = -I_{f} {\frac{\partial q_{bT} p_{i}}{\partial x}} + I_{f} f_{li} {\frac{\partial q_{bT}}{\partial x}} }[/math] (4)
  • Fraction of sediment in the ith grain size range at the active-layer substrate interface (if ∂η / ∂t > 0)
[math]\displaystyle{ f_{li} = \alpha F_{i} + \left ( 1 - \alpha \right ) p_{i} }[/math] (5)
  • Fraction of sediment in the ith grain size range at the active-layer substrate interface (if ∂η / ∂t < 0)
[math]\displaystyle{ f_{li} = f_{sub,i} }[/math] (6)
  • Roughness height due to skin friction
[math]\displaystyle{ k_{s} = n_{k} D_{s90} }[/math] (7)
[math]\displaystyle{ L_{a} = n_{a} D_{s90} }[/math] (8)
  • Non-dimensional bed shear stress
[math]\displaystyle{ \tau _{sg} ^* = {\frac{\tau_{b}}{\left ( \rho _{s} - \rho \right ) g D_{sg}}} }[/math] (9)

Notes

The program AgDegNormGravMixPW is an extension of AgDegNormal for sediment mixtures in gravel bed rivers where the channel bed material is transported as bedload only. Gravel-bed rivers tend to be poorly-sorted. During floods, bed material load consists almost exclusively of bedload. (Sand is often transported in copious quantities as washload during floods.) The surface material (armor or pavement) tends to be coarser than the substrate. By definition the median size Dsub50 or geometric mean size Dsubg of the substrate is in the gravel range, but the substrate may contain up to 30% sand in the interstices of an otherwise clast-supported deposit.

The grain size distributions of the sediment feed, initial surface material and substrate material must be specified. It is assumed that the grain size distribution of the sediment feed rate does not change in time, the initial grain size distribution of the surface material is the same at every node, the grain size distribution of the substrate is the same at every node and does not vary in the vertical. These constraints are easy to relax.

The program does not store the vertical and streamwise structure of the new substrate created as the bed aggrades. It is assumed that the grain size distribution of the sediment feed rate does not change in time, the initial grain size distribution of the surface material is the same at every node, the grain size distribution of the substrate is the same at every node and does notvary in the vertical. These constraints are easy to relax.

The program does not store the vertical and streamwise structure of the new substrate created as the bed aggrades. As a result, is cannot capture the case of aggradation followed by degradation. Again, the constraint is easy to relax, but at the price of increased memory requirements for storing the newly-created substrate.

The flow is calculated using the normal flow (local equilibrium) approximation.

The river is assumed to be morphologically active only intermittently (during floods); this condition is specified in terms of an intermittency If < 1 expressing the fraction of time the river is in flood.

In performing the calculation, the following control parameters must be specified: M = number of spatial intervals, so that the spatial step length = L/M; dt = time step length; Ntoprint = number of time steps to a printout; Nprint = number of printouts in the calculation.

  • Note on model running

In the case of the load relation due to Parker (1990), the grain size distributions are automatically renormalized because the relation is for the transport of gravel only in the case of the load relation due to Wilcock-Crowe (2003), the sand and the fine sediment are retained for the computation

The user will be prompted by the program as to which bedload relation he would like to use.

The input grain size distributions may be on a 0-100% or a 0.00-1.00 scale, and the program will automatically scale.

The input grain size distributions must have bounds at 0% and 100% (1.00) to properly perform the calculation. If the user does not input the bounds the program will automatically interpolate upper and lower bounds DbU and DbL such that ffU = 100 (1.00) and ffL = 0

The water depth is calculated using a Chézy formulation, when only the Chézy coefficient is specified in the input text file. The Manning-Strickler formulation is implemented, when only the coefficients αr and nk are given in the inputfile. When all the three parameters are present, the program will ask the user which formulation they would like to use.

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

Links