CCPP SciDoc for UFS-SRW v3.0.0  SRW v3.0.0
Common Community Physics Package Developed at DTC

◆ gwdps_run()

subroutine gwdps::gwdps_run ( integer, intent(in)  IM,
integer, intent(in)  KM,
real(kind=kind_phys), dimension(:,:), intent(inout)  A,
real(kind=kind_phys), dimension(:,:), intent(inout)  B,
real(kind=kind_phys), dimension(:,:), intent(inout)  C,
real(kind=kind_phys), dimension(:,:), intent(in)  U1,
real(kind=kind_phys), dimension(:,:), intent(in)  V1,
real(kind=kind_phys), dimension(:,:), intent(in)  T1,
real(kind=kind_phys), dimension(:,:), intent(in)  Q1,
integer, dimension(:), intent(in)  KPBL,
real(kind=kind_phys), dimension(:,:), intent(in)  PRSI,
real(kind=kind_phys), dimension(:,:), intent(in)  DEL,
real(kind=kind_phys), dimension(:,:), intent(in)  PRSL,
real(kind=kind_phys), dimension(:,:), intent(in)  PRSLK,
real(kind=kind_phys), dimension(:,:), intent(in)  PHII,
real(kind=kind_phys), dimension(:,:), intent(in)  PHIL,
real(kind=kind_phys), intent(in)  DELTIM,
integer, intent(in)  KDT,
real(kind=kind_phys), dimension(:), intent(in)  HPRIME,
real(kind=kind_phys), dimension(:), intent(in)  OC,
real(kind=kind_phys), dimension(:,:), intent(in)  OA4,
real(kind=kind_phys), dimension(:,:), intent(in)  CLX4,
real(kind=kind_phys), dimension(:), intent(in)  THETA,
real(kind=kind_phys), dimension(:), intent(in)  SIGMA,
real(kind=kind_phys), dimension(:), intent(in)  GAMMA,
real(kind=kind_phys), dimension(:), intent(inout)  ELVMAX,
real(kind=kind_phys), dimension(:), intent(inout)  DUSFC,
real(kind=kind_phys), dimension(:), intent(inout)  DVSFC,
real(kind=kind_phys), dimension(:,:), intent(inout)  dtaux2d_ms,
real(kind=kind_phys), dimension(:,:), intent(inout)  dtauy2d_ms,
real(kind=kind_phys), dimension(:,:), intent(inout)  dtaux2d_bl,
real(kind=kind_phys), dimension(:,:), intent(inout)  dtauy2d_bl,
real(kind=kind_phys), dimension(:), intent(inout)  dusfc_ms,
real(kind=kind_phys), dimension(:), intent(inout)  dvsfc_ms,
real(kind=kind_phys), dimension(:), intent(inout)  dusfc_bl,
real(kind=kind_phys), dimension(:), intent(inout)  dvsfc_bl,
real(kind=kind_phys), intent(in)  G,
real(kind=kind_phys), intent(in)  CP,
real(kind=kind_phys), intent(in)  RD,
real(kind=kind_phys), intent(in)  RV,
integer, intent(in)  IMX,
integer, intent(in)  nmtvr,
real(kind=kind_phys), dimension(:), intent(in)  cdmbgwd,
integer, intent(in)  me,
logical, intent(in)  lprnt,
integer, intent(in)  ipr,
real(kind=kind_phys), dimension(:), intent(inout)  rdxzb,
logical, intent(in)  ldiag_ugwp,
character(len=*), intent(out)  errmsg,
integer, intent(out)  errflg 
)

— Subgrid Mountain Blocking Section

  • Compute Brunt-Vaisala Frequency \(N\).
  • Find the dividing streamline height starting from the level above the maximum mountain height and processing downward.
  • Compute wind speed UDS

    \[ UDS=\max(\sqrt{U1^2+V1^2},minwnd) \]

    where \( minwnd=0.1 \), \(U1\) and \(V1\) are zonal and meridional wind components of model layer wind.
  • The dividing streamline height (idxzb), of a subgrid scale obstable, is found by comparing the potential (PE) and kinetic energies (EK) of the upstream large scale wind and subgrid scale air parcel movements. the dividing streamline is found when \(PE\geq EK\). Mountain-blocked flow is defined to exist between the surface and the dividing streamline height ( \(h_d\)), which can be found by solving an integral equation for \(h_d\):

    \[ \frac{U^{2}(h_{d})}{2}=\int_{h_{d}}^{H} N^{2}(z)(H-z)dz \]

    where \(H\) is the maximum subgrid scale elevation within the grid box of actual orography, \(h\), obtained from the GTOPO30 dataset from the U.S. Geological Survey.
  • Calculate \(ZLEN\), which sums up a number of contributions of elliptic obstables.

    \[ ZLEN=\sqrt{[\frac{h_{d}-z}{z+h'}]} \]

    where \(z\) is the height, \(h'\) is the orographic standard deviation (HPRIME).
  • Calculate the drag coefficient to vary with the aspect ratio of the obstable as seen by the incident flow (see eq.14 in Lott and Miller (1997) [127])

    \[ R=\frac{\cos^{2}\psi+\gamma\sin^{2}\psi}{\gamma\cos^{2}\psi+\sin^{2}\psi} \]

    where \(\psi\), which is derived from THETA, is the angle between the incident flow direction and the normal ridge direcion. \(\gamma\) is the orographic anisotropy (GAMMA).
  • In each model layer below the dividing streamlines, a drag from the blocked flow is exerted by the obstacle on the large scale flow. The drag per unit area and per unit height is written (eq.15 in Lott and Miller (1997) [127]):

    \[ D_{b}(z)=-C_{d}\max(2-\frac{1}{R},0)\rho\frac{\sigma}{2h'}ZLEN\max(\cos\psi,\gamma\sin\psi)\frac{UDS}{2} \]

    where \(C_{d}\) is a specified constant, \(\sigma\) is the orographic slope.
  1. Orographic Gravity Wave Drag Section
  • Calculate the reference level index: kref=max(2,KPBL+1). where KPBL is the index for the PBL top layer.
  • Calculate low-level horizontal wind direction, the derived orographic asymmetry parameter (OA), and the derived Lx (CLX).
  • Calculate enhancement factor (E),number of mountans (m') and aspect ratio constant.
    As in eq.(4.9),(4.10),(4.11) in Kim and Arakawa (1995) [108], we define m' and E in such a way that they depend on the geometry and location of the subgrid-scale orography through OA and the nonlinearity of flow above the orography through Fr. OC, which is the orographic convexity, and statistically determine how protruded (sharp) the subgrid-scale orography is, is included in the saturation flux G' in such a way that G' is proportional to OC. The forms of E,m' and G' are:

    \[ E(OA,F_{r_{0}})=(OA+2)^{\delta} \]

    \[ \delta=C_{E}F_{r_{0}}/F_{r_{c}} \]

    \[ m'(OA,CLX)=C_{m}\triangle x(1+CLX)^{OA+1} \]

    \[ G'(OC,F_{r_{0}})=\frac{F_{r_{0}}^2}{F_{r_{0}}^2+a^{2}} \]

    \[ a^{2}=C_{G}OC^{-1} \]

    where \(F_{r_{c}}(=1)\) is the critical Froude number, \(F_{r_{0}}\) is the Froude number. \(C_{E}\), \(C_{m}\), \(C_{G}\) are constants.
  • Calculate the reference-level drag \(\tau_{0}\) (eq.(4.8) in Kim and Arakawa (1995) [108]):

    \[ \tau_0=E\frac{m'}{\triangle x}\frac{\rho_{0}U_0^3}{N_{0}}G' \]

    where \(E\), \(m'\), and \(G'\) are the enhancement factor, "the number of mountains", and the flux function defined above, respectively.
  • Compute the drag above the reference level ( \(k\geq kref\)):
    • Calculate the ratio of the Scorer parameter ( \(R_{scor}\)).
      From a series of experiments, Kim and Arakawa (1995) [108] found that the magnitude of drag divergence tends to be underestimated by the revised scheme in low-level downstream regions with wave breaking. Therefore, at low levels when OA > 0 (i.e., in the "downstream" region) the saturation hypothesis is replaced by the following formula based on the ratio of the the Scorer parameter:

      \[ R_{scor}=\min \left[\frac{\tau_i}{\tau_{i+1}},1\right] \]

  • The drag above the reference level is expressed as:

    \[ \tau=\frac{m'}{\triangle x}\rho NUh_d^2 \]

    where \(h_{d}\) is the displacement wave amplitude. In the absence of wave breaking, the displacement amplitude for the \(i^{th}\) layer can be expressed using the drag for the layer immediately below. Thus, assuming \(\tau_i=\tau_{i+1}\), we can get:

    \[ h_{d_i}^2=\frac{\triangle x}{m'}\frac{\tau_{i+1}}{\rho_{i}N_{i}U_{i}} \]

  • The minimum Richardson number ( \(Ri_{m}\)) or local wave-modified Richardson number, which determines the onset of wave breaking, is expressed in terms of \(R_{i}\) and \(F_{r_{d}}=Nh_{d}/U\):

    \[ Ri_{m}=\frac{Ri(1-Fr_{d})}{(1+\sqrt{Ri}\cdot Fr_{d})^{2}} \]

    see eq.(4.6) in Kim and Arakawa (1995) [108].
  • Check stability to employ the 'saturation hypothesis' of Lindzen (1981) [123] except at tropospheric downstream regions.
    Wave breaking occurs when \(Ri_{m}<Ri_{c}=0.25\). Then Lindzen's wave saturation hypothesis resets the displacement amplitude \(h_{d}\) to that corresponding to \(Ri_{m}=0.25\), we obtain the critical \(h_{d}\)(or \(h_{c}\)) expressed in terms of the mean values of \(U\), \(N\), and \(Ri\) ( eq.(4.7) in Kim and Arakawa (1995) [108]):

    \[ h_{c}=\frac{U}{N}\left\{2(2+\frac{1}{\sqrt{Ri}})^{1/2}-(2+\frac{1}{\sqrt{Ri}})\right\} \]

    if \(Ri_{m}\leq Ri_{c}\), obtain \(\tau\) from the drag above the reference level by using \(h_{c}\) computed above; otherwise \(\tau\) is unchanged (note: scaled by the ratio of the Scorer paramter).
  • Calculate outputs: A, B, DUSFC, DVSFC (see parameter description).
    • Below the dividing streamline height (k < idxzb), mountain blocking( \(D_{b}\)) is applied.
    • Otherwise (k>= idxzb), orographic GWD ( \(\tau\)) is applied.

Referenced by cires_ugwp::cires_ugwp_run(), and unified_ugwp::unified_ugwp_run().

Here is the caller graph for this function: