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:...")
 
m (Text replacement - "http://csdms.colorado.edu/wiki/" to "https://csdms.colorado.edu/wiki/")
 
(11 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 17: Line 17:


==Model introduction==
==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.  
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.  


<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%"|Flood discharge
|width="60%"|<span class="remove_this_tag">Description parameter</span>
|width="60%"|
|width="20%"|<span class="remove_this_tag">[Units]</span>
|width="20%"| m<sup>3</sup> / s
|-
|Intermittency
|
| -
|-
|Grain size of bed material
|
| mm
|-
|I
|
| -
|-
|Manning-Strickler coefficient, k
|
| -
|-
|Slope of forest face
|
| -
|-
|upstream bed material sediment feed rate during floods
|
| m<sup>2</sup> / s
|-
|L
|
| -
|-
|Time step
|
| days
|-
|Iterations per each printout
|
|
|-
|Number of printout
|
| m
|-
|Number of fluvial nodes
|
|
|-
|u
|
|
|-
|Manning-Strickler coefficient, r
|
|
|-
|Coefficient in total bed material relation
|
|
|-
|Exponent in load relation
|
|
|-
|Critical Shield stress
|
|
|-
|p
|
|
|-
|Submerged specific gravity of sediment
|
|
|-
|initial length of fluvial zone
|
| m
|-
|B
|
| -
|-
|O
|
| -
|-
|Y
|
| -
|-
|}
|}


= 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 52: Line 162:


==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 river
::::{|
|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"|(1)
|}
* Ratio of depositional to channel width
::::{|
|width=500px|<math> r_{B} = {\frac{B_{d}}{B_{c}}} </math>
|width=50px align="right"|(2)
|}
* 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"|(3)
|}
 
<div class="NavFrame collapsed" style="text-align:left">
  <div class="NavHead">Nomenclature</div>
  <div class="NavContent">
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| Q
| flood discharge
| L <sup>3</sup> / T
|-
| x
| streamwise coordinate
| L
|-
| η
| river bed elevation
| L
|-
| t
| time step
| T
|-
| B<sub>c</sub>
| Channel width
| L
|-
| D
| grain size of the bed sediment
| L
|-
| σ
| subsidence rate
| -
|-
| r<sub>B</sub>
| the ratio of depositional width to channel width
| -
|-
| Ω
| channel sinuosity
| -
|-
| Λ
| units of wash load deposited in the system per unit of bed material load
| -
|-
| λ<sub>p</sub>
| bed porosity
| -
|-
| q<sub>w</sub>
| water discharge per unit width
| L<sup>2</sup> / T
|-
| k<sub>c</sub>
| composite roughness height
| L
|-
| G
| imposed annual sediment transfer rate from upstream
| M / T
|-
| G<sub>tf</sub>
| upstream sediment feed rate
| -
|-
| ξ<sub>d</sub>
| downstream water surface elevation
| L
|-
| L
| length of reach under consideration
| L
|-
| i
| number of time steps per printout
| -
|-
| p
| number of printouts desired
| -
|-
| M
| number of spatial intervals
| -
|-
| R
| submerged specific gravity of sediment
| -
|-
| S<sub>f</sub>
| friction slope
| -
|-
| F<sub>r</sub>
| Froude number
| -
|-
| U
| flow velocity
| L / T
|-
| g
| acceleration of gravity
| L / T<sup>2</sup>
|-
| α<sub>r</sub>
| coefficient in Manning-Stricker, dimensionless coefficient between 8 and 9
| -
|-
| k<sub>s</sub>
| grain roughness
| L
|- 
| n<sub>k</sub>
| dimensionless coefficient typically between 2 and 5
| -
|- 
| τ<sup>*</sup>
| Shield number
| -
|-
| ρ
| fluid density
| M / L<sup>3</sup>
|-
| ρ<sub>s</sub>
| sediment density
| M / L<sup>3</sup>
|-
| τ<sub>c</sub>
| critical Shields number for the onset of sediment motion
| -
|-
| ψ<sub>s</sub>
| the fraction of bed shear stress
| -
|-
| q<sub>t</sub> <sup>*</sup>
| Einstein number
| -
|-
| I<sub>f</sub>
| flood intermittency
| -
|-
| t<sub>f</sub>
| cumulative time the river has been in flood
| T
|-
| G<sub>t</sub>
| the annual sediment yield
| M / T
|-
| t<sub>a</sub>
| the number of seconds in a year
| -
|-
| Q<sub>f</sub>
| sediment transport rate during flood discharge
| L<sup>2</sup> / T
|-
| α<sub>t</sub>
| dimensionless coefficient in the sediment transport equation, equals to 8
| -
|-
| n<sub>t</sub>
| exponent in sediment transport relation, equals to 1.5
| -
|-
| τ<sub>c</sub> <sup>*</sup>
| reference Shields number in sediment transport relation, equals to 0.047
|-
| C<sub>f</sub>
| bed friction coefficient, equals to τ<sub>b</sub> / (ρ U<sup>2</sup> )
| -
|-
| C<sub>Z</sub>
| dimensionless Chezy resistance coefficient.
| -
|-
| S<sub>l</sub>
| initial bed slope of the river
| -
|-
| η<sub>i</sub>
| initial bed elevation
| L
|-
| τ
| shear stress on bed surface
| -
|-
| q<sub>b</sub>
| bed material load
| M / T
|-
| Δx
| spatial step length, equals to L / M
| L
|-
| Q<sub>w</sub>
| flood discharge
| L<sup>3</sup> / T
|-
| Δt
| time step
| T
|-
| 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>s</sub>
| coefficient in sediment transport relation
| -
|-
| B<sub>d</sub>
| deposition width
| -
|-
| q<sub>tf</sub>
| volume feed rate per unit width of total bed material load
| L<sup>2</sup> / T
|-
|}
 
'''Output'''
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| H
| water depth
| L
|-
| ξ
| water surface elevation
| L
|-
| L<sub>max</sub>
| maximum length of basin the the sediment supply can fill
| L
|-
| τ<sub>b</sub>
| bed shear stress
| M / (T<sup>2</sup> L)
|-
| S
| bed slope
| -
|-
| q<sub>t</sub>
| total bed material load
| L<sup>2</sup> / T
|-
|}
 
  </div>
</div>


==Notes==
==Notes==
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>.
some assumptions:
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.
 
 
The program 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.
 
The ratio of depositional to channel width, r<sub>B</sub>, has been introduced to model the fact that in an aggrading river sediment deposits not only in the channel itself, but also in a much wider belt (e.g. the floodplain or basin width, due to overbank deposition, channel migration and avulsion). Here channel width is denoted as B<sub>c</sub> (which can be taken to be synonymous with bankfull width) and effective depositional width is denoted as B<sub>d</sub>
 
The parameter Λ that represents the units of wash load deposited per unit of bed material is introduced to consider that in the 1D formulation implemented in this model it is assumed that deposition occurs not only in the channel but on a much wider area (e.g. the floodplain).  Sediment deposited in the channel is mostly made of bed material but sediment deposited around the channel contains a significant amount of wash load.  A precise mass balance for wash load is beyond the scope of this model.  For simplicity it is assumed that for every unit of sand deposited in the system, Λ units of wash load are deposited.  It is also assumed that the supply of wash load from upstream is always sufficient for deposition at such a rate.  This is not likely to be strictly true, but should serve as a useful starting assumption.
 
The parameter Ω has been introduced to consider that channels may be sinuous. Here it is assumed that the channel has a sinuosity, Ω, but that the depositional surface across which it wanders is rectangular. In the present formulation the sinuosity is defined as the ratio of downchannel distance per unit of downvalley distance.


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.
Boundary and initial conditions are equal to that implemented for the ancestor model AgDegNormal.  


Channel sinuosity, denoted as W (>= 1), and the ratio of channel width to depositional width, denoted as r<sub>B</sub> (>=1), are also user-specified. The initial condition is specified in terms of a constant initial bed slope S<sub>I</sub>.
* Note on model running
Flow is calculated assuming normal flow approximation


In performing this calculation, the following parameters must be specified:
If the input channel length is longer than the maximum possible length of the fluvial reach, the program cannot perform the calculation. The maximum possible length of the fluvial reach, Lmax, is defined as the maximum length of basin that the sediment supply can fill; at this length the sediment transport rate out of the basin drops precisely to zero.  
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.


==Examples==
==Examples==
Line 73: Line 478:


<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 85: Line 490:


==Links==
==Links==
* [[http://csdms.colorado.edu/wiki/Model:AgDegNormalSub Model:AgDegNormalSub]]
* [[Model:AgDegNormalSub]]
* [[Model_help:AgDegNormal]]


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

Latest revision as of 17:16, 19 February 2018

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

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.

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
Flood discharge m3 / s
Intermittency -
Grain size of bed material mm
I -
Manning-Strickler coefficient, k -
Slope of forest face -
upstream bed material sediment feed rate during floods m2 / s
L -
Time step days
Iterations per each printout
Number of printout m
Number of fluvial nodes
u
Manning-Strickler coefficient, r
Coefficient in total bed material relation
Exponent in load relation
Critical Shield stress
p
Submerged specific gravity of sediment
initial length of fluvial zone m
B -
O -
Y -
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

  • Exner equation for uniform sediment from a river
[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] (1)
  • Ratio of depositional to channel width
[math]\displaystyle{ r_{B} = {\frac{B_{d}}{B_{c}}} }[/math] (2)
  • 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] (3)

Notes

some assumptions: 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.


The program 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.

The ratio of depositional to channel width, rB, has been introduced to model the fact that in an aggrading river sediment deposits not only in the channel itself, but also in a much wider belt (e.g. the floodplain or basin width, due to overbank deposition, channel migration and avulsion). Here channel width is denoted as Bc (which can be taken to be synonymous with bankfull width) and effective depositional width is denoted as Bd.

The parameter Λ that represents the units of wash load deposited per unit of bed material is introduced to consider that in the 1D formulation implemented in this model it is assumed that deposition occurs not only in the channel but on a much wider area (e.g. the floodplain). Sediment deposited in the channel is mostly made of bed material but sediment deposited around the channel contains a significant amount of wash load. A precise mass balance for wash load is beyond the scope of this model. For simplicity it is assumed that for every unit of sand deposited in the system, Λ units of wash load are deposited. It is also assumed that the supply of wash load from upstream is always sufficient for deposition at such a rate. This is not likely to be strictly true, but should serve as a useful starting assumption.

The parameter Ω has been introduced to consider that channels may be sinuous. Here it is assumed that the channel has a sinuosity, Ω, but that the depositional surface across which it wanders is rectangular. In the present formulation the sinuosity is defined as the ratio of downchannel distance per unit of downvalley distance.

Boundary and initial conditions are equal to that implemented for the ancestor model AgDegNormal.

  • Note on model running

Flow is calculated assuming normal flow approximation

If the input channel length is longer than the maximum possible length of the fluvial reach, the program cannot perform the calculation. The maximum possible length of the fluvial reach, Lmax, is defined as the maximum length of basin that the sediment supply can fill; at this length the sediment transport rate out of the basin drops precisely to zero.

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