Skip to content

v12: Set L72 parameters to match v11#815

Open
mathomp4 wants to merge 3 commits intofeature/sdrabenh/gcm_v12from
feature/v12-l72-is-v11-like
Open

v12: Set L72 parameters to match v11#815
mathomp4 wants to merge 3 commits intofeature/sdrabenh/gcm_v12from
feature/v12-l72-is-v11-like

Conversation

@mathomp4
Copy link
Member

@mathomp4 mathomp4 commented Mar 3, 2026

Closes #814

TL;DR: Updates setup to make L72 runs like v11.

NOTE: Labeled as 0-diff (because it is for all non-L72 runs) but as non-zero-diff for L72


This pull request introduces coordinated changes across multiple setup scripts and configuration files to ensure that selecting a 72-level atmospheric model (AGCM_LM == 72) automatically updates several model defaults to match the GEOSgcm v11 configuration. The updates improve consistency, user guidance, and automation for model configuration, especially for users choosing the 72-level option. The main changes include automatic selection of microphysics, land surface boundary conditions, radiation schemes, and time step settings, along with supporting template and parameter updates.

Automated configuration for AGCM_LM = 72:

  • When 72 levels are chosen, the default microphysics is set to BACM_1M, land surface boundary conditions to NL3, radiation scheme to RRTMG, and the default heartbeat to 450 seconds. Informative notes are displayed to users in all setup scripts (gcm_setup, geoschemchem_setup, gmichem_setup, stratchem_setup).

Radiation scheme selection and template support:

  • Introduced logic and template variables (RRTMG_RADIATION, RRTMGP_RADIATION) to switch between RRTMG and RRTMGP radiation schemes based on the vertical resolution. This is reflected in both setup scripts and the AGCM.rc.tmpl file, allowing dynamic configuration in the final runtime configuration.

Land surface boundary condition defaults and user prompts:

  • The default land surface boundary condition is now set to NL3 for 72 levels and v12 otherwise, with corresponding updates to user prompts and variable substitution logic in all relevant setup scripts.

Microphysics and parameter automation:

  • The default microphysics option is now determined by the vertical resolution, and the KLID parameter is automatically set according to both microphysics and vertical resolution, streamlining configuration and reducing manual errors.

Time step and physics parameter updates for 72-level runs:

  • Physics time steps (DT, CONV_DT, CHEM_DT) are set to values compatible with the 72-level configuration, including updates for coupled runs and BACM_1M microphysics, ensuring correct and consistent model operation.

Additional configuration tweaks for 72-level runs:

  • For 72-level runs, the snow albedo info in GEOS_SurfaceGridComp.rc is modified to match expected defaults, further automating post-setup adjustments.

These changes collectively make it much easier and less error-prone to configure the model for 72-level runs, aligning with GEOSgcm v11 standards and improving the user experience for both new and experienced users.

@mathomp4 mathomp4 added 0 diff The changes in this pull request have verified to be zero-diff with the target branch. Non 0-diff The changes in this pull request are non-zero-diff labels Mar 3, 2026
@mathomp4 mathomp4 self-assigned this Mar 3, 2026
@mathomp4
Copy link
Member Author

mathomp4 commented Mar 4, 2026

Undrafting as I think this now works.

@mathomp4 mathomp4 marked this pull request as ready for review March 4, 2026 16:04
@mathomp4 mathomp4 requested a review from a team as a code owner March 4, 2026 16:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

0 diff The changes in this pull request have verified to be zero-diff with the target branch. Non 0-diff The changes in this pull request are non-zero-diff

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant