runuph {viadam} | R Documentation |
Run-up height of an avalanche on a dam or an obstacle corresponding to both supercritical overflow and downstream thickness of a shock.
runuph(phih,u1,h1,psi,psip,alfa,k,kp,xi,hs)
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. |
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.
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).
Tomas Johannesson
obliquenshock
, mxphi
and vdamheight
.
## Not run: runuph(18*pi/180,45,2,11*pi/180,3*pi/180,35*pi/180,hs=3) ## End(Not run)