Merge pull request #26 from gold2718/noresm2.1

Added the NorESM2.1 release notes (up to date?). Added Dirk's longer simulation discussion. Updated the copyright to extend to 2024.
NorESMhub · Jan 26, 2024 · bcbc186 · bcbc186
2 parents 456f694 + b5dcfbf
commit bcbc186
Show file tree

Hide file tree

Showing 21 changed files with 1,039 additions and 6 deletions.
diff --git a/conf.py b/conf.py
@@ -20,7 +20,7 @@
 # -- Project information -----------------------------------------------------
 
 project = 'NorESM'
-copyright = '2020 -- 2023, The NorESM developers group'
+copyright = '2020 -- 2024, The NorESM developers group'
 author = 'The NorESM developers group'
 
 # The short X.Y version
@@ -176,6 +176,8 @@
 # A list of files that should not be packed into the epub file.
 epub_exclude_files = ['search.html']
 
+# -- Other Options -----------------------------------------------------------
+numfig = True
 
 # -- Extension configuration -------------------------------------------------
 extensions = ['sphinxcontrib.bibtex']

diff --git a/img/FSLNT_glob_YEA_n20240105_noresm2.1_cpl.png b/img/FSLNT_glob_YEA_n20240105_noresm2.1_cpl.png
diff --git a/img/FSLNT_glob_YEA_n20240105_noresm2.1_fsst.png b/img/FSLNT_glob_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/LWCF_glob_YEA_n20240105_noresm2.1_fsst.png b/img/LWCF_glob_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/NUMICE_NUMLIQ_columnburden_glob_YEA_n20240105_noresm2.1_fsst.png b/img/NUMICE_NUMLIQ_columnburden_glob_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/NUMICE_columnburden_glob_YEA_n20240105_noresm2.1_cpl.png b/img/NUMICE_columnburden_glob_YEA_n20240105_noresm2.1_cpl.png
diff --git a/img/NUMLIQ_columnburden_glob_YEA_n20240105_noresm2.1_cpl.png b/img/NUMLIQ_columnburden_glob_YEA_n20240105_noresm2.1_cpl.png
diff --git a/img/SWCF_glob_YEA_n20240105_noresm2.1_fsst.png b/img/SWCF_glob_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/SW_LW_CF_glob_YEA_n20240105_noresm2.1_cpl.png b/img/SW_LW_CF_glob_YEA_n20240105_noresm2.1_cpl.png
diff --git a/img/TAU_noresm2_glob_YEA_n20240105_noresm2.1_fsst.png b/img/TAU_noresm2_glob_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/TGCLDIWP_TGCLDLWP_glob_YEA_n20240105_noresm2.1_fsst.png b/img/TGCLDIWP_TGCLDLWP_glob_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/TGCLDWP_glob_YEA_n20240105_noresm2.1_cpl.png b/img/TGCLDWP_glob_YEA_n20240105_noresm2.1_cpl.png
diff --git a/img/TREFHT_YEA_n20240105_noresm2.1_cpl.png b/img/TREFHT_YEA_n20240105_noresm2.1_cpl.png
diff --git a/img/U10_SFDMS_glob_YEA_n20240105_noresm2.1_cpl.png b/img/U10_SFDMS_glob_YEA_n20240105_noresm2.1_cpl.png
diff --git a/img/U10_SFDMS_glob_YEA_n20240105_noresm2.1_fsst.png b/img/U10_SFDMS_glob_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/cb_BC_AC_OCW_glob_YEA_n20240105_noresm2.1_fsst.png b/img/cb_BC_AC_OCW_glob_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/cb_glob_mean_aer_burden_YEA_n20240105_noresm2.1_fsst.png b/img/cb_glob_mean_aer_burden_YEA_n20240105_noresm2.1_fsst.png
diff --git a/img/mmflxdmax26.0Nocn_atlarc_YEA_n20240105_noresm2.1_cpl.png b/img/mmflxdmax26.0Nocn_atlarc_YEA_n20240105_noresm2.1_cpl.png
diff --git a/img/tempocn_glob_YEA_n20240105_noresm2.1_cpl.png b/img/tempocn_glob_YEA_n20240105_noresm2.1_cpl.png
diff --git a/noresm2.1/noresm2.1_release_notes.rst b/noresm2.1/noresm2.1_release_notes.rst
@@ -15,15 +15,17 @@ This release also introduces a set of regression tests for targeted compset / re
 
 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
+Below, we outline the significant changes implemented in the NorESM2.1 release. For more information on these, please see section :ref:`noresm2.1_test_runs`
 
 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 https://github.com/NorESMhub/CAM/issues/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 https://github.com/NorESMhub/CAM/issues/24
 
-- (CAM) 	Removed an artificial limit on the number of ice particles. See https://github.com/NorESMhub/CAM/issues/110
+- (CAM) Removed an artificial limit on the number of ice particles. See https://github.com/NorESMhub/CAM/issues/110 . This change causes significant differences in the climate. See :numref:`noresm2.1_test_runs` for a detailed look at the changes.
+
+   For this release, we provide a method to modify the code to restore NorESM2 behavior. To activate this, go to line 2082 of <NorESM root>/components/cam/src/NorESM/micro_mg2_0.F90 and follow the instructions.
 
 - (CAM) Resolved an error in the calculation of the dry deposition. See https://github.com/NorESMhub/CAM/issues/111
 
@@ -53,9 +55,11 @@ BLOM
 - 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
@@ -71,7 +75,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 (currently running)
+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.

diff --git a/noresm2.1/noresm2.1_test_runs.rst b/noresm2.1/noresm2.1_test_runs.rst