Introduction¶
Some helpful external links:
MPAS website: https://mpas-dev.github.io
MPAS-Ocean User’s Guide includes a quick start guide and description of all flags and variables.
Test cases for latest release version:
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:
LANL IC: config.ocean_LANL_IC
NERSC: general.config.ocean_cori
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/