Skip to content

Home

Welcome to the documentation for the ACCESS-ESM1.6 model configurations!

ACCESS-ESM1.6 Documentation Overview

See the navigation links on the left. Some reading tips, see:

access-esm1.6-configs Overview

ACCESS-ESM1.6 configurations are provided via branches in the access-esm1.6-configs GitHub repository. The access-esm1.6-configs repository contains several configurations using the following components:

All the configurations use the Payu workflow management tool, and pre-built executables available on NCI.

Repository structure

The main branch does not store any model configurations, only documentation.

Each configuration in github.com/ACCESS-NRI/access-esm1.6-configs repository is stored as a git branch. Most of the branches are named according to the following naming scheme:

release-{scenario}[+{modifier}]

where release signifies this is the release branch that is tested, versioned and ready for use, scenario is the base experimental design with optional modifiers. All configurations are global with nominal 1 degree resolution.

  • scenario is based around the CMIP experiment identifiers, examples include historical, preindustrial, 4xCO2.
  • modifier can be concentrations or emissions to describe the CO2 cycling protocol, or CN to include the carbon and nitrogen cycles but excluding the phosphorus cycle in the land.

These names do not exactly match CMIP7 experiment names, we use +concentrations modifier for concentration driven experiments (these are more similar to CMIP6 experiments, and do not have esm in their names) and +emissions for emissions driven experiments (those with the esm- prefix in their CMIP7 name).

Supported configurations

All available configurations are browsable under the list of release branches. There are currently no released configurations.

These configurations are under active development:

Where changes are made, they should be applied to all these branches (where relevant) by pull requests. These comparisons can assist with understanding differences between configurations:

There were some configurations previously under development that have now been archived. These were +CN only, i.e. including the carbon and nitrogen cycles but excluding the phosphorus cycle in the land and are available for reference:

If you need assistance to use git to update these configurations, please ask on the ACCESS-Hive forum.

How to use this repository to run a model

All configurations use payu to run the model.

This repository contains many related experimental configurations to make support and discovery easier. As a user it does not necessarily make sense to clone all the configurations at once.

In most cases only a single experiment is required. If that is the case, choose which experiment and then run

git clone -b <experiment> https://github.com/ACCESS-NRI/access-esm1.6-configs <experiment>

and replace <experiment> with the branch name or tag of the experiment you wish to run.

ACCESS-Hive contains detailed instructions for how to configure and run ACCESS models with payu.

CI and Reproducibility Checks

This repository makes use of GitHub Actions to perform reproducibility checks on model config branches.