Request access to AM3 configurations

The ACCESS-AM3 model is a global atmosphere and land coupled model, optionally including the atmospheric chemistry and land biogeochemistry. Some model components, as well as the configurations, are covered by a proprietary licence from the UK Met Office and the Momentum Partnership. As such, they can only be made available to people covered by the licence agreement.

Before we can grant you access to ACCESS-AM3 configurations, we MUST verify you are covered by the licence. If you haven’t used a model covered by the UKMO Momentum licence before:

Once you have finished the process, contact us with your full name and GitHub handle. We will verify that you are properly licensed, then grant you access to the relevant repositories.

If you need to modify any source code, you will need to be part of the MetOffice’s GitHub organisation. See these instructions to gain access. The process can be slow. Once you are part of the MetOffice’s GitHub organisation, contact us with your full name and GitHub handle and let us know what access you need.

Hello, I’d like access to the AM3 config. My GitHub handle is sfiddes, full name Sonya Fiddes. Initially I just want to look at the configuration and may change it to suite my needs, in the long term I will be changing the souce code. Thanks!

@sonyafiddes , I’ve sent you an invite with read access to the configuration.

If you want to save your own configurations to GitHub, then please make your own fork of the repository. If you think a configuration you developed would be helpful to the community and should be considered a standard, supported configuration, open an issue on GitHub and tag myself (ccarouge on GitHub), Lachlan (Whyborn) and Ben (bschroeter).

Hello, I’d also like to test AM3, including modifying the source code.

mosrs: matthewwoodhouse

github: matt-woodhouse

@Matt_Woodhouse , you haven’t said which source code you would want to modify. I’ve invited you to the UM and JULES repositories. I’ve also invited you to the ACCESS-AM3 deployment repository so you can follow the recommended building process: Create Prereleases and Releases for an ACCESS Model - ACCESS-Hive Docs

If you need help with the building process, please reach out on the forum or on the ACCESS-AM3 repository.

Once you have a new build, you need to change the values for the following options in the ACCESS-AM3 configuration:

SPACK_MODULE_USE='/g/data/vk83/modules'
SPACK_BUILD='access-am3/2025.10.000'

(in rose-suite.conf)

Thanks Claire - will also need access to the UKCA repo if on github!

UKCA is still picked up from MOSRS:

ukca_sources=branches/dev/martindix/um13.1_cable_deposition@3051
            =branches/dev/martinwillett/um13.1_BlackCarbonRho1900@981

Which means it is going to be harder to build through Spack with a modified UKCA code.

Just get yourself acquainted with AM3 and we’ll get back to you for the build.

UKCA is now a public repo on github if that helps GitHub - MetOffice/ukca: United Kingdom Chemistry and Aerosols

Hello, my name is Quentin Rossier. my GitHub is qro4. I have an active MOSRS account and would like to request access to the ACCESS-AM3 configurations to run forcing experiments. Specifically, I plan to run AMIP-style ACCESS-AM3 N96 simulations with modified climatological SST boundary conditions to isolate the atmospheric response to different ENSO types. I intend to modify and run the configurations only, I do not anticipate needing to modify the model source code.

Thanks in advance for your help.

Given you write privileges to the configs. Remember to always push your changes to one of your own branches and then open a pull request if you want to merge your changes back into an existing branch- unfortunately we cannot add branch protections to this repo as it’s private.

Hi, I’m Linyuan, and my GitHub handle is Linyuan-Sun. I have completed the UKMO/MOSRS licensing process and I’m waiting for the account to be activated. I would like access to the ACCESS-AM3 configurations repository to run AM3 experiments. I expect to modify and run configurations first, but also plan to modify the model source code for conducting tropical-heating forced experiment.

Thank you.

Granted write permissions to the configs repository. As always, please make sure to push your changes to a branch of your own first, before merging back into the core development branches, since we can’t apply branch protections to private repos.

Hi I am Valentina Garcia. My GitHub handle is mvgarcia. I have a MOSRS account and have signed all the licenses required. I would like access to the AM3 code and I would only modify the configurations. Thanks!

Hi @mvgarcia , I gave you access to the configurations: https://github.com/ACCESS-NRI/access-am3-configs

Since you will not change the source code, that’s the only private repository you need access to. You can find some information on the configurations here: https://access-am3-configs.access-hive.org.au/ , although it needs expanding.

The instructions on how to run AM3 are being rewritten now and will be available at some point during the week. You can still use the alpha release and the instructions from the alpha release as a starting point.

@Linyuan , to be granted access to the source code, you will need to have access to the MetOffice’s GitHub organisation. Please see this post for information on the process.

Note that the process can be slow.

Hi Claire, thanks for guiding me through this.

I have signed the UKMO Terms of Use agreement, but I am currently waiting for my MOSRS account to be activated. In the meantime, I received your GitHub invitations to the ACCESS-NRI/UM and ACCESS-NRI/JULES repositories. However, when I click “accept”, both links lead to a 404 page.

Is this expected while the MOSRS account is still being processed, or should I ask for the invitations to be resent? Thanks!

That’s not expected- are you definitely signed in to your Github on the device you’re using? Our copies of UM and JULES are not actually forks of the UK Met Office’s upstream repositories, unlike the other components (e.g. casim, UKCA), just copies of the original repository, so being part of the UKMO Github org shouldn’t be a requirement for that.

Sorry, @Linyuan , I have rescinded the invitations when I have seen you are not part of the MetOffice’s GitHub organisation (and thought GitHub would send a message but apparently not).

Please let us know when you get access to the MetOffice’s GitHub. We will be moving the UM and JULES repositories to be forks of the MetOffice’s repositories and you would lose access at that point if you are not part of the MetOffice’s organisation.

No worry, Claire. I’ll let you know once my MOSRS account is ready. Thanks!