Documentation for GEOS GCM v10: Difference between revisions

From GEOS-5
Jump to navigation Jump to search
Changelog: Update to 10.17
Line 133: Line 133:


The only change in this release is moving back to using <code>int()</code> not <code>nint()</code> 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.
The only change in this release is moving back to using <code>int()</code> not <code>nint()</code> 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.
== [10.15.0] - 2020-09-25 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: YES for values; NO for entries/structure ===
Major non-0-diff changes include:
# Update to ESMA_env v3.0.0 (NOTE: '''''SLES 11 Support at NCCS is Removed''''')
* ESMA Baselibs 6.0.16
* Use a new Python Stack: GEOSpyD/Min4.8.3_py2.7
* Update compilers and MPI stacks
** NCCS
*** Intel Fortran 19.1.2
*** Intel MPI 19.1.2
** NAS
*** Intel Fortran 2020.2.254 (aka 19.1.2)
*** MPT 2.17 (same as before)
** GMAO Desktop
*** Intel Fortran 19.1.2
*** Open MPI 4.0.4
<ol start="2" style="list-style-type: decimal;">
<li>The GEOSadas-5_27_0 version of GEOS_Shared/GEOS_Utilities.F90 has slightly different code, <code>nint()</code> instead of <code>int()</code>. This brings git up to date.</li>
<li>Bugfix for computations in uwshcu.F90 that involved <code>MAPL_UNDEF</code></li>
<li>Bug fix for GCC 10 with <code>DRHOS0</code></li>
<li>Upgrade to GEOSchem_GridComp v1.4.1</li></ol>
== [10.14.2] - 2020-09-25 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Changes include:
# Update to FVdycoreCubed_Gridcomp v1.2.5
# Update RRTMGP to master aug2020
# Add logging capability
# Fixes for setup scripts
# Remove Latlon atmosphere in setup
# Updates for coupled model setup
# Add section for AWS SLURM
# Allow SCM to run with 91, 137 and 181 levels
# Restore use of SHARE CHMDIR at NCCS for all levels
# NCL scripts added to generate MERRA2 forcing for SCM
# Remove clock rewind only in replay logic for GuestOcean
# Add melt_potential and fix Orphan Points for MOM6 plug/Guest ocean
# Subroutines called from within OPENWATERCORE of GEOS_OpenWaterGridComp.F90 have been moved GMAO_Shared to be shared across applications/components
# Clean up/simplify AOIL
# Clean up of Saltwater's children
# Genericize NCAR GWD Beres file location
# PRECIPFRAC functionality for Catch and CatchCN
# Updates to allow GEOS to build without MKL
# Run binarytile.x without MPI dur to Intel issues
# Upticks of other subrepo/component versions
== [10.14.1] - 2020-07-23 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Major changes include:
# Allows EMIPs to work with New Land restart files. These files do not necessarily occur on the same day of the month. The modified code will search for files within a given year-month and start an EMIP member from that date.
# Fixed gcm_regress.j such that it allows to run regression test on coupled model with MOM5 and MOM6 ocean.
# Removed S2S history template with confusing name.
# Adds an fv3_setup and fv3.j script for the FV3 Standalone.
# Allows the JCAP functionality to work again in mkiau gridcomp as that needs the r4 version of ncesp_sp in gmao_transf.
# Modify mpirun flags for Open MPI 4.0.4.
# Updates to plots.
== [10.14.0] - 2020-07-17 ==
=== Zero-diff to previous release: YES - for default 72L-1MOM configuration ===
=== Restart Changes: YES - gwd_import_checkpoint has been added ===
Major changes include:
# Added MOM6 plug
# Added NCAR GWD
# Updated GFDL microphysics
# Updated MOM5
# Run time switch between MOM5 or MOM6
# Updates for JEDI Integration
# Updated FMS
# Sparsed out FVdycore_GridComp and ARIESg3_GridComp dynamical cores. Sparsed out GMAO_pilgrim from GEOSgcm_GridComp.
# Update Aerosol Chemistry BCs to match new vertical levels.
# Additional question in setup scripts for:
## Chosing microphysics option
## Chosing hydrostatic/non-hydrostatic mode
== [10.13.0] - 2020-06-26 ==
=== Zero-diff to previous release: ONLY 72L 1-MOMENT DEFAULT CONFIG ===
=== Restart Changes: NO ===
Only 0-diff for 72-level 1-MOMENT default configuration. Non-0-diff for ALL others. Major changes include:
# Support for increased vertical resolution and updates in FV3 and GFDL. New 71, 91, and 181-level options which have eta distributions similar to the ECMWF 137-level option. New 127-level option is similar to NCEP. Retuned surface mixing results in non-0-diff changes to the 132-level option.
# Updated MPI Settings for running at NCCS.
# New updates from S2S3 tag in CVS.
# Updates to coupled plotting package (coupled_diagnostics)
# Fixed MOM_GEOS5Plug MAPL Timers for RUN2.
# River routing updates.
# SLES12 bugfix reading LAI, GRN, NIRDF, VISDF and NDVI in (LDAS) ensemble mode.
# CatchCN now gets daylength from MAPL sun code abstractly so it works with the new procession including type of orbit.
# Updated to Chemistry v1.3.5.
# Added lines to AGCM.rc.tmpl to run RRTMGP (disabled by default).
== [10.12.5] - 2020-06-05 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Changes include:
# Uptick the versions of many sub-repos (MAPL,cmake,env,GEOSchem_GridComp,GEOSgcm_GridComp,GEOSgcm_App,GMAO_Shared).
# Bugfix for array bounds in RRTMG LW.
# Rolls back the constraint on gcmpost.script to only operate on pressure-level collections.
# Added ignore_nan option for time_ave.F (off by default).
# Enables correct post proccessing of MAPL monthly collections.
# CICE updates for reading binary grid files.
# MIN_FREEZE_SALINITY added to AGCM.rc in coupled mode.
== [10.12.4] - 2020-05-15 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Major changes are:
# Brings RRTMGP code up to date with recent Pincus Master changes as of 3 May 2020
# Add ability to run setup scripts in another's install directory
# Support for new surface parameter resource file for land
# Fixes issues with the scm_setup
# Update CircleCI to use Baselibs 6.0.12
# Use different ALLREDUCE algorithm for Intel MPI
# Change Intel MPI GATHERV algorithm so GEOSgcm does not lock up on skylakes at checkpoint
# Add a commented out setenv for the FOR_IGNORE_EXCEPTIONS in MPT
# Add option to symlink GEOSgcm.x in experiment directory
# FSEGMENT bug fix in gcm_forecast.setup
== [10.12.3] - 2020-04-21 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Major changes are:
* Update to MAPL 2.1 which includes both fixes from [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.1.0 MAPL v2.1.0] and [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.1.1 MAPL v2.1.1]
** With this is included updating to latest releases of [https://github.com/GEOS-ESM/ESMA_env/releases ESMA_env] and [https://github.com/GEOS-ESM/ESMA_cmake/blob/master/CHANGELOG.md ESMA_cmake] needed by MAPL 2.1
** Add monthly mean features
** Add optional equation of time correction to solar position used to calculate solar zenith angle.
== [10.12.2] - 2020-04-16 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO except moist_import has an additional field: FRACI ===
Major changes are:
# Added connectivity from MOIST to CHEM for 2 fields (RI and RL).
# Updates to the obio component which was in the CVS Icarus-2.0 tag.
# Bugfix for coupled mode renaming TSKINI to TSKINICE.
# Bugfix for DTDT_moist which was initially set to temperature but never updated to provide tendency.
# Compute the lightning flash rate (LFR) online following the approach used by GEOSCHEMchem_GridComp. The LFR is calculated in MOIST and then made available to other components as a new export field (LFR_GCC).
# Modified the mk_Restarts script to run on SLES-12.
# Update RRTMGP to Pincus 2020-Feb-12.
# New Surface parameter resource file (GEOSsurface_GridComp/Shared/GEOS_SurfaceGridComp.rc) to avoid having to add new parameters into AGCM.rc.tmpl and prepare for further science development.
# Correcting the following issues with the single column model: (1) GF imports from DYN were not filled; (2) scm_setup incompletely adjusted for L132; (3) SST file for cfmip_s11 case was incorrect.
# Allows regrid.pl to run on SLES-12
# Enabled compilation of convert_aerosols.x as R8
== [10.12.1] - 2020-03-27 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO except moist_internal has an additional 3 fields: NGRAUPEL, NRAIN, NSNOW ===
Major changes are:
# Broader support for various computing environments including SLES12. Adds a new question to gcm_setup (and other setup scripts) that asks a user what type of processor to run on. It then uses the &quot;default&quot; number of cores per those processors to better figure out how to handle the IOserver nodes.
# Changes that enable MAPL2 GEOS to work with MPT at NCCS.
# Changed REPLAY_Shutoff alarm from NON-STICKY to STICKY, and used it in GAAS to stop updates in forecasts during REPLAY mode.
# Updates to moist and GOCART using 2MOMENT microphysics and MG3. These are 0-diff when running the default 1MOMENT microphysics.
# Modified gcmpost.script to only operate on pressure-level collections.
# Fixes issues where systems do not have either ImageMagick or F2Py. If F2Py is not found, then F2Py targets are not built.
# Changes to GMAO_hermes:
#* Split off the independent sections of module m_topo_remap used by FV core into shared_topo_remap
#* write_eta.F90 added to prepare for a config file which eventually will replace m_set_eta module
#* Add option to build HERMES_LIGHT
== [10.12.0] - 2020-03-09 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
Major changes are:
# Fixed &quot;zero-diff&quot; issue related to GF evaporation vs total rain, fixed GF cloud-mass-flux scaling issue.
# Move ShallowCu contribution to mass flux and add scale-dependent stochastics to convection.
== [10.11.0] - 2020-03-04 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
Major changes are:
# RRTMG_SW: Updates RRTMG_SW in GEOS to be equivalent to RRTMG_SW v4.10. This fix increases the heating rates near the stratospause region and is a non zero-diff change.
# RAS_NO_NEG: Provides an optional flag that ensures RAS results are non-negative. This is an important fix for chemical species that was extremely useful in the Icarus but did not make it into Jason. The fix is &quot;off&quot; by default and therefore zero-diff.
# Plots:
* Enable additional upper levels for forecast stats plots.
* Add QITOT &amp; QLTOT to horizontal plots.
* Add aerosols to time series plots.
Other updates:
* Remove #PBS pragmas at NCCS to use #SBATCH.
* Brought the chem setup scripts in line with gcm_setup.
* Bug fixes for gcm_run and gcm_forecast scripts.
== [10.10.0] - 2020-02-20 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
This release is equivalent to the [https://github.com/NOAA-GFDL/FMS/releases/tag/2019.01.01 NOAA 2019.01.01 Release] but with the addition of GEOS constants controlled by <code>-DMAPL_MODE</code>. Additional changes allow building with CMake.
== [10.9.0] - 2020-02-13 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
This release is equivalent in physics to v10.8.0 but now uses [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.0.0 MAPL 2.0]. The release is non-zero-diff due to the use of ESMF regridding for History and ExtData.
Also, this version of GEOSgcm now uses the new PFIO IO server to handle History and ExtData file access and writing. By default, these IO servers run on the same resources (i.e., nodes) as the application. However, <code>gcm_setup</code> and <code>gcm_run.j</code> have been altered so that, by default, at high-resolution (C180+) the IO servers are on separate nodes for performance and memory reasons.
== [10.8.0] - 2020-02-06 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO (only if AOIL_COMP_SWITCH=ON) ===
Recoded atmosphere-ocean interface layer (AOIL). Provides an option to exercise old/new versions of the AOIL.
# Old version (AOIL_COMP_SWITCH = ON): Default. Using the old interface is still non-zero diff to x0039, however, shown to be statistically insignificant in terms of forecast skill scores. Restarts with old interface can be used as is.
# New version (AOIL_COMP_SWITCH = OFF): If the new interface is turned on, then the user must provide additional fields in the internal state. Contact Santha Akella for a utility to do that.
== [10.7.0] - 2020-02-04 ==
=== Zero-diff to previous release: NO ===
=== Zero-diff to CVS tag Jason-3_5_aoil ===
=== Restart Changes: NO ===
# Correction to RRTMG Shortwave 'layreffr' variable to reduce stratospheric cold bias.
# Stats plots updates to produce stratospheric forecast statistics up to 1mb.
# Correction to gcm_run.j &amp; gcm_forecast.tmpl related to REPLAY with GAAS aod files.
== [10.6.0] - 2020-01-31 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
# Atmospheric constituents (aersols, co, co2, etc) are now transported through moist/GF. This is equivalent to the way transport is handled in f525land_fpp/f525_fp.
# Added exports for nitrate tendency and other fluxes related to GF convection.
# Added nitrate tendency to history templates.
# Upgraded to GEOSchem_GridComp to v1.1.0.
# Set the default k_split = 2.
# Fixed gcm_convert.j to work consistent with how gcm_setup and gcm_run.j interact.
== [10.5.0] - 2020-01-24 ==
=== Zero-diff to previous release: YES (but user must setup experiment differently) ===
=== Restart Changes: NO ===
<ol>
<li><p>Hotfixed a bug to enable regridding of catchement restarts from MERRA2</p></li>
<li><p>REPLAY updates:</p>
<p>The REPLAY algorithm within the GEOSagcm has been modified to enable a 4DIAU methodology consistent with that used in DAS mode. Prior to this release, REPLAY could only incorporate one analysis increment within the CORRECTOR_DURATION window (nominally 6-hours). The 4DIAU update allows for multiple analysis increments to be used within the CORRECTOR window. The number of increments that wiil be used is determined by the settings of the REPLAY_FILE_FREQUENCY (in nnnnnn seconds format) and the REPLAY_FILE_REFERENCE_TIME (in HHMMSS format). Based on these two settings, the code will determine how many analysis increments will properly fit within the CORRECTOR window. Note: the previous setting of PREDICTOR_DURATION is no longer needed since the code computes the required length automatically.</p>
<p>The updated algorthm allows for 2 types of REPLAY:</p>
<ol>
<li><p>Exact (Uses Archived Increment Files)</p>
<p>Exact REPLAYs identically reproduce (bit-for-bit) a previous GEOS DAS experiment by simply using the archived IAU forcing from the DAS experiment. For these cases, only the CORRECTOR step is employed and is, therefore, as efficient as a stand-alone model run.</p></li>
<li><p>Regular (Uses Archived Analysis/Assimilation Files)</p>
<p>Regular REPLAYs are used to mimic the original IAU methodology, i.e., both the PREDICTOR and the CORRECTOR steps are employed. The key difference being that the Analysis is based on archived datasets. These Analyses may be from the GEOS DAS system, or from any other source that is written using the appropriate GEOS DAS ana.eta data format.</p></li></ol>
<p>For more detailed information, please see the comments within the AGCM.rc.tmpl file.</p></li></ol>
== [10.4.0] - 2020-01-13 ==
=== Zero-diff to previous release: YES (with defaults and without regridding) ===
=== Restart Changes: YES (land regridding) ===
* Non-zero-diff updates for:
*# Regridding land restarts
*# Running Chou-Suarez longwave radiation.
# Update FV3 to latest version v1.0.9 which fixed UH25 diagnostic to build in both R4 and R8.
# Land Updates:
## Clarified LONG_NAME of &quot;snow depth&quot; variable.
## Added wemin wemout options.
## Add PEATMAP data processing (disabled by default).
## GEOSsurface_GridComp changed values of pi to MAPL_PI.
## Added 8 more climatological (fPAR, VISDF, NIRDF stats for CATCHCN) data files and new clsm/country_and _state_code.data file.
## Extra column on soil_param.* files.
# Non-zero-diif bug fix in Chou-Suarez for erroneous cloud contamination in OLR-OLRNA (aerosol forcing).
# Fixed MAPL bug with vector regridding of winds in CTM.
# Workaround fix building FMS on macOS.
== [10.3.6] - 2020-01-02 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
# Compute decomposition in MKIAU GridComp
# Use esma_set_this in GCs
# Allows GEOS-Chem (v12.4.0) chemistry to be setup and run &quot;out of the box&quot;.
# INTERNAL and IMPORT restarts for GEOS-Chem are now in AGCM.rc.tmpl.
# GEOS-Chem timestep is set to be 2 x HEARTBEAT by default.
# Enforces GOCART_DT==HEARTBEAT_DT so all species work correctly.
# Bug fix for comments using GNU compilers with Ninja.
== [10.3.5] - 2019-11-07 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
# Enable reading netCDF increments during EXACT replay.
# Fixed issues affecting the MOIST aerosol diagnostics:
## incorrect mapping of tracer names to diagnostics
## sign of the diagnostics by not allowing negative values.
# New approach for increment diagnostics discussed in GEOSchem_GridComp v1.0.3.
# OXIT and OXIM replaced with MTRI%PCHEM::OXIM and TRI%PCHEM::OXIT in most HISTORY files. OX increments due to moist and turblence are now computed using BundleIncrementMod.F90 and their names have been changed.
# Implemented increments to land surface variables in the ADAS.
# Fixed GUST for AMIP vs no-inc REPLAY difference in HISTORY.
# Removed shallow.F90 which is no longer used.
# Updated <code>gcm_regress.j</code> to be able to test both agcm and coupled models.
# Remove references to <code>gcm_stats.j</code> in setup.
== [10.3.4] - 2019-10-01 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
# Fields out of the MTR bundle came in the “wrong” order and affected the Henry’s law constants. Hotfix to fetch field by name instead of by index.
# Fixed triangular pdf option in SHUW.
# Update chemistry to v1.0.2 to run GMI and Stratchem. Updated the StratChem and GMIchem setup scripts to better match gcm_setup.
# Hotfix in <code>fv_tracer2d.F90</code> to compare to ksplt instead of nsplt.
# <code>FVdycoreCubed_GridComp</code> moved to separate repository.
# FMS moved to separate repository and renamed <code>GFDL_fms</code> to fms
# <code>getco2.F90</code> moved to <code>@GMAO_Shared</code>.
# Adapted <code>GuestOcean_GridComp</code> to select DATASEA, MOM5 or MOM6 at runtime.
# Changes to enable LDAS to start using the develop branch:
## ensemble ID width for LDAS
## added co2 file for CatchCN support
## bug fix that only affects New Land when snow impurity model is active
# Updates from S2S-3 CVS tag:
## Includes dual ocean code
## Update to precip correction and additional coupled diagnostics
# MERRA2_EMISSIONS_DIRECTORY path bugfix for <code>gcm_run.j</code> and <code>gcm_regress.j</code>
# Updates from CVS <code>GEOSadas-5_25_2</code> tag.
# Updated plots.
# Enhancements to <code>scm_setup</code> script.
== [10.3.3] - 2019-10-02 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
# Move to GMAO_Shared 1.0.4 to merge more updates from CVS for plots
# Updates for Travis CI
== [10.3.2 / Jason-3_2] - 2019-08-02 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
# Changes in FV3 related to Horizontal Advection choices. (from Bill: JU_20190722_WMP)
# Changes in FV3 dddmp (from 0.1 to 0.2, to improve stability)
# Changes in MOIST related to ICE-FALL. (from Bill: JU_20190722_WMP)
# Updates to <code>GEOS_OpenWaterGridComp.F90</code> and <code>GEOS_DataSeaGridComp.F90</code> to modify the original Coupled/Merged System to include Santha’s reformulated ice/melt. (from Santha: sakella-GEOSadas-5_25_0_DV_in_MIZ_SSTunderIceFix)
# Many updates related to CMAKE for upcoming GIT repository.
# The addition of ERA5 to QUICKPLOT.
# Modified STATS for NPO, SPO, and XPO regions. Modified Montage plots.
Restart Changes: None.
== [10.3.1 / Jason-3_1] - 2019-06-13 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
=== Model Changes ===
# Updates to <code>GuestOcean_GridComp.F90</code> to re-sync OCEAN clock with ATMOS clock when running Regular REPLAY together with DataOcean. (non-zero diff)
# Introduced code in MAPL_CFIO for HISTORY which corresponds to the “fix_undef” utility used in MERRA-2 post-processing. This creates consistency between horizontally transformed and vertically interpolated quantities and the target output level (i.e., values below surface are UNDEF).
# MKIAU has been modified to allow for REPLAYing to different vertical resolution. Results are zero-diff to previous versions if vertical resolution is the same.
# Updates to mk_restarts for Land/Catch. Zero-diff when regrid.pl points to standard (old-land) Icarus/Jason boundary area.
== [10.3.0 / Jason-3_0] - 2019-05-03 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO (with caveats) ===
Due to changes in import states and diagnostics, these restarts have changed but are passive to the prognostic restarts:
* irrad_internal_rst
* surf_import_rst
* tr_internal_rst
* turb_import_rst
=== Model Changes ===
# Zero-Diff update to FV3 dynamics to allow FV3+ADV option
# Updates from Mike Manyin to his tag: Jason-2_2_MEM_2
# This tag primarily is a Merge between Jason-2_2 and Andrea Molod’s coupled tag. This produces a non-zero diff to Jason-2_2 due to a modified surface layer interface.
== [Jason-2_2] - 2019-04-25 ==
=== Zero-diff to previous release: YES (in default mode) ===
=== Restart Changes: NO (with caveats) ===
There was a long_name change in TR restart
=== Model Changes ===
# StratChem updated to tag: Jason-2_0_MEM_2, as well as updates to GEOS-Chem and HEMCO from Mike Manyin
# CARMA updated to tag: prc+asd-AeroChem-Icarus-3_3_p2+a1-v7 from Pete Colarco (with minor mods in <code>DustEmissionMod.F90</code> because of an interface differences)
# GIT related updates.
== [Jason-2_1] - 2019-04-17 ==
=== Zero-diff to previous release: YES (in default mode) ===
=== Restart Changes: YES ===
* <code>turb_import_rst</code>: Simply Bootstrap.
* <code>surf_import_rst</code>: Simply Bootstrap.
* <code>irrad_internal_rst</code> (passive, for clear-sky diagnostics only): Simply Bootstrap
=== Model Changes ===
# Retuning when using NewLand.
# Addition of Optional RRTMPG (off by Default).
# Modifications for New RRTMG diagnostics.
# Updates for regrid.pl and related code.
# StratChem updated to tag: Jason-2_0_MEM_1
# GIT related updates.
== [Jason-2_0] - 2019-03-04 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: YES ===
* <code>solar_internal_rst</code> (for RRTMG). Simply Bootstrap.
=== Model Changes ===
# This is a MAJOR update to include updated moist processes based on the tag: merge_JDB7p1_retuned
* It uses RRTMG for BOTH Shortwave and Longwave radiation.
* It uses the GF Convection Scheme, as well as the UW Shallow Cumulus scheme.
* It uses dynamics tunings based on the DYAMOND experiments.
<ol start="2" style="list-style-type: decimal;">
<li>Option included for running Stochastic Physics.</li>
<li>2nd-Moment Cloud MicroPhysics updated to tag: b_Jason_2_0_donifan</li></ol>
== [Jason-1_1] - 2019-01-23 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: YES ===
* GOCART IMPORT was modified by adding LWI and FRACI to be non-skip
* TR IMPORT was modified by removing ALL but CLDTT (from RAD), since TR is run after SURF RUN(1,2)
* Note: When TR adopts a 2-phase approach, additional IMPORT variables from SURF will need to be included.
=== Model Changes ===
# An error was found related to GOCART and TR regarding the TR and GOCART IMPORT restarts. This error was introduced going from Icarus-1_0_p1 to Icarus-2_0 with the splitting of GOCART into RUN1 and RUN2 methods. Essentially, the ordering in PHYSICS is: SURF,CHEM,TURB RUN1, followd by SURF,TURB,CHEM RUN2. Emissions are computed in CHEM RUN1 based on LWI locations. However, LWI is not computed until SURF RUN2. Therefore, LWI is required on the GOCART IMPORT. But this variable was labeled as RESTART_SKIP. The TR IMPORT did contain LWI, thus when TR was Enabled, GOCART saw the proper LWI. But when TR was Disabled, LWI was no longer available for GOCART, and resulted in non-zero differences. The quick solution was to label LWI as non-skip on the GOCART IMPORT restart.
# An error was found related to the TH_for_CHEM within the SYNC-TQ sequence. The error was fixed, but experiments showed negligible impact due to its second-order influence.
# Modifications to the STATS plotting package to include Mean-Square-Error decompostion.
== [Jason-1_0_BETA] – 2018-09-17 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: YES ===
* <code>saltwater_internal</code> ==&gt; <code>openwater_internal</code> &amp; <code>seaicethermo_internal</code>
=== Model Changes ===
# Saltwater split =&gt; openwater and seaicethermo. This means <code>saltwater_internal</code> is now two files: <code>openwater_internal</code> and <code>seaicethermo_internal</code>. <code>saltwater_import</code> remains. Regridding utility (<code>regrid.pl</code>) will always produce the split ocean with this tag. You can, however, provide the single <code>saltwater_internal</code> as input.
# Sponge Layer fix in FV3 to include damping between top model layer and bottom of sponge.
# Regridding in MAPL now done in a new abstract/OO paradigm. This leads to the new grid definitions in AGCM.rc
# New HISTORY.rc grid_label definitions. This HISTORY is designated as VERSION: 1. Older HISTORY files (using resolution attribute) will still work provided VERSION = 0.
# QUICKPLOT updates to produce automated “closeness” plots.


== Previous Versions ==
== Previous Versions ==


For previous changes please see [[:File:ChangeLog-PreJason.txt|ChangeLog-PreJason.txt]]
For previous changes please see the [https://github.com/GEOS-ESM/GEOSgcm/blob/main/CHANGELOG.md CHANGELOG.md] on the GitHub repository
 


----  
----  
'''Back to [[GEOS User's and Developer's Guides]]'''
'''Back to [[GEOS User's and Developer's Guides]]'''

Revision as of 06:47, 19 March 2021

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.

GEOS GCM Documentation

  • 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.0] - 2020-11-25

Zero-diff to previous release: YES

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

Zero-diff to previous release: YES

Restart Changes: NO

Changes include:

  1. Added fixture section to components.yaml

[10.16.2] - 2020-10-28

Zero-diff to previous release: YES for default catchment, NO for CatchmentCN

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

Zero-diff to previous release: YES for AGCM, NO for coupled model

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

Zero-diff to previous release: NO

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