Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add the Pleim-Xiu (P-X) LSM and FDDA to MPAS-A #1027

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from

Conversation

jherwehe
Copy link

This EPA_PXLSM_with_FDDA PR will add the Pleim-Xiu land surface model
codes (PR #1025) and the 3-D grid analysis nudging FDDA codes (PR #995)
to MPAS-A. This combination of codes from these two PRs is necessary to
maintain numerical stability during longer retrospective simulations by
utilizing grid nudging FDDA with the soil nudging used within the PX LSM.
The modifications in this PR have been successfully tested with the YSU
PBL, KF CPS, WSM6 MP, M-O surface layer, YSU GWDO, and RRTMG radiation
physics schemes.

This PR will also add the new physics suite called "epa_aq_reference"
(shown below) as an option for "config_physics_suite" (via
mpas_atmphys_control.F) and is suitable for retrospective air quality
simulations.

This PR is the last in the series of established EPA physics enhancements
implemented into MPAS-A. This EPA series consists of code modifications
to MPAS-A v7.3 found in pull requests #994, #995, #1002, #1003, #1010,
#1025, and this PR (and all of these PRs are required to enable the
"epa_aq_reference" physics suite options). Altogether, these EPA physics
enhancements to MPAS-A have been thoroughly tested and evaluated (e.g.,
Gilliam et al., 2021). Overview descriptions of these physics options
can also be found in the WRF-ARW technical document available at
https://opensky.ucar.edu/islandora/object/opensky:2898 and in an updated
PX-ACM-WRFV4.4-MPASv7.3.pdf document (attached to this PR).

New stream files added to streams.atmosphere:
   (refer to PR #1025 for "soilndg" and PR #995 for "fdda")

New namelist.atmosphere options added under &physics:
   config_physics_suite = 'epa_aq_reference'   which sets:
      config_microp_scheme       = 'mp_wsm6'
      config_convection_scheme = 'cu_kain_fritsch'
      config_pbl_scheme             = 'bl_acm'
      config_gwdo_scheme         = 'bl_ysu_gwdo'
      config_radt_lw_scheme       = 'rrtmg_lw'
      config_radt_sw_scheme       = 'rrtmg_sw'
      config_radt_cld_scheme      = 'cld_fraction'
      config_sfclayer_scheme       = 'sf_pxsfclay'
      config_lsm_scheme             = 'px'
      config_fdda_scheme           = 'analysis'
   (refer to PR #1025 and PR #995 for additional new options)

New variables available for output from atmosphere_model:
   (refer to PR #1025 and PR #995)

NOTE: These EPA_PXLSM_with_FDDA code changes to MPAS-A are based on the
12 December 2022 "develop" branch of MPAS v7.3.

Reference:
Gilliam, R. C., J. A. Herwehe, O. R. Bullock Jr, J. E. Pleim, L. Ran, P.
   C. Campbell, and H. Foroutan, 2021: Establishing the suitability of
   the Model for Prediction Across Scales for global retrospective air
   quality modeling. J. Geophys. Res. Atmos., 126, e2020JD033588.
   https://doi.org/10.1029/2020JD033588

This EPA_PXLSM_with_FDDA commit will add the Pleim-Xiu land surface
model codes from the atmosphere/develop-EPA_PXLSM branch and the 3-D
grid analysis nudging FDDA codes from the atmosphere/develop-EPA_FDDA
branch to MPAS-A.  This combination of codes from these two branches is
necessary to maintain numerical stability for longer retrospective
simulations by utilizing grid nudging FDDA with the soil nudging within
the PX LSM.  This commit will also add the new physics suite called
"epa_aq_reference" suitable for retrospective air quality simulations.

This commit is the last in the series of established EPA physics
enhancements implemented into MPAS-A.  This EPA series consists of code
modifications to MPAS-A v7.3 found in these
https://github.com/jherwehe/MPAS-Model branches:
  atmosphere/develop-EPA_KF
  atmosphere/develop-EPA_FDDA
  atmosphere/develop-EPA_ACM2
  atmosphere/develop-EPA_PXsfclay
  atmosphere/develop-EPA_init
  atmosphere/develop-EPA_PXLSM
  atmosphere/develop-EPA_PXLSM_with_FDDA  (this commit)
Altogether, these EPA physics enhancements to MPAS-A have been
thoroughly tested and evaluated (e.g., Gilliam et al., 2021).  Also
refer to the pertinent physics descriptions in the WRF-ARW technical
document available at
https://opensky.ucar.edu/islandora/object/opensky:2898 for an overview
of the physics behind these options.

New files:
  src/core_atmosphere/physics/mpas_atmphys_fdda.F
  src/core_atmosphere/physics/physics_wrf/module_sf_pxlsm.F
  src/core_atmosphere/physics/physics_wrf/module_sf_pxlsm_data.F

Modified files:
  Makefile
  src/core_atmosphere/Registry.xml
  src/core_atmosphere/physics/Makefile
  src/core_atmosphere/physics/mpas_atmphys_control.F
  src/core_atmosphere/physics/mpas_atmphys_driver.F
  src/core_atmosphere/physics/mpas_atmphys_driver_lsm.F
  src/core_atmosphere/physics/mpas_atmphys_initialize_real.F
  src/core_atmosphere/physics/mpas_atmphys_manager.F
  src/core_atmosphere/physics/mpas_atmphys_todynamics.F
  src/core_atmosphere/physics/mpas_atmphys_update_surface.F
  src/core_atmosphere/physics/mpas_atmphys_vars.F
  src/core_atmosphere/physics/physics_wrf/Makefile
  src/core_init_atmosphere/Registry.xml
  src/core_init_atmosphere/mpas_init_atm_cases.F
  src/core_init_atmosphere/mpas_init_atm_core_interface.F
  src/core_init_atmosphere/mpas_init_atm_static.F
  src/core_init_atmosphere/mpas_init_atm_surface.F

These EPA_PXLSM code changes to MPAS-A are based on the 12 December 2022
"develop" branch of MPAS v7.3.

Reference:
Gilliam, R. C., J. A. Herwehe, O. R. Bullock Jr, J. E. Pleim, L. Ran, P.
  C. Campbell, and H. Foroutan, 2021:  Establishing the suitability of
  the Model for Prediction Across Scales for global retrospective air
  quality modeling.  J. Geophys. Res. Atmos., 126, e2020JD033588.
  https://doi.org/10.1029/2020JD033588
@jherwehe
Copy link
Author

@jherwehe
Copy link
Author

Code conflicts in src/core_atmosphere/Registry.xml were manually resolved to support the grid analysis nudging FDDA portion of this PR and have been committed (408eebf).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants