Model help:AgDegNormalSub: 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:...")
 
No edit summary
Line 52: Line 52:


==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 for uniform sediment from a flume-like setting
::::{|
|width=500px|<math> \left ( 1 - \lambda _{p} \right ) {\frac{\partial \eta}{\partial t}} = - {\frac{\partial q_{t}}{\partial x}} </math>
|width=50px align="right"|(1)
|}
::::{|
|width=500px|<math> \left ( 1 - \lambda _{p} \right ) \left ( {\frac{\partial \eta }{\partial t}} + \delta \right ) = - {\frac{I_{f}}{r_{B}}} \left ( 1 + \Lambda \right ) \Omega {\frac{\partial q_{t}}{\partial x}} </math>
|width=50px align="right"|(2)
|}
* Ratio of depositional to channel width
::::{|
|width=500px|<math> r_{B} = {\frac{B_{d}}{B_{c}}} </math>
|width=50px align="right"|(3)
|}
* The maximum possible length of the fluvial reach
::::{|
|width=500px|<math> L_{max} = {\frac{I_{f} \left ( 1 + \Lambda \right ) \Omega }{r_{B}}} {\frac{q_{tf}}{\left ( 1 - \lambda _{p} \right ) \delta}} </math>
|width=50px align="right"|(4)
|}
* Friction coefficient in Manning-Strickler formulation
::::{|
|width=500px|<math> C_{f} ^ \left ( {\frac{-1}{2}}\right ) = \alpha _{r} \left ( {\frac{H}{k_{c}}} \right ) ^ \left ( {\frac{1}{6}} \right ) </math>
|width=50px align="right"|(5)
|}
* Total bed material load per unit width
::::{|
|width=500px|<math> {\frac{q_{t}}{\sqrt{R g D}D}} = \alpha_{t} \left ( {\frac{\psi _{s} \tau _{b}}{\rho R g D}} - \tau _{c} ^* \right ) ^ \left ( n_{t} \right ) </math>
|width=50px align="right"|(6)
|}
 
<div class="NavFrame collapsed" style="text-align:left">
  <div class="NavHead">Nomenclature</div>
  <div class="NavContent">
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| X
| Streamwise coordinate
| m
|-
| ΔX
| Spatial step length
| m
|-
| t
| Temporal coordinate
| seconds
|-
| Q<sub>w</sub>
| Flood discharge
| m<sup>3</sup>/s
|-
| I<sub>f</sub>
| Flood intermittency
| -
|-
| B<sub>c</sub>
| Channel width
| m
|-
| D
| Characteristic grain size
| mm
|-
| λ<sub>p</sub>
| Bed porosity
| -
|-
| k<sub>c</sub>
| Composite roughness height
| mm
|-
| L
| Length of reach
| m
|-
| Δt
| Time step
| year
|-
| N<sub>toprint</sub>
| number of time steps to printout
| -
|-
| N<sub>print</sub>
| number of printouts
| -
|-
| M
| Number of spatial intervals
| -
|-
| a<sub>u</sub>
| Upwinding coefficient (1 = full upwind, 0.5 = central difference)
| -
|-
| α<sub>r</sub>
| Coefficient in Manning-Strickler
| -
|-
| α<sub>s</sub>
| Coefficient in sediment transport relation
| -
|-
| n<sub>t</sub>
| Exponent in sediment transport relation
| -
|-
| τ<sub>c</sub> <sub>*</sub>
| Reference Shields number in sediment transport relation
| -
|-
| φ<sub>s</sub>
| Fraction of bed shear stress due to skin friction
| -
|-
| R
| Submerged specific gravity
| -
|-
| Cz
| Non-dimensional Chézy friction coefficient
| -
|-
| σ
| subsidence rate
| -
|-
| r<sub>B</sub>
| channel width
| m
|-
| Λ
| wash load deposited per unit bed material load
| -
|-
| Ω
| channel sinuosity
| -
|-
| q<sub>t</sub>
| total sediment transport rate per unit channel width
| -
|-
| B<sub>d</sub>
| effective depositional width
| -
|-
| L<sub>max</sub>
| maximum possible length of the fluvial reach
| -
|-
| SI
| initial bed slope
| -
|-
| q<sub>t</sub> / q<sub>tf</sub>
| ratio between the sediment transport and feed rate of bed material
| -
|-
| ρ<sub>s</sub>
| density of the sediment
| kg / m<sup>3</sup>
|-
| ρ
| density of the water
| kg / m<sup>3</sup>
|-
| g
| acceleration of gravity
| m / s<sup>2</sup>
|-
| τ<sub>b</sub>
| total boundary shear stress
| -
|-
| n<sub>t</sub>
| specified parameter
| -
|-
|}
 
 
'''Output'''
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| η
| Bed surface elevation
| m
|-
| S
| Bed slope
| -
|-
| H
| Water depth
| m
|-
| τ<sub>b</sub>
| Total (skin friction + form drag) Shields number
| -
|-
| q<sub>t</sub>
| total bed material load
| m<sup>2</sup>/s
|-
| q<sub>tf</sub>
| sediment input rate of bed material load per unit channel width
| m<sup>2</sup> / s
|-
|}
  </div>
</div>


==Notes==
==Notes==
The program computes the approach to mobile-bed equilibrium in a river carrying uniform material and flowing into a subsiding basin. It is a descendant of AgDegNormal. Three relatively minor changes have been implemented as follows:
a) The input parameters have been modified to include the following parameters: subsidence rate σ, ratio of depositional width to channel width r<sub>B</sub>, ratio of wash load deposited per unit bed material load Λ and channel sinuosity Ω;
b) The code has been modified so as to include subsidence in the calculation of mass balance;
c) The output has been modified to show the time evolution of not only the profile of bed elevation η, but also the profiles of bed slope S and the ratio q<sub>t</sub>/q<sub>tf</sub>, where q<sub>tf</sub> denotes the volume feed rate of bed material load per unit width.
All sediment transport is assumed to occur in a specified fraction If of time during which the river is in flood. The volume bed material transport rate per unit width during floods is denoted as qt; the upstream feed value is denoted as q<sub>tf</sub>.
All sediment transport is assumed to occur in a specified fraction If of time during which the river is in flood. The volume bed material transport rate per unit width during floods is denoted as qt; the upstream feed value is denoted as q<sub>tf</sub>.


Line 68: Line 286:
Nprint = number of printouts in the calculation.
Nprint = number of printouts in the calculation.
The calculation assumes that the bed elevation at the downstream end of the domain is fixed.
The calculation assumes that the bed elevation at the downstream end of the domain is fixed.
* Note on model running
Flow is calculated assuming normal flow approximation
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 roughness height, k<sub>c</sub>, and the coefficient α<sub>r</sub> are given in the input text file. When all the three parameters are present, the program will ask the user which formulation they would like to use.
If the input channel length is longer than the maximum possible length of the fluvial reach, the program cannot perform the calculation.


==Examples==
==Examples==

Revision as of 19:20, 22 April 2011

The CSDMS Help System

AgDegNormalSub

This program is used to calculate the evolution of upward-concave bed profiles in rivers carrying uniform sediment in subsiding basins.

Model introduction

This module computes the time evolution of a river toward steady state as it flows into a subsiding basin. The subsidence rate s is assumed to be constant in time and space. The sediment is assumed to be uniform with size D. A Manning-Strickler formulation is used for bed resistance. A generic relation of the general form of that due to Meyer-Peter and Muller is used for sediment transport. The flow is computed using the normal flow approximation. The river is assumed to have a constant width.

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 for uniform sediment from a flume-like setting
[math]\displaystyle{ \left ( 1 - \lambda _{p} \right ) {\frac{\partial \eta}{\partial t}} = - {\frac{\partial q_{t}}{\partial x}} }[/math] (1)
[math]\displaystyle{ \left ( 1 - \lambda _{p} \right ) \left ( {\frac{\partial \eta }{\partial t}} + \delta \right ) = - {\frac{I_{f}}{r_{B}}} \left ( 1 + \Lambda \right ) \Omega {\frac{\partial q_{t}}{\partial x}} }[/math] (2)
  • Ratio of depositional to channel width
[math]\displaystyle{ r_{B} = {\frac{B_{d}}{B_{c}}} }[/math] (3)
  • The maximum possible length of the fluvial reach
[math]\displaystyle{ L_{max} = {\frac{I_{f} \left ( 1 + \Lambda \right ) \Omega }{r_{B}}} {\frac{q_{tf}}{\left ( 1 - \lambda _{p} \right ) \delta}} }[/math] (4)
  • Friction coefficient in Manning-Strickler formulation
[math]\displaystyle{ C_{f} ^ \left ( {\frac{-1}{2}}\right ) = \alpha _{r} \left ( {\frac{H}{k_{c}}} \right ) ^ \left ( {\frac{1}{6}} \right ) }[/math] (5)
  • Total bed material load per unit width
[math]\displaystyle{ {\frac{q_{t}}{\sqrt{R g D}D}} = \alpha_{t} \left ( {\frac{\psi _{s} \tau _{b}}{\rho R g D}} - \tau _{c} ^* \right ) ^ \left ( n_{t} \right ) }[/math] (6)

Notes

The program computes the approach to mobile-bed equilibrium in a river carrying uniform material and flowing into a subsiding basin. It is a descendant of AgDegNormal. Three relatively minor changes have been implemented as follows: a) The input parameters have been modified to include the following parameters: subsidence rate σ, ratio of depositional width to channel width rB, ratio of wash load deposited per unit bed material load Λ and channel sinuosity Ω; b) The code has been modified so as to include subsidence in the calculation of mass balance; c) The output has been modified to show the time evolution of not only the profile of bed elevation η, but also the profiles of bed slope S and the ratio qt/qtf, where qtf denotes the volume feed rate of bed material load per unit width.

All sediment transport is assumed to occur in a specified fraction If of time during which the river is in flood. The volume bed material transport rate per unit width during floods is denoted as qt; the upstream feed value is denoted as qtf.

Sediment is deposited not only on the channel as it aggrades, but across a wider depositional zone as the channel migrates and avulses in response to aggradation. It is assumed that for each unit of bed material load that deposits across the depositional zone, L units of wash load deposit; here L (>= 0)is a user-specified parameter.

Channel sinuosity, denoted as W (>= 1), and the ratio of channel width to depositional width, denoted as rB (>=1), are also user-specified. The initial condition is specified in terms of a constant initial bed slope SI.

In performing this calculation, the following parameters must be specified: L = reach length; 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. The calculation assumes that the bed elevation at the downstream end of the domain is fixed.

  • Note on model running

Flow is calculated assuming normal flow approximation

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 roughness height, kc, and the coefficient αr are given in the input text file. When all the three parameters are present, the program will ask the user which formulation they would like to use.

If the input channel length is longer than the maximum possible length of the fluvial reach, the program cannot perform the calculation.

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

Key papers

Links