2026.03.1 main to stable

.github/pull_request_template.md

@@ -1,6 +1,6 @@
 # PR Summary
 
-Sci/Tech Reviewer: <!-- SR id, filled when known -->
+Sci/Tech Reviewer: <!-- SR id, filled by author when ready for review (e.g. @octocat) -->
 Code Reviewer: <!-- CR id, filled by SSD -->
 
 <!-- To be completed by the developer -->

.github/workflows/track-review-project.yaml

@@ -0,0 +1,17 @@
+name: Track Review Project
+
+on:
+  workflow_run:
+    workflows: [Trigger Review Project]
+    types:
+      - completed
+
+permissions:
+  actions: read
+  contents: read
+  pull-requests: write
+
+jobs:
+  track_review_project:
+    uses: MetOffice/growss/.github/workflows/track-review-project.yaml@main
+    secrets: inherit

.github/workflows/trigger-project-workflow.yaml

@@ -0,0 +1,17 @@
+name: Trigger Review Project
+
+on:
+  pull_request_target:
+    types: ["opened", "synchronize", "reopened", "edited", "review_requested", "review_request_removed", "closed"]
+  pull_request_review:
+  pull_request_review_comment:
+
+permissions:
+  actions: read
+  contents: read
+  pull-requests: write
+
+jobs:
+  trigger_project_workflow:
+    uses: MetOffice/growss/.github/workflows/trigger-project-workflow.yaml@main
+    secrets: inherit

.gitignore

@@ -3,3 +3,4 @@ __pycache__
 .idea
 *.pyc
 .pytest_cache
+bin/

CONTRIBUTORS.md

@@ -3,3 +3,5 @@
 | GitHub user | Real Name | Affiliation | Date |
 | ----------- | --------- | ----------- | ---- |
 | james-bruten-mo | James Bruten | Met Office | 2025-12-09 |
+| mo-jmanners | James Manners | Met Office | 2025-12-18 |
+| t00sa       | Sam Clarke-Green | Met Office | 20226-03-02 |

README.md

@@ -1,5 +1,5 @@
 
-# SOCRATES - Suite Of Community RAdiative Transfer codes based on Edwards and Slingo
+# Socrates - Suite Of Community RAdiative Transfer codes based on Edwards and Slingo
 
 ## Contributing Guidelines
 
@@ -38,11 +38,11 @@ Please be aware of and follow the Simulation Systems
 
 ## What's included?
 
-You should have received this package as a tar file containing the
-directories: src/ make/ data/ examples/ idl/ python/ man/ sbin/ docs/
+The Socrates package contains the following directories:
+src/ make/ data/ examples/ idl/ python/ man/ sbin/ docs/
 
-`src/` contains the source code in Fortran 95 (.f90) and a few remaining
-in Fortran 77 (.f).
+`src/` contains the source code in Fortran 2018 (.f90) and a few remaining
+in fixed Fortran format (.f).
 
 `make/` contains the Makefile which then accesses the various Mk_*
 files.
@@ -58,7 +58,7 @@ See the CONTENTS in each directory under examples/ for instructions.
 `idl/` and `python/` contain scripts to generate atmospheric profiles etc
 in netCDF format to be used as input for the radiation code (l_run_cdf).
 
-`docs/` contain the user guide and technical guide for the ES code.
+`docs/` contain the user guide and technical guide for the Socrates code.
 
 ## Compiling the source code within the Met Office
 
@@ -93,7 +93,7 @@ your local netCDF installation.
 The following commands can then be run to build the suite and setup
 your path to the executables and man pages:
 
-`./build_code`
+`./build_code`\
 `. ./set_rad_env`
 
 See previous section for building individual routines.
@@ -103,7 +103,7 @@ See previous section for building individual routines.
 There are a small number of utilities in sbin/ which are written
 in C and require compilation. A Makefile has been provided:
 
-`cd $RAD_SCRIPT`
+`cd $RAD_SCRIPT`\
 `make`
 
 ## Running the code
@@ -114,7 +114,7 @@ find up-to-date instructions for running the following routines:
 Two-stream and spherical harmonics radiance codes using netCDF or
 text CDL input files:
 
-`man Cl_run_cdf`
+`man Cl_run_cdf`\
 `man Cl_run_cdl`
 
 A Mie scattering code for determining optical properties of aerosol
@@ -131,8 +131,8 @@ a netCDF input file:
 
 Auxillary routines for format conversion, interpolation etc:
 
-`man Ccdf2cdl`
-`man Ccdl2cdf`
+`man Ccdf2cdl`\
+`man Ccdl2cdf`\
 `man Cinterp`
 
 These scripts are a command line interface to interactive routines in
@@ -146,12 +146,12 @@ of the code.
 
 The full suite has been tested with the following compilers:
 
-Intel ifort 19
+Intel ifort 19\
 GCC gfortran 12.2
 
-To use these compilers within the Met Office run, respectively:
-`./build_code azure_ifort19`
+To use these compilers within the Met Office run, respectively:\
+`./build_code azure_ifort19`\
 `./build_code azure_gfortran12`
 
-On the Monsoon3 collaboration machine:
+On the Monsoon3 collaboration machine:\
 `./build_code monsoon3_gfortran12`

docs/userguide/setup.tex

@@ -1,24 +1,13 @@
 \section{Obtaining the code}
-The master version of the radiation code is held under version control (FCM)
-on the Met Office Science Repository Service (MOSRS) at
-https://code.metoffice.gov.uk/trac/socrates/wiki. Development information and
-instructions are available from this page. Releases are
-made from specific revisions of the trunk and made available 
-as a self-contained tar package.
-
-To obtain the latest version of the code or to get an account on the MOSRS
-please email the radiation code owner at the Met Office, currently
-james.manners@metoffice.gov.uk. The code is freely available under a
-BSD 3-clause licence.
-
-Once extracted, instructions for compilation may be found within the
-distribution's {\tt README} file.
-
-The code is written in Fortran 95 and has primarily been tested with the Intel 
-ifort and GNU gfortran compilers. Scripts are written in the korn or bash
-shells and it is recommended that one of these is used as the command shell.
-A local installation of the netCDF fortran libraries and modules is also
-required if the netCDF functionality is to be used.
+The master version of the radiation code is available under a BSD 3-clause
+licence from:
+
+https://github.com/MetOffice/socrates
+
+The code is written in Fortran 2018 and has primarily been tested with the
+GNU gfortran and Intel ifort compilers. A local installation of the netCDF
+fortran libraries and modules is required if the netCDF functionality is to
+be used. Python scripts use Python 3 and shell scripts are written in bash.
 
 \section{Basic operation}
 

examples/corr_k/run_me

@@ -12,15 +12,6 @@ rm -f h2o* cfc113_* sp_lw_300_skel sp_lw_300_dev* 2>/dev/null
 (diff -q sp_lw_300_ifort19 sp_lw_300_dev && \
  diff -q sp_lw_300_ifort19_k sp_lw_300_dev_k && \
  echo 'Matched ifort19 output') || \
-(diff -q sp_lw_300_gfortran5 sp_lw_300_dev && \
- diff -q sp_lw_300_gfortran12_k sp_lw_300_dev_k && \
- echo 'Matched gfortran5 output') || \
-(diff -q sp_lw_300_gfortran14 sp_lw_300_dev && \
- diff -q sp_lw_300_gfortran12_k sp_lw_300_dev_k && \
- echo 'Matched gfortran14 output') || \
-(diff -q sp_lw_300_ifx2025 sp_lw_300_dev && \
- diff -q sp_lw_300_ifort19_k sp_lw_300_dev_k && \
- echo 'Matched ifx2025 output') || \
     ierr=1
 
 if [ $ierr -gt 0 ] ; then

examples/corr_k/sp_lw_300_gfortran12

@@ -693,80 +693,80 @@ Band        Gas, Number of k-terms, Scaling type and scaling function,
                    k-terms, weights and scaling parameters.
    38           1          25           2           9
           16           3
-    6.855526074E-02    1.116305875E-01
-    1.118926869E-01    3.246311641E-01
-    1.781988312E-01    1.595820674E-01
-    2.970448723E-01    9.198322503E-02
-    4.196899232E-01    1.380957141E-01
-    6.870224473E-01    5.935259667E-02
-    1.046824171E+00    4.117099863E-02
-    1.696177899E+00    2.898397207E-02
-    2.628001631E+00    1.418744278E-02
-    4.064672146E+00    1.139407290E-02
-    6.435955072E+00    5.597142879E-03
-    9.597127584E+00    4.997375960E-03
-    1.501864529E+01    2.197502923E-03
-    2.246286531E+01    1.798227906E-03
-    4.230366178E+01    1.398595931E-03
-    6.125028310E+01    3.995907007E-04
-    1.042954148E+02    3.997310639E-04
-    1.495949638E+02    1.994042944E-04
-    2.610139822E+02    3.997289287E-04
-    4.633185971E+02    1.998815333E-04
-    9.207124757E+02    2.003254742E-04
-    1.286669487E+03    4.004629938E-04
-    2.487411929E+03    2.000986592E-04
-    2.214546215E+04    2.003259859E-04
-    5.632833556E+04    3.997635885E-04
+    6.855530210E-02    1.116305875E-01
+    1.118927508E-01    3.246311641E-01
+    1.781989154E-01    1.595820674E-01
+    2.970450477E-01    9.198322503E-02
+    4.196901364E-01    1.380957141E-01
+    6.870228460E-01    5.935259667E-02
+    1.046824726E+00    4.117099863E-02
+    1.696178760E+00    2.898397207E-02
+    2.628003218E+00    1.418744278E-02
+    4.064674276E+00    1.139407290E-02
+    6.435959079E+00    5.597142879E-03
+    9.597132074E+00    4.997375960E-03
+    1.501865373E+01    2.197502923E-03
+    2.246287977E+01    1.798227906E-03
+    4.230369052E+01    1.398595931E-03
+    6.125034020E+01    3.995907007E-04
+    1.042954342E+02    3.997310639E-04
+    1.495948473E+02    1.994042944E-04
+    2.610140342E+02    3.997289287E-04
+    4.633190944E+02    1.998815333E-04
+    9.207135380E+02    2.003254742E-04
+    1.286670999E+03    4.004629938E-04
+    2.487414850E+03    2.000986592E-04
+    2.214548817E+04    2.003259859E-04
+    5.632840173E+04    3.997635885E-04
    39           1          21           2           9
           16           3
-    6.344574238E-02    4.292002901E-01
-    9.840383132E-02    1.859552493E-01
-    1.616351217E-01    9.576561004E-02
-    2.623682934E-01    8.934009293E-02
-    4.260435923E-01    7.196859566E-02
-    6.595488148E-01    4.999027814E-02
-    1.020214979E+00    3.019285343E-02
-    1.717868896E+00    1.939551066E-02
-    2.682645648E+00    8.798095724E-03
-    4.251690769E+00    7.797576705E-03
-    7.160648764E+00    3.599670535E-03
-    1.111950626E+01    2.798816642E-03
-    1.738754062E+01    1.599516217E-03
-    2.645471796E+01    1.198287199E-03
-    4.563969982E+01    7.998189499E-04
-    7.957449691E+01    3.991767198E-04
-    1.030866935E+02    1.996703490E-04
-    1.771155941E+02    2.010717355E-04
-    1.854368377E+03    1.999750716E-04
-    8.199880769E+03    3.997179288E-04
-    4.010096614E+04    2.001259593E-04
+    6.344578015E-02    4.292002901E-01
+    9.840387531E-02    1.859552493E-01
+    1.616351904E-01    9.576561004E-02
+    2.623684537E-01    8.934009293E-02
+    4.260438202E-01    7.196859566E-02
+    6.595492080E-01    4.999027814E-02
+    1.020215520E+00    3.019285343E-02
+    1.717869698E+00    1.939551066E-02
+    2.682647545E+00    8.798095724E-03
+    4.251692989E+00    7.797576705E-03
+    7.160653253E+00    3.599670535E-03
+    1.111951177E+01    2.798816642E-03
+    1.738754887E+01    1.599516217E-03
+    2.645472398E+01    1.198287199E-03
+    4.563972467E+01    7.998189499E-04
+    7.957456914E+01    3.991767198E-04
+    1.030868148E+02    1.996703490E-04
+    1.771154561E+02    2.010717355E-04
+    1.854370555E+03    1.999750716E-04
+    8.199890400E+03    3.997179288E-04
+    4.010101324E+04    2.001259593E-04
    40           1          24           2           9
           16           3
-    5.632058584E-02    2.594519662E-01
-    8.973787683E-02    7.565068374E-02
-    1.611243541E-01    1.360834280E-01
-    2.292427111E-01    1.667623585E-01
-    3.782409413E-01    1.242125670E-01
-    5.700832346E-01    7.172789487E-02
-    8.869159381E-01    6.652403433E-02
-    1.425175928E+00    3.506567722E-02
-    2.155125053E+00    2.244097923E-02
-    3.515643840E+00    1.542801990E-02
-    5.392173660E+00    8.818502594E-03
-    8.449778688E+00    6.613662508E-03
-    1.352652027E+01    3.006029523E-03
-    2.062082648E+01    3.005519226E-03
-    3.496416228E+01    1.601010524E-03
-    4.445143276E+01    4.010533312E-04
-    8.382448528E+01    6.014832924E-04
-    1.282033760E+02    6.010136104E-04
-    2.120188264E+02    6.012277336E-04
-    4.511161140E+02    2.002217476E-04
-    9.385649849E+03    2.005262441E-04
-    1.090855041E+04    2.007626698E-04
-    2.842839777E+04    4.010592342E-04
-    7.555108720E+04    4.003187207E-04
+    5.632062481E-02    2.594519662E-01
+    8.973792104E-02    7.565068374E-02
+    1.611244406E-01    1.360834280E-01
+    2.292428500E-01    1.667623585E-01
+    3.782411233E-01    1.242125670E-01
+    5.700835954E-01    7.172789487E-02
+    8.869163663E-01    6.652403433E-02
+    1.425176755E+00    3.506567722E-02
+    2.155126165E+00    2.244097923E-02
+    3.515645594E+00    1.542801990E-02
+    5.392176986E+00    8.818502594E-03
+    8.449783327E+00    6.613662508E-03
+    1.352652813E+01    3.006029523E-03
+    2.062083533E+01    3.005519226E-03
+    3.496416813E+01    1.601010524E-03
+    4.445145542E+01    4.010533312E-04
+    8.382449155E+01    6.014832924E-04
+    1.282035090E+02    6.010136104E-04
+    2.120190558E+02    6.012277336E-04
+    4.511166459E+02    2.002217476E-04
+    9.385660874E+03    2.005262441E-04
+    1.090856322E+04    2.007626698E-04
+    2.842843116E+04    4.010592342E-04
+    7.555117594E+04    4.003187207E-04
    79           8           1           2           9
           16           3
     1.160409005E+01    1.000000000E+00
@@ -2350,22 +2350,22 @@ Band        Continuum   scaling function followed by reference pressure and
        0.000000000E+00
    38           1           1
        1.000000000E+05       2.900000000E+02
-       7.765346800E-01      -4.965961823E-03      -3.037124136E+00
+       7.765346733E-01      -4.965961679E-03      -3.037124141E+00
    38           2           1
        1.000000000E+05       2.900000000E+02
-       6.385495959E-03       0.000000000E+00       0.000000000E+00
+       6.385495880E-03       0.000000000E+00       0.000000000E+00
    39           1           1
        1.000000000E+05       2.900000000E+02
-       7.302550188E-01      -3.297358580E-03      -3.159995537E+00
+       7.302550119E-01      -3.297359645E-03      -3.159995538E+00
    39           2           1
        1.000000000E+05       2.900000000E+02
-       5.597692585E-03       0.000000000E+00       0.000000000E+00
+       5.597692446E-03       0.000000000E+00       0.000000000E+00
    40           1           1
        1.000000000E+05       2.900000000E+02
-       6.035923903E-01       2.852919561E-03      -2.088988725E+00
+       6.035923915E-01       2.852919166E-03      -2.088988700E+00
    40           2           1
        1.000000000E+05       2.900000000E+02
-       6.949229624E-03       0.000000000E+00       0.000000000E+00
+       6.949229668E-03       0.000000000E+00       0.000000000E+00
    41           1           0
        1.000000000E+00       2.000000000E+02
        0.000000000E+00