Skip to content

Building

Andrew Kiss edited this page Jun 21, 2023 · 21 revisions

If you don't want to use a precompiled executable from /g/data/ik11/inputs/access-om3/bin/, you can build it yourself. Building access-om3 requires membership of the ik11 project - apply at https://my.nci.org.au/mancini/project/ik11 if needed.

First clone access-om3 following the steps in the README. Then do

cd access-om3
./build.sh

After a little while you'll get shiny new executables:

bin/access-om3-CICE6-WW3-<hash>
bin/access-om3-MOM6-CICE6-<hash>
bin/access-om3-MOM6-CICE6-WW3-<hash>
bin/access-om3-CICE6-WW3-Debug-<hash>
bin/access-om3-MOM6-CICE6-Debug-<hash>
bin/access-om3-MOM6-CICE6-WW3-Debug-<hash>

These are labelled by the included model components and the git hash of the access-om3 repository so you can identify the sources they were built with. If the executable names also have a -modified suffix, this indicates that there were untracked files or uncommitted changes. If this happens it's a good idea to commit the changes and re-build so the executable sources are identifiable from the name of each executable.

The -Debug versions may be useful for getting more information on model crashes, but should not be used for production runs as they are much slower.

Customising the included components (if needed)

build.sh invokes cmake in pairs. The first of each pair determines the included model components. By default the executable will have WW3, MOM6 and CICE enabled. If you'd like to change this, add the following to the first invocation of CMake in build.sh:

-DENABLE_WW3=ON -DENABLE_MOM6=ON  -DENABLE_CICE=ON

and replace ON with OFF where required (note that the default is ON for all components). You'd probably also want to change the executable name to specify the components used.

A note on dependencies

ACCESS-OM3 has several dependencies which are unavailable from NCI, so we supply them via Spack using https://github.com/COSIMA/spack-config which is installed in /g/data/ik11/spack/.

TODO

Clone this wiki locally