Introduction

Some helpful external links:

Setting config options for ocean test cases

This documentation is similar to Setting up a test case, with some details that are specific to the ocean core. If you are new to MPAS-Ocean, it is easiest to download a prepared test case.

If you want to set up a test case with COMPASS, you first need to set some config options. The file general.config.ocean is a template showing which paths need to bet set in order to set up ocean test cases. If you are using LANL IC (Grizzly or Badger) or NERSC (Cori), you can use these example files, which give the paths mark-petersen’s uses:

You should change the directories /turquoise/usr/projects/climate/mpeterse/repos/compass/branchName/MPAS-Model/ocean/develop or /global/homes/m/mpeterse/repos/model/pr_intel to the directory for your own code wherever it appears in the file.

Alternatively, you can make a copy of general.config.ocean (e.g. to config.ocean) and set the options as follows. In six places, replace FULL_PATH_TO_MPAS_MODEL_REPO with the path where you have checked out (and built) the branch of E3SM-Project/E3SM or MALI-Dev/E3SM you are planning to use.

Three other paths are required, mesh_database, initial_condition_database and bathymetry_database, are used for storing pre-generated mesh files, data sets for creating initial conditions, and bathymetry data. These can be empty directories, in which case meshes and other data sets will be downloaded as required during test-case setup. (If a test case appears to hang during setup, it is most likely downloading mesh, initial-condition or bathymetry data.)

On LANL IC, the shared data bases can be found at:

mesh_database = /usr/projects/regionalclimate/COMMON_MPAS/ocean/grids/mesh_database
initial_condition_database = /usr/projects/regionalclimate/COMMON_MPAS/ocean/grids/initial_condition_database
bathymetry_database = /usr/projects/regionalclimate/COMMON_MPAS/ocean/grids/bathymetry_database

On NERSC (Cori), the shared data bases can be found at:

mesh_database = /project/projectdirs/e3sm/mpas_standalonedata/mpas-ocean/mesh_database/
initial_condition_database = /project/projectdirs/e3sm/mpas_standalonedata/mpas-ocean/initial_condition_database/
bathymetry_database = /project/projectdirs/e3sm/mpas_standalonedata/mpas-ocean/bathymetry_database/