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:...")
 
No edit summary
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==
The program solves the backwater equation for subcritical flow with a predictor – corrector scheme.


==Model introduction==
<span class="remove_this_tag">Introduction to the module</span>


<div id=CMT_MODEL_PARAMETERS>
==Model parameters==
==Model parameters==
= First tab header =
= First tab header =
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>
::::{|
|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
::::{|
|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
| m
|-
| ΔX
| Spatial step length
| m
|-
| S
| bed slope
| -
|-
| S<sub>f</sub>
| friction slope
| -
|-
| Fr
| Froude number
| -
|-
| C<sub>f</sub>
| non-dimensional friction coefficient
| -
|-
| g
| acceleration of gravity
| m / s<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
|
|-
| n<sub>k</sub>
| non-dimensional order-one constant
| -
|-
| D<sub>90</sub>
|
|
|-
| H<sub>1</sub>
| starting water depth at the downstream end of the channel
| -
|-
| x<sub>1</sub>
| starting position
| m
|-
| q<sub>w</sub>
| water discharge per unit width
| m<sup>2</sup> / s
|-
| D<sub>90</sub>
| diameter of the bed surface such that 90% of the distribution is finer
| mm
|-
|}
 
 
'''Output'''
{| {{Prettytable}} class="wikitable sortable"
!Symbol!!Description!!Unit
|-
| H
| depth
| m
|-
| U
| mean flow velocity
| m / s
|-
| η
| bed elevation
| m
|-
| H<sub>n</sub>
| water surface at normal flow
| m
|-
| H<sub>c</sub>
| critical water depth
| m
|-
| τ<sub>b</sub>
| shear stress
| -
|-
| Fr<sub>n</sub>
| Froude number at normal flow
| -
|-
| U<sub>n</sub>
| mean flow velocity at normal flow
| m / s
|-
| U<sub>c</sub>
| critical flow velocity
| m / s
|-
| τ<sub>bn</sub>
| bed shear stress at normal flow
| N / m<sup>2</sup>
|-
| ξ
| water surface elevation
| m
|-
|}
  </div>
</div>  


==Notes==
==Notes==
<span class="remove_this_tag">Any notes, comments, you want to share with the user</span>  
* Note on equations
To compute the water depth, H, everywhere in the channel for a given water discharge per unit channel width, q<sub>w</sub>, and downstream boundary condition, i.e. a user specified water depth.
 
The bed slope, S, is assumed constant in the streamwise direction, the friction slope, S<sub>f</sub>, and the Froude number, Fr, are defined as equation 2,3.


<span class="remove_this_tag">Numerical scheme</span>
* Note on model running
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.





Revision as of 20:13, 22 April 2011

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
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

[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
[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

  • Note on equations

To compute the water depth, H, everywhere in the channel for a given water discharge per unit channel width, qw, and downstream boundary condition, i.e. a user specified water depth.

The bed slope, S, is assumed constant in the streamwise direction, the friction slope, Sf, and the Froude number, Fr, are defined as equation 2,3.

  • Note on model running

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)

Name of the module developer(s)

References

Key papers

Links

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