ugwpv1_gsldrag Module Reference

This module introduces two gravity wave drag schemes: UGWPv1 and orographic drag scheme. More...

Functions/Subroutines
subroutine, public	ugwpv1_gsldrag_init (me, master, nlunit, input_nml_file, logunit, fn_nml2, jdat, lonr, latr, levs, ak, bk, dtp, con_pi, con_rerth, con_p0, con_g, con_omega, con_cp, con_rd, con_rv, con_fvirt, do_ugwp, do_ugwp_v0, do_ugwp_v0_orog_only, do_gsl_drag_ls_bl, do_gsl_drag_ss, do_gsl_drag_tofd, do_ugwp_v1, do_ugwp_v1_orog_only, do_ugwp_v1_w_gsldrag, errmsg, errflg)
	The subroutine initializes the unified UGWP.
subroutine, public	ugwpv1_gsldrag_finalize (errmsg, errflg)
	The subroutine finalizes the CIRES UGWP.
subroutine, public	ugwpv1_gsldrag_run (me, master, im, levs, ak, bk, ntrac, lonr, dtp, fhzero, kdt, ldiag3d, lssav, flag_for_gwd_generic_tend, do_gsl_drag_ls_bl, do_gsl_drag_ss, do_gsl_drag_tofd, do_gwd_opt_psl, psl_gwd_dx_factor, do_ugwp_v1, do_ugwp_v1_orog_only, do_ugwp_v1_w_gsldrag, gwd_opt, do_tofd, ldiag_ugwp, ugwp_seq_update, cdmbgwd, alpha_fd, jdat, nmtvr, hprime, oc, theta, sigma, gamma, elvmax, clx, oa4, varss, oc1ss, oa4ss, ol4ss, dx, xlat, xlat_d, sinlat, coslat, area, rain, br1, hpbl, vtype, kpbl, slmsk, ugrs, vgrs, tgrs, q1, prsi, prsl, prslk, phii, phil, del, tau_amf, dudt_ogw, dvdt_ogw, du_ogwcol, dv_ogwcol, dudt_obl, dvdt_obl, du_oblcol, dv_oblcol, dudt_oss, dvdt_oss, du_osscol, dv_osscol, dudt_ofd, dvdt_ofd, du_ofdcol, dv_ofdcol, dudt_ngw, dvdt_ngw, dtdt_ngw, kdis_ngw, dudt_gw, dvdt_gw, dtdt_gw, kdis_gw, tau_ogw, tau_ngw, tau_oss, zogw, zlwb, zobl, zngw, dusfcg, dvsfcg, dudt, dvdt, dtdt, rdxzb, dtend, dtidx, index_of_x_wind, index_of_y_wind, index_of_temperature, index_of_process_orographic_gwd, index_of_process_nonorographic_gwd, lprnt, ipr, spp_wts_gwd, spp_gwd, errmsg, errflg)

Variables
logical	is_initialized = .False.

Detailed Description

 1) The "V1 CIRES UGWP" scheme as tested in the FV3GFSv16-127L atmosphere model and workflow, which includes:
       a) the orograhic gravity wave drag, flow blocking scheme and TOFD (Beljaars et al, 2004).
       b) the v1 CIRE ugwp non-stationary GW scheme, new revision that generate realistic climate of FV3GFS-127L
          in the strato-mesosphere in the multi-year simulations (Annual cycles, SAO and QBO in th tropical dynamics).
 2) The GSL orographic drag suite (drag_suite.F90), as implmeneted in the RAP/HRRR, which includes:
       a) large-scale gravity wave drag and low-level flow blocking -- active at horizontal scales
          down to ~5km (Kim and Arakawa, 1995 \cite kim_and_arakawa_1995; Kim and Doyle, 2005 \cite kim_and_doyle_2005)
       b) small-scale gravity wave drag scheme -- active typically in stable PBL at horizontal grid resolutions down to ~1km
          (Steeneveld et al, 2008 \cite steeneveld_et_al_2008; Tsiringakis et al, 2017 \cite tsiringakis_et_al_2017)
       c) turbulent orographic form drag -- active at horizontal grid ersolutions down to ~1km
          (Beljaars et al, 2004 \cite beljaars_et_al_2004)

See Valery Yudin's presentation at 2020 UFS User's meeting (Jul 2020): Gravity waves (GWs): Mesoscale GWs transport momentum, energy (heat) , and create eddy mixing in the whole atmosphere domain; Breaking and dissipating GWs deposit: (a) momentum; (b) heat (energy); and create (c) turbulent mixing of momentum, heat, and tracers To properly incorporate GW effects (a-c) unresolved by DYCOREs we need GW physics "Unified": a) all GW effects due to both dissipation/breaking; b) identical GW solvers for all GW sources; c) ability to replace solvers. Unified Formalism:

1. GW Sources: Stochastic and physics based mechanisms for GW-excitations in the lower atmosphere, calibrated by the high-res analyses/forecasts, and observations (3 types of GW sources: orography, convection, fronts/jets).
2. GW Propagation: Unified solver for "propagation, dissipation and breaking" excited from all type of GW sources.
3. GW Effects: Unified representation of GW impacts on the "resolved" flow for all sources (energy-balanced schemes for momentum, heat and mixing). https://www.weather.gov/media/sti/nggps/Presentations%202017/02%20NGGPS_VYUDIN_2017_.pdf

The ugwpv1_gsldrag scheme is activated by gwd_opt = 2 in the namelist. The choice of schemes is activated at runtime by the following namelist options (boolean): NA do_ugwp_v0 – activates V0 CIRES UGWP scheme - both orographic and non-stationary GWD is not active (NA) NA do_ugwp_v0_orog_only – activates V0 CIRES UGWP scheme - orographic GWD only do_gsl_drag_ls_bl – activates RAP/HRRR (GSL) large-scale OGWD and blocking do_gsl_drag_ss – activates RAP/HRRR (GSL) small-scale OGWD do_gsl_drag_tofd – activates RAP/HRRR (GSL) turbulent orographic drag do_ugwp_v1 – activates V1 CIRES UGWP scheme - both orographic and non-stationary GWD do_ugwp_v1_orog_only – activates V1 CIRES UGWP scheme - orographic GWD only do_ugwp_v1_w_gsldrag – activates V1 CIRES UGWP scheme with orographic drag of GSL Note that only one "large-scale" scheme can be activated at a time.