runuph                package:viadam                R Documentation

_R_u_n-_u_p _h_e_i_g_h_t _o_f _a_n _a_v_a_l_a_n_c_h_e _o_n _a _d_a_m _o_r _a_n _o_b_s_t_a_c_l_e.

_D_e_s_c_r_i_p_t_i_o_n:

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

_U_s_a_g_e:

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

_A_r_g_u_m_e_n_t_s:

    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.

_V_a_l_u_e:

     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.

_N_o_t_e:

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

_A_u_t_h_o_r(_s):

     Tomas Johannesson

_S_e_e _A_l_s_o:

     'obliquenshock', 'mxphi' and 'vdamheight'.

_E_x_a_m_p_l_e_s:

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

