Model help:AgDegNormalFault: 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/")
 
(15 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 program computes 1D bed variation in rivers due to differential sediment transport in which it is possible to allow the bed to undergo a sudden vertical fault of a specified amount, at a specified place and time. Faulting is realized by moving all notes downstream of the specified point downward by the amount of the faulting.
This program computes 1D bed variation in rivers due to differential sediment transport in which it is possible to allow the bed to undergo a sudden vertical fault of a specified amount, at a specified place and time. Faulting is realized by moving all notes downstream of the specified point downward by the amount of the faulting. It uses the same principles of AgDegNormal model but with extension for calculation of the response to a sudden fault along the reach.
 
The sediment is assumed to be uniform with size D. All sediment transport is assumed to occur in a specified fraction of time during which the river is in flood, specified by an intermittency. 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.  


<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
|
| -
|-
|Channel Width
|
| m
|-
|Grain size
|
| mm
|-
|Bed Porosity
|
| -
|-
|Roughness height
|
| mm
|-
|Ambient Bed Slope
|
|
|-
|Imposed Annual Sediment Transfer Rate from Upstream
|
| tons / annum
|-
|Length of reach
|
| m
|-
|Time step
|
| year
|-
|Number of Time Steps per Printout
|
|
|-
|Number of printout
|
|
|-
|intervals
|
|
|-
|Upwinding coefficient (1 = full upwind, 0.5 = central difference)
|
|
|-
|Coefficient in Manning-Strickler Resistance Relation
|
|
|-
|Coefficient in Sediment Transport Relation
|
|
|-
|Exponent in Sediment Transport Relation
|
|
|-
|Critical Shield stress
|
|
|-
|Fraction of bed shear stress that is skin friction
|
|
|-
|Submerged specific gravity of sediment
|
|
|-
|Height of faulting
|
| m
|-
|Fraction of reach length such that all points downstream undergo downward faulting
|
| -
|-
|Time from beginning of calculation at which faulting occurs
|
| yrs
|-
|}
|}


= 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 54: 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>
Use the same equations as AgDegNormal model
 
<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
|-
| t
| time step
| T
|-
| B
| river width
| L
|-
| D
| grain size of the bed sediment
| L
|-
| λ<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
|-
| C<sub>f</sub>
| bed friction coefficient
| -
|-
| 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
| -
|-
| q<sub>t</sub>
| volume sediment transport rate per unit width
| L<sup>2</sup> / T
|-
| 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>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
| -
|-
| u<sub>*</sub>
| shear velocity
| L / T
|-
| α<sub>r</sub>
| coefficient in Manning-Strickler resistance relation
| -
|-
| τ<sub>b</sub> <sup>*</sup>
| non-dimensional total shear stress
| -
|-
| r<sub>f</sub>
| the fraction of reach length such that all point downstream of x = r<sub>f</sub>L undergo downward faulting
| -
|-
| Δη
| the height of faulting
| L
|-
|}


'''Output'''
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| η
| bed surface elevatioon
| L
|-
| H
| water depth
| L
|-
| ξ
| water surface elevation
| L
|-
| τ<sub>b</sub>
| bed shear stress
| M / (T<sup>2</sup> L)
|-
| S
| bed slope
| -
|-
|}
  </div>
</div>
==Notes==
==Notes==
<span class="remove_this_tag">Any notes, comments, you want to share with the user</span>
The sediment is assumed to be uniform with size D. All sediment transport is assumed to occur in a specified fraction of time during which the river is in flood, specified by an intermittency. 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.
 
<span class="remove_this_tag">Numerical scheme</span>


If the channel slope is negative and the water depth is not a number, “nan”, check the time step and the spatial step length. In particular, the time step may be too large or equivalently the spatial step length may be too small. Change these values and run the model again.


==Examples==
==Examples==
Line 66: Line 426:


<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 72: Line 432:


==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>
* Paola, C., Heller, P. L. & Angevine, C. L.  1992  The large-scale dynamics of grain-size variation in alluvial basins.  I: Theory.  Basin Research, 4, 73-90.
 
* Meyer-Peter, E., and Müller, R.  1948  Formulas for bed-load transport. Proceedings, 2nd Congress International Association for Hydraulic Research, Rotterdam, the Netherlands, 39-64.


==Links==
==Links==
<span class="remove_this_tag">Any link, eg. to the model questionnaire, etc.</span>
* [[Model:AgDegNormalFault]]
* [[Model_help:AgDegNormal]]


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

Latest revision as of 17:17, 19 February 2018

The CSDMS Help System

AgDegNormalFault

This is used to calculate aggradation and degradation of a river reach using the normal flow approximation; with an extension for calculation of the response to a sudden fault along the reach.

Model introduction

This program computes 1D bed variation in rivers due to differential sediment transport in which it is possible to allow the bed to undergo a sudden vertical fault of a specified amount, at a specified place and time. Faulting is realized by moving all notes downstream of the specified point downward by the amount of the faulting. It uses the same principles of AgDegNormal model but with extension for calculation of the response to a sudden fault along the reach.

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 -
Channel Width m
Grain size mm
Bed Porosity -
Roughness height mm
Ambient Bed Slope
Imposed Annual Sediment Transfer Rate from Upstream tons / annum
Length of reach m
Time step year
Number of Time Steps per Printout
Number of printout
intervals
Upwinding coefficient (1 = full upwind, 0.5 = central difference)
Coefficient in Manning-Strickler Resistance Relation
Coefficient in Sediment Transport Relation
Exponent in Sediment Transport Relation
Critical Shield stress
Fraction of bed shear stress that is skin friction
Submerged specific gravity of sediment
Height of faulting m
Fraction of reach length such that all points downstream undergo downward faulting -
Time from beginning of calculation at which faulting occurs yrs
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

Use the same equations as AgDegNormal model

Notes

The sediment is assumed to be uniform with size D. All sediment transport is assumed to occur in a specified fraction of time during which the river is in flood, specified by an intermittency. 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.

If the channel slope is negative and the water depth is not a number, “nan”, check the time step and the spatial step length. In particular, the time step may be too large or equivalently the spatial step length may be too small. Change these values and run the model again.

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

  • Paola, C., Heller, P. L. & Angevine, C. L. 1992 The large-scale dynamics of grain-size variation in alluvial basins. I: Theory. Basin Research, 4, 73-90.
  • Meyer-Peter, E., and Müller, R. 1948 Formulas for bed-load transport. Proceedings, 2nd Congress International Association for Hydraulic Research, Rotterdam, the Netherlands, 39-64.

Links

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