Difference between revisions of "ACCESS-ESM 1.5"

(Post-Processing)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Needs Update|Needs update for Gadi}}
+
 
{{Stub}}
 
 
This page describes the different configurations of ACCESS-ESM 1.5 currently available and how to access them.  
 
This page describes the different configurations of ACCESS-ESM 1.5 currently available and how to access them.  
  
Line 9: Line 8:
 
! Submodel !! Model !! Version !! Notes
 
! Submodel !! Model !! Version !! Notes
 
|-
 
|-
| Atmosphere || {{UM}} || 7.3 ||
+
| Atmosphere || [[UM]] || 7.3 ||
 
|-
 
|-
| Land Surface || {{CABLE}} || Part of UM ||
+
| Land Surface || [[CABLE]] || Part of UM ||
 
|-
 
|-
 
| Sea Ice || CICE || ||
 
| Sea Ice || CICE || ||
 
|-
 
|-
| Ocean || {{MOM}} || 5 ||
+
| Ocean || [[MOM]] || 5 ||
 
|-
 
|-
 
| Coupler || OASIS-MCT || 3 ||
 
| Coupler || OASIS-MCT || 3 ||
Line 28: Line 27:
 
Please contact [mailto:cws_help@nci.org.au the CMS team] if you would like a configuration that isn't currently available in payu or if you have any problems running a ACCESS-ESM 1.5 simulation with payu.
 
Please contact [mailto:cws_help@nci.org.au the CMS team] if you would like a configuration that isn't currently available in payu or if you have any problems running a ACCESS-ESM 1.5 simulation with payu.
  
== piControl ==
+
* [https://github.com/coecms/esm-pre-industrial piControl]
 +
* [https://github.com/coecms/esm-historical historical]
 +
* [https://github.com/coecms/esm-ssp585 ssp585]
 +
* [https://github.com/coecms/esm-pmip-last-mil last millenium]
 +
* [https://github.com/coecms/esm-mh mid holocene]
 +
* [https://github.com/coecms/esm-lig last interglacial]
 +
 
 +
== Model Spinup ==
 +
 
 +
If starting from scratch the model will take some time to spin up. It's recommended that you branch off of piControl, which has already been spun up, rather than starting a run from scratch (except for SSP runs, which will branch from historical)
 +
 
 +
The script 'warm-start.sh' in the Payu experiment directory will set up restart files based on an existing run
 +
 
 +
== Using Payu ==
 +
 
 +
1. Load the [[Conda]] environment to access Payu
 +
<syntaxhighlight>
 +
module use /g/data/hh5/public/modules
 +
module load conda/analysis3
 +
</syntaxhighlight>
 +
 
 +
2. Download the Payu experiment configuration
 +
<syntaxhighlight>
 +
git clone https://github.com/coecms/esm-historical
 +
</syntaxhighlight>
 +
 
 +
3. Edit and run the warm-start script if needed
 +
<syntaxhighlight>
 +
./warm-start.sh
 +
</syntaxhighlight>
 +
 
 +
4. Run the model
 +
<syntaxhighlight>
 +
payu run
 +
</syntaxhighlight>
 +
 
 +
Each 'payu run' submission will run the model for one model year. You can run multiple years with e.g. 'payu run -n 25' - Payu will automatically resubmit the run after each year has finished.
 +
 
 +
We recommend inspecting the model output after running for a year or so to make sure it's behaving as desired, especially if it's a non-standard configuration
 +
 
 +
== Post-Processing ==
 +
 
 +
Post-processing scripts to convert atmosphere output to NetCDF format and move the output to /g/data are available at https://git.nci.org.au/cm2704/ACCESS-Archiver. This can be run at any stage of the run, and will only process files that haven't yet been archived.
 +
 
 +
Publication of runs to ESGF requires further processing to put the data in CMOR format. We recommend working with CSIRO for this so all ACCESS runs are consistent, contact us at cws_help@nci.org.au for more information.
 +
 
 +
== Experiment Details ==
 +
 
 +
=== piControl ===
 
You can download the configuration by typing
 
You can download the configuration by typing
 
<syntaxhighlight lang="bash">$ git clone https://github.com/coecms/esm-pre-industrial.git
 
<syntaxhighlight lang="bash">$ git clone https://github.com/coecms/esm-pre-industrial.git
Line 37: Line 84:
 
Default configuration, based off CSIRO ksh scripts
 
Default configuration, based off CSIRO ksh scripts
  
== PMIP4 Runs ==
+
=== PMIP4 Runs ===
 
Main Page:[[ACCESS-ESM-PMIP4|ACCESS-ESM-PMIP4]]
 
Main Page:[[ACCESS-ESM-PMIP4|ACCESS-ESM-PMIP4]]
  
Line 47: Line 94:
 
Science Contacts: Nick Yeung, Laurie Menviel
 
Science Contacts: Nick Yeung, Laurie Menviel
  
Note: In addition to changed MMRs for certain gases, it also needs an updated UM build with different orbital parameters. This updated UM build is at
+
Note: In addition to changed MMRs for certain gases, it also needs an updated UM build with different orbital parameters. This updated UM build is on gadi at
<syntaxhighlight lang="bash">/short/public/access-esm/payu/bin/coe/um_hg3.exe-20190412-pmip-r327
+
<syntaxhighlight lang="bash">/g/data/access/payu/access-esm-pmip/pmip-li/bin/um_hg3_20200706_pmip-li_r344.exe
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Line 55: Line 102:
  
 
Note: In addition to changed MMRs for certain trace gasses, it also needs and updated UM build with different orbital parameters. This updated UM build is at
 
Note: In addition to changed MMRs for certain trace gasses, it also needs and updated UM build with different orbital parameters. This updated UM build is at
<div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;"><tt>/short/public/access-esm/payu/bin/coe/um_hg3.exe-20190717-pmip-mh-r335</tt></div>
+
<div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;"><tt>/g/data/access/payu/access-esm-pmip/pmip-mh/bin/um_hg3_20200706_pmip-mh_r345.exe</tt></div>
  
 
= CSIRO KSH Scripts =
 
= CSIRO KSH Scripts =
  
 
CSIRO is running the ACCESS-ESM model using ksh shell scripts. If you need to know, you can look [[ACCESS-ESM-CSIRO|here]].
 
CSIRO is running the ACCESS-ESM model using ksh shell scripts. If you need to know, you can look [[ACCESS-ESM-CSIRO|here]].
 
 
  
  
 
[[Category:ACCESS 1.5]] [[Category:Coupled Models]]
 
[[Category:ACCESS 1.5]] [[Category:Coupled Models]]

Latest revision as of 19:39, 21 July 2021

This page describes the different configurations of ACCESS-ESM 1.5 currently available and how to access them.

ESM stands for Earth System Model. ACCESS-ESM is a coupled model with the following components:

Submodel Model Version Notes
Atmosphere UM 7.3
Land Surface CABLE Part of UM
Sea Ice CICE
Ocean MOM 5
Coupler OASIS-MCT 3

Payu Experiments

We strongly recommend that you run ACCESS-ESM 1.5 using the payu driver. CSIRO is running the CMIP6 submission runs using a setup based on KSH scripts. The CMS team is working to adapt those configurations to payu.

Please contact the CMS team if you would like a configuration that isn't currently available in payu or if you have any problems running a ACCESS-ESM 1.5 simulation with payu.

Model Spinup

If starting from scratch the model will take some time to spin up. It's recommended that you branch off of piControl, which has already been spun up, rather than starting a run from scratch (except for SSP runs, which will branch from historical)

The script 'warm-start.sh' in the Payu experiment directory will set up restart files based on an existing run

Using Payu

1. Load the Conda environment to access Payu

module use /g/data/hh5/public/modules
module load conda/analysis3

2. Download the Payu experiment configuration

git clone https://github.com/coecms/esm-historical

3. Edit and run the warm-start script if needed

./warm-start.sh

4. Run the model

payu run

Each 'payu run' submission will run the model for one model year. You can run multiple years with e.g. 'payu run -n 25' - Payu will automatically resubmit the run after each year has finished.

We recommend inspecting the model output after running for a year or so to make sure it's behaving as desired, especially if it's a non-standard configuration

Post-Processing

Post-processing scripts to convert atmosphere output to NetCDF format and move the output to /g/data are available at https://git.nci.org.au/cm2704/ACCESS-Archiver. This can be run at any stage of the run, and will only process files that haven't yet been archived.

Publication of runs to ESGF requires further processing to put the data in CMOR format. We recommend working with CSIRO for this so all ACCESS runs are consistent, contact us at cws_help@nci.org.au for more information.

Experiment Details

piControl

You can download the configuration by typing

$ git clone https://github.com/coecms/esm-pre-industrial.git

The website of the configuration also contains detailed instructions on how to run the model.

Default configuration, based off CSIRO ksh scripts

PMIP4 Runs

Main Page:ACCESS-ESM-PMIP4

Currently contains two models from the PMIP4 setting: Last Interglacial and Mid-Holocene.

Please refer to the main page to know where to download the configurations from.

Last Interglacial

Science Contacts: Nick Yeung, Laurie Menviel

Note: In addition to changed MMRs for certain gases, it also needs an updated UM build with different orbital parameters. This updated UM build is on gadi at

/g/data/access/payu/access-esm-pmip/pmip-li/bin/um_hg3_20200706_pmip-li_r344.exe

Mid-Holocene

Science Contacts: Josephine Brown

Note: In addition to changed MMRs for certain trace gasses, it also needs and updated UM build with different orbital parameters. This updated UM build is at

/g/data/access/payu/access-esm-pmip/pmip-mh/bin/um_hg3_20200706_pmip-mh_r345.exe

CSIRO KSH Scripts

CSIRO is running the ACCESS-ESM model using ksh shell scripts. If you need to know, you can look here.