Release

This is an Alpha Release, intended for use by experienced users and collaborators. Any model configuration and related source code information on this page may change during the release process.

ACCESS-AM3 configurations ACCESS-AM3 configs docs Release notes

Run ACCESS-AM3

About

The instructions below outline how to run ACCESS-AM3 using ACCESS-NRI's software deployment pipeline, specifically designed to run on the National Computational Infrastructure (NCI) supercomputer Gadi.

If you are unsure whether ACCESS-AM3 is the right choice for your experiment, take a look at the overview of ACCESS Models.

All ACCESS-AM3 configurations are licensed under the UKMO's Momentum licence. ACCESS-AM3 is delivered to the community through private GitHub repositories. See the Request access prerequisite for details.

ACCESS-AM3 release notes are available on the ACCESS-Hive Forum and are updated when new releases are made available.

Prerequisites

Warning

Before continuing, make sure you have read the guide on running models using Rose/Cylc.

In addition to the prerequisites for Rose/Cylc, you will need:

• Request access to the configurations
  To request access to the configurations repository (and associated model component repositories), please contact us through the ACCESS-Hive Forum. This step will also allow us to check you are properly licensed to use the software.

• Join NCI projects
  Join the following projects by requesting membership on their respective NCI project pages:

  • access
  • ki32
  • ki32_mosrs
  • vk83
  • xp65

  Tip

  To request membership for the ki32_mosrs subproject, you need to:

  • already be member of the ki32 project
  • have a MOSRS account

  Warning

  You will not be granted access to some of the projects listed here before we have checked you are properly licensed to use the software. Ensure you request access to the configurations first.

  For more information on joining specific NCI projects, refer to How to connect to a project.

Get ACCESS-AM3 configuration

Follow the instructions for Model configurations stored on GitHub using the following specific information:

• Repository: git@github.com:ACCESS-NRI/access-am3-configs.git
• Branch: main

Initial Setup

Before you can run ACCESS-AM3 configuration, you need to specify which projects you want to use for data storage and compute resources. For this, in the configuration directory open the rose-suite.conf_nci_gadi file and change:

• root_dir to the path you want to use as a work directory for running the simulation. A space under /scratch/<project> is ideal, where <project> is the project associated with the current work. The directory will be created by the suite if it does not exist.
• STORAGE_PROJECT must be the same project as used in the root_dir path.
• COMPUTE_PROJECT to any project you want to be charged for the compute resources.

Now the configuration can be run using the Run the model configuration instructions.

Inspecting the outputs

The netCDF outputs are placed in ~/cylc-run/<suite-id>/share/data/History_Data/netCDF. The outputs in UM Fieldsfiles format are placed in ~/cylc-run/<suite-id>/share/data/History_Data.

Further Information

See ACCESS-AM3 configuration documentation for more detailed information about ACCESS-AM3 configuration.