release-noresm2.1.2

release-noresm2.1.2 is a minor management update to release-noresm2.1.1

There are no answer or experiment changes in this release.

The purpose of release-noresm2.1.2 is to enable running NorESM2.1 experiments on Betzy after machine upgrade in August 2024. Older tool chain modules are being removed, hence this version introduces new tool chain modules through CIME. Model output is bit identical to previous results. Other HPC systems should not be affected by changes introduced in this release.

What's Changed

• Remove preprocessorDefinitions.h files by @gold2718 in #498
• Update NorESM2.1 cime tag for new tool chain on Betzy. by @TomasTorsvik in #542

Full Changelog: release-noresm2.1.1...release-noresm2.1.2

Component updates:

CIME

• Change tool chain modules on Betzy from 2020a versions to 2022a versions

BLOM

BLOM tag changed from v1.5.1 to v1.5.2.

• BLOM v1.5.2 includes a minor update on the regression testing setup.

Component tags

component	tag
cam	cam_noresm2_1_v1.0.2
cice	cice5_20181109-Nor_v1.0.3
cime	cime5.6.10_NorESM2_3_r4
cism	wrapper_noresm2.0.6_v0
clm	release-clm5.0.14-Nor_v1.0.5
mosart	release-cesm2.0.03-Nor_v1.0.0
blom	v1.5.2

Component (updated/not updated) relative to release-noresm2.1.1

release-noresm2.0.8

release-noresm2.0.8 is a minor management update to release-noresm2.0.7

There are no answer or experiment changes in this release.

The purpose of release-noresm2.0.8 is to enable running NorESM2.0 experiments on Betzy after machine upgrade in August 2024. Older tool chain modules are being removed, hence this version introduces new tool chain modules through CIME. Model output is bit identical to previous results. Other HPC systems should not be affected by changes introduced in this release.

Component updates:

CIME

• Change tool chain modules on Betzy from 2020a versions to 2022a versions

BLOM

BLOM tag changed from v1.3.0 to v1.4.2.

• BLOM tag v1.4.0 introduces a major iHAMOCC code re-organization, new mechanisms to create namelist files, and some new optional features. See full changelog for details.
• BLOM v1.4.1 add missing configurations for the ATRC option.
• BLOM v1.4.2 includes a minor update on the regression testing setup.

Component tags

component	tag
cam	cam_cesm2_1_rel_05-Nor_v1.0.5
cice	cice5_20181109-Nor_v1.0.3
cime	cime5.6.10_NorESM2_3_r4
cism	wrapper_noresm2.0.6_v0
clm	release-clm5.0.14-Nor_v1.0.4
mosart	release-cesm2.0.03-Nor_v1.0.0
blom	v1.4.2

Component (updated/not updated) relative to release-noresm2.0.7

release-noresm2.1.1

The NorESM2.1 release is a technical release that includes a few bug fixes along with numerous code improvements from the NorESM2.0 release (NorESM tag release-noresm2.0.6).

This release also introduces a set of regression tests for targeted compset / resolution combinations which is how supported simulations are defined in a technical release. There are 3 levels of support:

1. No support. If there are no regression tests defined for a given compset/resolution pair then the configuration is not technically supported and you will need to add a --run-unsupported flag to the create_newcase command.

2. Functional support. If there is at least one regression test for a given compset/resolution pair, then the configuration is technically supported and routinely tested and you do not need the run-unsupported flag to be added to the create_newcase command.

3. Scientific support. If there are tuned scientific simulations that accompany a given compset/resolution configuration, then the compset/resolution pair for that simulation will be scientifically supported.

Because of the simulation changes introduced by the bug fixes, this release has no scientifically supported simulations.

Below, we outline the significant changes implemented in the NorESM2.1 release

Bug fixes:

• (CAM) Fixed a bug in the Hetfrz code that caused answer changes when changing the number of tasks for a simulation. Please note that the calculation was incorrect for any number of tasks. See NorESMhub/CAM#109

• (CAM) Fixed an ncol/pcols mismatch in calling the clcoag subroutine. This caused some columns to compute incorrect values (which columns are incorrect depends on the number of tasks). See NorESMhub/CAM#24

• (CAM) Removed an artificial limit on the number of ice particles. See NorESMhub/CAM#110

• (CAM) Resolved an error in the calculation of the dry deposition. See NorESMhub/CAM#111

• (CAM) Fixed an ncol/pcols mismatch in several calls to outfld. This caused some columns to output incorrect values (which columns are incorrect depends on the number of tasks). See NorESMhub/CAM#112

• (BLOM) iHAMOCC bug fixes for sediment alkalinity, sinking of free dust with potential effects on burial rates and burial time smoothing (time smoothing was formerly applied multiple times)

• (BLOM) iHAMOCC fixes to OpenMP code blocks

Other updates:

CIME / Python

• The NorESM case control system (CIME) now requires a minimum version of Python 3.8. Python 2.7 was retired at the beginning of 2020 and all Python versions prior to 3.8 are also now retired (“End of Life” in Python terminology). Please consult with your system administrators if you have trouble accessing a recent version of Python.

CAM

• There is a new compile-time XML configuration variable that enables AEROCOM diagnostic output. Simply execute this command before building the code: ./xmlchange CAM_AEROCOM=TRUE
• All code and diagnostic output formerly controlled by the AEROFFL preprocessor definition is now enabled by default whenever using OSLO_AERO
• The DIRIND preprocessor definition has been removed and the code previously contained inside the definitions are now enabled whenever using OSLO_AERO
• The preprocessor definitions and associated code for RFMIPIRF, SPAERO, and COLTST4INTCONS have been removed. The code previously contained inside these definitions are no longer in NorESM2.1
• Specifying the model grid alias as f19_f19 is identical to specifying the model grid alias as f19_f19_mtn14. This would apply to creating NF compsets.

BLOM

• Two updated release v1.4.0 and v1.5.0 Release notes are summarized at NorESMhub/BLOM#319 and NorESMhub/BLOM#313
• v1.5.0 contained updates for hybrid coordinates
• v1.4.0 contained major iHAMOCC changes
  • Major iHAMOCC code re-organization
    • most pre-processor flags ("ifdefs") replaced by logical flags that are read in via namelist
    • all subroutines placed in modules
    • new module mo_param_bgc collects all model parameters and routines for initialization of model parameters
  • Major iHAMOCC code style changes (unified indentation, lower-case keywords)
  • Added regression testing functionality for BLOM, when run as part of NorESM
  • New mechanisms to create namelist files when run as part of NorESM (consistent with other NorESM components), through the file namelist_definition_blom.xml
  • New mesoscale eddy diffusivity options
  • C-isotope code for sediment now technically supported
  • Added support for simulating Ocean Alkalinity Enhancement

CISM

• The first steps to enable coupled climate-ice sheet runs (KeyCLIM) are now in place for CISM for compsets N1850frc2G, NHISTfrc2G, NSSP585frc2G, NSSP585frc2extG. These cannot be currently run out of the box since they require CISM restart files that are not distributed with this release. However, this capability will be in place in NorESM2.3 in the spring.

Component tags

component	tag
cam	cam_noresm2_1_v1.0.2
cice	cice5_20181109-Nor_v1.0.3
cime	cime5.6.10_NorESM2_1_r4
cism	wrapper_noresm2.0.6_v0
clm	release-clm5.0.14-Nor_v1.0.5
mosart	release-cesm2.0.03-Nor_v1.0.0
blom	v1.5.1

Component (updated/not updated) relative to release-noresm2.0.7

Tested configurations (compset / resolution combinations)

The combinations of compset and resolution below have been run on Betzy. That is why simulations using these combinations can be created without using the --run-unsupported option to create_newcase (see introduction above).

Longer tests

• Compset: N1850, Grid: f19_tn14, Betzy, years 1600-1699 (branched off from N1850_f19_tn14_11062019, i.e., the point where the standard 500-year long piControl simulation also started). These 100-year long simulations will give an indication of the TOA imbalance and of the drift in surface temperature and ocean heat content.
• Compset: NF1850norbc, Grid: f19_f19, Betzy, 30 years. This simulation in combination with the NF1850norbc_aer2014 allows us to estimate the ERF.
• Compset: NF1850norbc_aer2014, Grid: f19_f19, Betzy, 30 years.

Short (regression) tests

• Compset: N1850frc2 Grid: f09_tn14; Enabled by short exact restart and short run tests.
• Compset: NHISTfrc2 Grid: f09_tn14; Enabled by short exact restart and short run tests.
• Compset: N1850 Grid: f19_tn14; Enabled by short exact restart and short run tests.
• Compset: NHIST Grid: f19_tn14; Enabled by short exact restart and short run tests.
• Compset: N1850esm Grid: f19_tn14; Enabled by short exact restart and short run tests.
• Compset: F2000climo Grid: f19_f19_mtn14; Enabled by a short run and by exact restart tests with a processor count change.
• Compset: QPC6 Grid: f19_f19_mtn14; Enabled by a short run and by exact restart tests with a processor count change.
• Compset: FHS94 Grid: f19_f19_mtn14; Enabled by a short run and by exact restart tests with a processor count change.
• Compset: NF1850norbc Grid: f19_f19_mtn14; Enabled by a short run and by exact restart tests with a processor count change.
• Compset: NF1850norbc Grid: f19_f19_mtn14; Enabled by a short run.
• Compset: NF1850frc2norbc Grid: f09_f09_mtn14; Enabled by a short run and by exact restart tests with a processor count change.
• Compset: NF1850norbc_aer2014 Grid: f19_f19_mtn14; Enabled by a short run and by exact restart tests with a processor count change and with and without AEROCOM diagnostic output.
• Compset: NF1850frc2norbc_aer2014 Grid: f09_f09_mtn14; Enabled by a short run and by exact restart tests with a processor count change.
• Compset: NFHISTnorpddmsbc Grid: f09_f09_mtn14; Enabled by a short run and by exact restart tests with a processor count change.

release-noresm2.0.7

release-noresm2.0.7 is a minor management update to release-noresm2.0.6

There are no answer or experiment changes in this release.
Changes are:

• Updated CIME for better queue management.
• Clean up regression tests to emphasize generation of baselines for NorESM regression tests
• Removed unused file

Component tags

component	tag
cam	cam_cesm2_1_rel_05-Nor_v1.0.5
cice	cice5_20181109-Nor_v1.0.3
cime	cime5.6.10_cesm2_1_rel_06-Nor_v1.0.7
cism	wrapper_noresm2.0.6_v0
clm	release-clm5.0.14-Nor_v1.0.4
mosart	release-cesm2.0.03-Nor_v1.0.0
blom	v1.3.0

Component (updated/not updated) relative to release-noresm2.0.6

release-noresm2.0.6

Version of code which can be used to reproduce the CMIP6 results of NorESM2. This release builds on the six former releases.

Release highlights

Updated NorESM2 documentation

Addition of extra compsets

• new SSP5-3.4 compsets and emission driven SSP compsets (affects CAM-Nor, CLM and NorESM)

CAM-Nor

• technical (non answer-changing) modifications in CAM-Nor : correction in CCN and COSP diagnostics
• correction in H2O emission file link for f09 for the extended (year 2100-2300) SSP1-2.6 and SSP5-8.5 compsets
• addition for the above-mentioned extra compsets

CLM

• addition for the above-mentioned extra compsets

CIME

• modification in archiving script noresm2netcdf4.sh : uses ncks instead of nccopy
• other small modifications.

CISM

• link to cism-wrapper repository on NorESMhub (instead of ESCOMP)
• added CISM support, Greenland enabled compsets and usermod

BLOM

• include option for hybrid vertical coordinates
• include option for sediment spinup
• include support for NUOPC driver
• iHAMOCC source code structure : completed conversion to free-source format and explicit use statements for all imported variables
• modifications in model structure. The hybrid vertical coordinate formulation relies on an external package CVmix, which is included as a git submodule. When building NorESM, the external dependency should be declared for BLOM in the Externals.cfg file : externals = Externals_BLOM.cfg
• changes in model diagnostics in BLOM. Starting from commit 9e6bd6b, which introduced hybrid vertical coordinates, model output changed for the following 4 fields:
  • wflx (vertical mass flux),
  • wflx2 (vertical mass flux squared)
  • bfsq (buoyancy frequency squared)
  • bfsqlvl (buoyancy frequency squared (constant depth levels))
• changes in model diagnostics in BLOM. Pull request #205 included a correction on the variable dp_trc : this variable is supposed to be in unit Pa = kg m-1 s-2 but is wrongly output in unit g cm-1 s-2
• changes in model diagnostics in iHAMOCC. Pull request #202 changed the definition of the variable KWCO2, with the original definition retained in a new variable KWCO2KHM

Component tags

component	tag
cam	cam_cesm2_1_rel_05-Nor_v1.0.5
cice	cice5_20181109-Nor_v1.0.3
cime	cime5.6.10_cesm2_1_rel_06-Nor_v1.0.6
cism	wrapper_noresm2.0.6_v0
clm	release-clm5.0.14-Nor_v1.0.4
mosart	release-cesm2.0.03-Nor_v1.0.0
blom	v1.3.0

Component (updated/not updated) relative to release-noresm2.0.5

How to obtain this version

• type : "git clone https://github.com/NorESMhub/NorESM.git"
• type : "cd NorESM"
• type : "git tag --list" (this should give you a list of the existing tags or releases)
• type : "git checkout release-noresm2.0.6"
• type : "./manage_externals/checkout_externals"

Known issues

feature-noresm2.0.2_keyClim_v02

This releases allows to run on Betzy (automatic resubmission now works) and to archive the case-directory automatically.

Therefore the following files have been changed :

• Externals.cfg and Externals_keyClim-withoutanthraer.cfg : refers to a more recent version of CIME (cime5.6.10_cesm2_1_rel_06-Nor_v1.0.5 instead of cime5.6.10_cesm2_1_rel_06-Nor_v1.0.3).
• cime_config/config_pes.xml : contains now settings for Betzy.

release-noresm2.0.5

Version of code which can be used to reproduce the CMIP6 results of NorESM2. This release builds on the five former releases.

This release contains

• updated NorESM2 documentation, including an overview of NorESM2 releases, updated information about the CLM5.0 model component, and expansion of the FAQ section
• technical (non answer-changing) modifications in CAM-Nor (to guarantee automatic download of AeroTab files for PTAERO compsets)
• technical (non answer-changing) modifications in CTSM/CLM (modification to avoid problems with some compilers, changes related to NorCPM, and updated README.md)

How to obtain this version

• type : "git clone https://github.com/NorESMhub/NorESM.git"
• type : "cd NorESM"
• type : "git tag --list" (this should give you a list of the existing tags or releases)
• type : "git checkout release-noresm2.0.5"
• type : "./manage_externals/checkout_externals"

Known issues

• The "checkout_externals" script requires python version 3.7 or lower. Python >= 3.8 returns the following:

Processing externals description file : Externals.cfg
Checking status of externals: cam, dictionary keys changed during iteration

• CTSM issue: ERROR: Can only set use_init_interp if finidat is set (#495)
  • Fixed in NorESMhub/CTSM#13
  • Solved in NorESM2.0.6

release-noresm2.0.4

(this release is identical to release-noresm2.0.3 except for an additional modification in CIME related to Fram machine. We therefore repeat here the information mentioned in release-noresm2.0.3.)

Version of code which can be used to reproduce the CMIP6 results of NorESM2. This release builds on the four former releases.

This release contains

• modified setting for machine Fram : minor changes due to removal of preproc queue (this is the only change compared to release-noresm2.0.3)
• settings to run on the machine Betzy
• automatic copying of the case directory to the archive directory
• updated documentation
• modifications in the ocean component BLOM (see a list of main changes below)

Notable changes of BLOM v1.1.0 compared to v1.0.0 that has impact on BLOM operation as a component of NorESM

• Added NorESM multiple instance support.
• Corrected time-smoothing of forcing fields received through the coupler so it works for any coupling interval.
• Corrected the generation of BLOM/iHAMOCC input data list.
• Added handling of N-deposition files for N2000 compsets.
• Major restructuring of code to replace header files and common blocks with Fortran modules.
• Added new pe-layout for OMIP1 compsets with iHAMOCC using the tnx2 grid.
• Added support for tripolar ocean grid with 1/8 deg resolution along equator (tnx0.125v4).

How to obtain this version

• type : "git clone https://github.com/NorESMhub/NorESM.git"
• type : "cd NorESM"
• type : "git tag --list" (this should give you a list of the existing tags or releases)
• type : "git checkout release-noresm2.0.4"
• type : "./manage_externals/checkout_externals"

Known issues

• The "checkout_externals" script requires python version 3.7 or lower. Python >= 3.8 returns the following:

Processing externals description file : Externals.cfg
Checking status of externals: cam, dictionary keys changed during iteration

release-noresm2.0.3

Version of code which can be used to reproduce the CMIP6 results of NorESM2. This release builds on the three former releases.

This release contains

• settings to run on the machine Betzy
• automatic copying of the case directory to the archive directory
• updated documentation
• modifications in the ocean component BLOM (see a list of main changes below)

Notable changes of BLOM v1.1.0 compared to v1.0.0 that has impact on BLOM operation as a component of NorESM

• Added NorESM multiple instance support.
• Corrected time-smoothing of forcing fields received through the coupler so it works for any coupling interval.
• Corrected the generation of BLOM/iHAMOCC input data list.
• Added handling of N-deposition files for N2000 compsets.
• Major restructuring of code to replace header files and common blocks with Fortran modules.
• Added new pe-layout for OMIP1 compsets with iHAMOCC using the tnx2 grid.
• Added support for tripolar ocean grid with 1/8 deg resolution along equator (tnx0.125v4).

How to obtain this version

• type : "git clone https://github.com/NorESMhub/NorESM.git"
• type : "cd NorESM"
• type : "git tag --list" (this should give you a list of the existing tags or releases)
• type : "git checkout release-noresm2.0.3"
• type : "./manage_externals/checkout_externals"

feature-noresm2.0.2_keyClim_v01

This release (tag) consolidates the version as it existed in the branch feature-noresm2.0.2_keyClim from 2021-02 until 2021-10.