Model help:BackwaterCalculator: 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 14: Line 14:
__NOTOC__
__NOTOC__
==<big><big>{{PAGENAME}}</big></big>==
==<big><big>{{PAGENAME}}</big></big>==
 
This program is used for backwater calculations in open channel flow.


==Model introduction==
==Model introduction==
<span class="remove_this_tag">Introduction to the module</span>
The program solves the backwater equation for subcritical flow with a predictor – corrector scheme.


<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;"
|-
!Parameter!!Description!!Unit
|-valign="top"
|width="20%"|Input directory
|width="60%"|path to input files
|width="20%"|
|-
|Site prefix
|Site prefix for Input/Output files
|
|-
|Case prefix
|Case prefix for Input/Output files
|
|-
|}
 
= Run Options =
{|{{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%"|Chezy or Manning, Chezy-1 or Manning-2
|width="60%"|<span class="remove_this_tag">Description parameter</span>
|width="60%"|
|width="20%"|<span class="remove_this_tag">[Units]</span>
|width="20%"| -
|-
|}
|}


= 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%"|D90 of the surface
|width="60%"|<span class="remove_this_tag">Description parameter</span>
|width="60%"|
|width="20%"|<span class="remove_this_tag">[Units]</span>
|width="20%"| mm
|-
|hydraulic radius
|
| m
|-
|Chezy coefficient
|
| -
|-
|initial depth
|
| mm
|-
|Mean diameter
|
| mm
|-
|alpha (r)
|
| -
|-
|roughness coefficient
|
|
|-
|starting point
|
| m
|-
|Slope
|
| m / m
|-
|water discharge
|
| m<sup>2</sup> / s
|-
|step size
|
| m
|-
|}
|}


= 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 124:


==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>
* Water depth calculation
::::{|
|width=500px|<math> {\frac{dH}{dx}} = {\frac{S - S_{f}}{1 - Fr^2}} </math>
|width=50px align="right"|(1)
|}
* Friction slope
::::{|
|width=500px|<math> S_{f} = C_{f} Fr^2 </math>
|width=50px align="right"|(2)
|}
* Froude number
::::{|
|width=500px|<math> Fr = {\frac{q_{w}}{\sqrt{g H^3}}} </math>
|width=50px align="right"|(3)
|}
* Non-dimensional friction coefficient
::::{|
|width=500px|<math> C_{f} = {\frac{1}{Cz^2}} </math>
|width=50px align="right"|(4)
|}
* Chezy equation
::::{|
|width=500px|<math> Cz = {\frac{K_{Cz}}{\sqrt{g}}} </math>
|width=50px align="right"|(5)
|}
* Manning-Strickler formulation
::::{|
|width=500px|<math> C_{f} ^ \left ( {\frac{-1}{2}} \right ) = \alpha _{r} \left ( {\frac{H}{k_{s}}} \right ) ^ \left ( {\frac{1}{6}} \right ) </math>
|width=50px align="right"|(6)
|}
* Roughness height due to skin friciton
::::{|
|width=500px|<math> k_{s} = n_{k} D_{90} </math>
|width=50px align="right"|(7)
|}
 
<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
| L
|-
| ΔX
| Spatial step length
| L
|-
| S
| bed slope
| -
|-
| S<sub>f</sub>
| friction slope
| -
|-
| Fr
| Froude number
| -
|-
| C<sub>f</sub>
| non-dimensional friction coefficient
| -
|-
| g
| acceleration of gravity
| L / T<sup>2</sup>
|-
| C<sub>z</sub>
| non-dimensional Chezy friction coefficient
| -
|-
| K<sub>cz</sub>
| dimensional Chezy friction coefficient
| -
|-
| α<sub>r</sub>
| user specified parameter
| -
|-
| k<sub>s</sub>
| roughness height due to skin friction
| L
|-
| n<sub>k</sub>
| non-dimensional order-one constant
| -
|-
| H<sub>1</sub>
| starting water depth at the downstream end of the channel
| L
|-
| x<sub>1</sub>
| starting position
| L
|-
| q<sub>w</sub>
| water discharge per unit width
| L<sup>2</sup> / T
|-
| D<sub>90</sub>
| diameter of the bed surface such that 90% of the distribution is finer
| L
|-
| C<sub>f</sub>
| Non-dimensional friction coefficient
| -
|-
|}
 
 
'''Output'''
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| H
| water depth
| L
|-
| U
| mean flow velocity
| L / T
|-
| η
| bed elevation
| L
|-
| H<sub>n</sub>
| water surface at normal flow
| L
|-
| H<sub>c</sub>
| critical water depth
| L
|-
| τ<sub>b</sub>
| shear stress
| -
|-
| Fr<sub>n</sub>
| Froude number at normal flow
| -
|-
| U<sub>n</sub>
| mean flow velocity at normal flow
| L / T
|-
| U<sub>c</sub>
| critical flow velocity
| L / T
|-
| τ<sub>bn</sub>
| bed shear stress at normal flow
| -
|-
| ξ
| water surface elevation
| L
|-
|}
  </div>
</div>  


==Notes==
==Notes==
<span class="remove_this_tag">Any notes, comments, you want to share with the user</span>  
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 α<sub>r</sub> and n<sub>k</sub> are given in the input file.  When all the three parameters are present, the program will ask the user which formulation they would like to use.
 
<span class="remove_this_tag">Numerical scheme</span>




Line 64: Line 297:


<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 70: Line 303:


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


==References==
==References==

Latest revision as of 17:19, 19 February 2018

The CSDMS Help System

BackwaterCalculator

This program is used for backwater calculations in open channel flow.

Model introduction

The program solves the backwater equation for subcritical flow with a predictor – corrector scheme.

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
Chezy or Manning, Chezy-1 or Manning-2 -
Parameter Description Unit
D90 of the surface mm
hydraulic radius m
Chezy coefficient -
initial depth mm
Mean diameter mm
alpha (r) -
roughness coefficient
starting point m
Slope m / m
water discharge m2 / s
step size m
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

  • Water depth calculation
[math]\displaystyle{ {\frac{dH}{dx}} = {\frac{S - S_{f}}{1 - Fr^2}} }[/math] (1)
  • Friction slope
[math]\displaystyle{ S_{f} = C_{f} Fr^2 }[/math] (2)
  • Froude number
[math]\displaystyle{ Fr = {\frac{q_{w}}{\sqrt{g H^3}}} }[/math] (3)
  • Non-dimensional friction coefficient
[math]\displaystyle{ C_{f} = {\frac{1}{Cz^2}} }[/math] (4)
  • Chezy equation
[math]\displaystyle{ Cz = {\frac{K_{Cz}}{\sqrt{g}}} }[/math] (5)
  • Manning-Strickler formulation
[math]\displaystyle{ C_{f} ^ \left ( {\frac{-1}{2}} \right ) = \alpha _{r} \left ( {\frac{H}{k_{s}}} \right ) ^ \left ( {\frac{1}{6}} \right ) }[/math] (6)
  • Roughness height due to skin friciton
[math]\displaystyle{ k_{s} = n_{k} D_{90} }[/math] (7)

Notes

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 input file. 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

Key papers

Links

Any link, eg. to the model questionnaire, etc.