Documentation for GEOS GCM v10

This page lists pages with information on setting up and running GEOS GCM version 10. Earlier and later versions of GEOS may differ in details that, while minor, will require different steps for building and running, so caveat utilitor.

Back to GEOS User's and Developer's Guides

---

Running GEOS GCM

• GEOS GCM Quick Start: This page describes the minimum steps required to build and run GEOS GCM v10 on NCCS discover and NAS pleiades. You should successfully complete the steps in these instructions before doing anything more complicated.

• Regridding Restarts for GEOS GCM

• Using the ExtData component

• Running a Suite of Forecasts

• Setting up to create an experiment page on GMAO Intranet

• Using the SatSim Gridded Component in Jason

• GEOS GCM Single Column Model

GEOS GCM Documentation

• GEOS 5 Developer's Guide (pdf)
• List of Export/Import/Internal states, generated with src/Shared/@MAPL/MAPL_Base/mapl_vlist.py
  • Sorted by short name
  • Sorted by component name

• GEOS-5 Run-Time Characteristics

• Hierarchical structure: Below is a (partially folded) view of the Jason 3.0 hierarchy where each node is a GridComp. Some of the nodes are folded (marked with a circle at the end) for clarity - clicking the composite node reveals the sub-nodes.

<mm>flash|500px|parameters startCollapsedToLevel=4</mm>

Changelog

[10.17.4] - 2021-03-17

History Changes: NO

Major changes include:

1. Moved GOCART legacy to be sourced from separate GOCART repository.
2. Update to MOM6 geos/v2.0.0 and update to FMS geos/2019.01.02+noaff.6
3. Bug fix for regrid.pl which can cause non-0-diff regridding for agcm_import_rst.
4. Fixed MOM6 diagnostics to use correct netcdf reference year.
5. Fix bug in gustiness calculations.
6. Fixed a bug in rotation angle for surface ocean stress.
7. DSO's for mom5 and mom6.
8. GAAS Replay fix.
9. Add MOM.res.nc to the list of restarts that are checked in regression testing.
10. Remove OCEAN_PRELOAD since it is not needed with the DSO.
11. Change path names to support "automatic" MERRA-2 Regular Replay at NAS.
12. Remove CMIP_1977_1982 directory in GEOS_Util/pre/NSIDC-OSTIA_SST-ICE_blend.
13. Update binarytile.x for river routing.
14. Bug fix for edge level arrays out-of-bounds in Lighting_mod.
15. Plot updates for stats.

[10.17.3] - 2021-02-12

History Changes: NO

Major changes include:

1. Performance modification for surface rc file in run methods.
2. Relocation of mk_restarts and Raster.
3. Bugfix for running Catchment-CN with constant CO2.
4. Fixed land BCs in coupled mode
5. Added optional PCHEM species file with prod/loss of strat water vapor
6. Added support for the new Rome nodes at NAS named like r201c2t1n4
7. Plots and stats updates.
8. Eliminated references to MAPL_COMM - these are no longer used and will be deleted in future releases of MAPL.
9. Upgrade to MAPL v2.6.0

[10.17.2] - 2021-01-29

History Changes: NO

Major changes include:

1. Upgrade to MAPL 2.5.0
2. Updates to plots and stats package.
3. Updated PBS Batch handling at NAS.
4. Addded CODE_OF_CONDUCT.md

[10.17.1] - 2021-01-12

History Changes: YES - Roundoff differences in TSOIL1 and TSOIL2

Major changes include:

1. Soil temperatures export variables (TP's) are now in units of Kelvin throughout the Catch and CatchCN. Note: this has introduced roundoff differences in TSOIL1 and TSOIL2 output.
2. New MOM6 configuration (OM4), and a bug fix in MOM6_Plug.
3. Update default coupled model surf collection with a few addition fields.
4. Fix saltwater_internal splitting to work with in AMIP and EMIP mode.
5. Add ASSERTs to RRTMG to test input sanity.
6. Adds a -partition option to mk_restarts so that there can be a -partition option in regrid.pl.
7. Fix gcm_convert.j which was broken.
8. Added flag to regrid_forcing_esmf.x to force a 0 to 1 range when regridding files that should use fractions.
9. Update flags for zonal.f to match CVS and fixed a bug in res/zonal.gs for zonal.x location.
10. Updates to ignores CI if non-essential files are updated (only).
11. Use CONFIGURE_DEPENDS flag to check if any globbed files changed when re-running cmake.
12. Allow use of aggressive flags with GEOS.

[10.17.0] - 2020-11-25

Restart Changes: NO

Major changes include:

1. The way the model is build has changed. Manage externals is no longer supported. Mepo is now the default and replacement manager for multiple repositories.
2. Add dependency to turn on BUILD_SHARED_LIBS for NCEP_Shared.
3. Splits the RRTMG k_g tables into separate files.
4. Bugfix to change Intel Debug flags for MOM6 and FMS.
5. gcm_run.j bugfix for tile_hist running MOM6.
6. Update plots and stats to be consistent with recent CVS tags.
7. Bugfix for C99 compliance on MacOS.
8. Updates to CI and other subrepos.

[10.16.3] - 2020-11-02

Restart Changes: NO

Changes include:

1. Added fixture section to components.yaml

[10.16.2] - 2020-10-28

Restart Changes: NO

The latest release is a 0-diff change when running the default catchment. However, it is a non-0-diff change when running CatchmentCN.

1. Updates to land:
   1. SurfParams: Introduced separate parameter collections for different land model choices that are being cross-checked against the land model choice.
   2. Updates to reproduce Fanwei Zeng’s LDASsa Catchment-CN simulations (science-validated, published) using the 'CN_CLM4' option.
2. Restructure/Refactor DO_OBIO (see Issue #362)
3. Add Docker authentication for pulls.
4. Add logger for NaN detection (at a WARNING level) for QSAT and DQSAT codes.
5. Make plots/configure portable when using someone else's build.
6. Allow longer job names for PBS/SLURM.
7. Update to MAPL.

[10.16.1] - 2020-10-14

Restart Changes: YES (OLRB06RG and TBRB06RG variables added to irrad_internal restart)

Major updates include:

1. Add TOA RRTMG Band6 (window region) IR diagnostics.
2. Include new diagnostics for the constraints and new plots for them.
3. Clean up clumsy logic in GEOS_OpenWaterGridComp.F90 Issue #356
   1. removes the AOIL_COMP_SWITCH
   2. AOIL now properly works with the coupled model (non 0-diff)
   3. maintains 0-diff for uncoupled mode
   4. computations to update the state variables (TW, SW, HW and other internals) are now performed via a call to AOIL_v0.
   5. AOIL_v0 also provides following two options that are turned OFF by default:
      • provide a more gradual decay of diurnal warming as observed in nature: WARM_LAYER_GRAD_DECAY
      • update turbulent heat fluxes after the state variables have been updated: UPDATE_FLUXES_AOIL_SECOND_STEP
4. Upgrade to MAPL 2.3 with a number of changes listed here.
5. Fixed regrid_forcing.x and regrid_forcing_esmf.x so they will work with MAPL2.2 and beyond.
6. Logging config improvements and bugfixes.
7. Fixed a bug in ExtData when extrapolating on a Leap Day.
8. Added a deflate and bit shaving option to Regrid_Util.x.
9. Fix bug with using coarse grids in History and ExtData.
10. Lowers the amount of jobs used during make -jN install in build.csh to mitigate possible segfaults.
11. Updated the NCPUs detection in various post scripts to be SLURM-aware.

[10.16.0] - 2020-09-28

Restart Changes: NO

The only change in this release is moving back to using int() not nint() in GEOS_Shared/GEOS_Utilities.F90 which may cause crashes if the Debugging flags are on. Nevertheless, this is a non zero-diff change to the gcm.

Previous Versions

For previous changes please see the CHANGELOG.md on the GitHub repository

---

Back to GEOS User's and Developer's Guides