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-ems1.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:
- MOM5 ocean model
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 assumed to be global extent with nominal 1 degree resolution.
Some examples of possible values of the specifiers:
- scenario:
historical,preindustrial,ssp126 - modifier:
concentration,interactiveC,noLUC
where scenario is typically a CMIP experiment identifier, concentration and interactiveC describe the CO2 cycling protocol, and noLUC is no land-use change.
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: - dev-preindustrial+concentrations - dev-preindustrial+emissions - dev-4xCO2+concentrations - dev-1pctCO2 - dev-amip
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:
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.