Instructions for the Coupled Model

How to build

Can be found at this link.

To make your life easy, following is a summary:

1. ml GEOSenv
2. cd <your_dir>
3. git clone -b v10.23.1 [email protected]:GEOS-ESM/GEOSgcm.git See here for full details. Its obvious that we are building a set version, i.e., v10.23.1 (released on Nov 18, 20222) which will facilitate reproducibility.
4. cd GEOSgcm/
5. parallel_build.csh

Check: grep 'exit ' parallel_build.oxx; xx is a number that is generated by slurm when the build job is submitted to queue. If you get:

exit 0

all went okay!

How to set up an experiment

• https://github.com/GEOS-ESM/GEOSgcm#run-the-gcm use gcm_setup, is same as for the uncoupled model, please see ⬇️ for differences.

• Note following that are relevant to coupled model:

   ...
   ...
   Do you wish to run the COUPLED Ocean/Sea-Ice Model? (Default: NO or FALSE)
   YES
  
   Choose an Ocean Model: (Default: MOM5)
   MOM5
   _or_
   MOM6
  
   Enter the Ocean Lat/Lon Horizontal Resolution: IM JM (Default: 360 210)
  
   Enter the Ocean Model Vertical Resolution: LM (Default: 50)
  
   ...
   ...
  
   Enter the directory (/filename) of the HISTORY.AGCM.rc.tmpl to use
   (To use HISTORY.AGCM.rc.tmpl from current build, Type:  Current         )
   -------------------------------------------------------------------------
   Hit ENTER to use Default Location: (HISTORY.AOGCM.rc.tmpl)
  

• If the horizontal and/or vertical resolutions are not the default values, it is the user's burden to provide all other files and resources for a functional model run. Available resolutions are:

  • MOM5: c90x72 atmosphere, 360x200x50 ocean
  • MOM6: c90x72 atmosphere, 360x210x50 ocean

How to run

In the experiment directory, use gcm_run.j (this step is same as for the uncoupled model).