runuph {viadam}R Documentation

Run-up height of an avalanche on a dam or an obstacle.

Description

Run-up height of an avalanche on a dam or an obstacle corresponding to both supercritical overflow and downstream thickness of a shock.

Usage

 
runuph(phih,u1,h1,psi,psip,alfa,k,kp,xi,hs)

Arguments

phih deflecting angle with respect to the direction of steepest decent in the map plane, that is the angle between the horizontal projections of the avalanche direction and the dam axis.
u1 upstream velocity in metres per second.
h1 upstream flow depth in metres.
psi the slope of the terrain.
psip the slope of the terrain in the direction normal to the dam.
alfa the angle of the dam side with respect to the sloping terrain in the direction normal to the dam axis in a plane normal to the upstream terrain.
k a dimensionless coefficient representing momentum loss normal to the dam axis in the impact, computed from alfa if not specified.
kp curvature of the dam axis for a deflecting dam, equal to one over the radius of curvature, set to zero if not specified.
xi distance along the dam from its upstream end or the upstream end of the impact with the avalanche, set to zero if not specified.
hs snow depth and thickness of previous avalanche deposits on the terrain, set to zero if not specified.

Value

The function returns a dataframe with variables/columns describing supercritical overflow and shock that may be formed by the upstream dam face. The variables of the returned dataframe are:

phi deflecting angle with respect to the direction of steepest decent in a sloping coordinate system aligned with the terrain.
Fr1 upstream Froude number.
u1n velocity normal to the dam axis.
Fr1n “Froude number” in the direction normal to the dam axis.
Hcr critical dam height.
hcr critical flow depth.
hrp supercritical run-up, i.e. Hcr + hcr.
teta shock angle.
delta shock widening, i.e. the angle subtended by the shock with respect to the dam.
h2 flow depth downstream of a shock.
u2 flow velocity downstream of a shock.
dHslp extra run-up due to slope towards the dam for a deflecting dam.
dHcrv extra run-up due to dam curvature for a deflecting dam.
hrmx maximum of supercritical run-up and flow depth downstream of a shock plus extra run-up due to slope towards the dam and dam curvature for a deflecting dam and plus snow depth on the terrain (in the sloping coordinate system aligned with the terrain).
hd vertical runup corresponding to hrmx.


The attribute par of the returned variable contains the arguments of the call to the function, also as a dataframe.

Note

In contrast to most of the other functions in the viadam library, this function accepts dimensional arguments (e.g. flow depth in metres and velocity in metres per second) and returns dimensional quantities (e.g. dam height in metres). Most of the other functions accept non-dimensional quantities such as Froude numbers and angles and return non-dimensional quantities such as the downstream flow depth h2 relative to the upstream flow depth h1.

The arguments k, kp, xi and hs are optional and have default values that are described above. They should be named ef they are specified (see example with hs specified in the Examples section).

Author(s)

Tomas Johannesson

See Also

obliquenshock, mxphi and vdamheight.

Examples

## Not run: 
runuph(18*pi/180,45,2,11*pi/180,3*pi/180,35*pi/180,hs=3)
## End(Not run)

[Package viadam version 1.0 Index]