Difference between revisions of "Unified Model"

m
(Getting Started)
 
(17 intermediate revisions by the same user not shown)
Line 6: Line 6:
 
= Getting Started =
 
= Getting Started =
  
The UM is configured through a graphical interface, which is run from the server [[Accessdev|accessdev.nci.org.au]]. See [https://accessdev.nci.org.au/trac/wiki/GettingConnected Setting up the environment] for how to connect.
+
The UM is configured through a graphical interface, which is run from the server [[Accessdev]]. Follow the [[Accessdev#Getting_Set_Up|Set Up Instructions]] for the version of the model you want to run.
  
*[https://code.metoffice.gov.uk/doc/um/latest/papers/umdp_000.pdf Unified Model User's Guide]
+
There are two ways to run the model. Newer versions (post UM 10) use Rose & Cylc, older versions (pre UM 10) use a program called UMUI.
*[https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM Documentation Papers]
+
 
*[http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2017 UM User Tutorial 2017]
+
The Met Office have a tutorial for the model at https://code.metoffice.gov.uk/doc/um/latest/
  
There are two ways to run the model. Older versions (pre UM 10) use a program called [[UMUI|UMUI]], newer versions (post UM 10) use [[Rose_&_Cylc|Rose & Cylc]]
+
A variety of model configurations are within the Centre. Feel free to contact CMS to discuss the different model types and what might be most appropriate for your work. If you plan on contributing work to the Met Office make sure you use the most recent version of the model.
  
 
= UM 10 / Global Atmosphere / ACCESS 2.x =
 
= UM 10 / Global Atmosphere / ACCESS 2.x =
Line 20: Line 20:
 
ARCCSS researchers need to email [mailto:climate_help@nci.org.au climate_help@nci.org.au] to request an account on the Met Office server.
 
ARCCSS researchers need to email [mailto:climate_help@nci.org.au climate_help@nci.org.au] to request an account on the Met Office server.
  
== Links & More Information ==
+
=== Links & More Information ===
  
 
*[https://accessdev.nci.org.au/trac/wiki/GettingConnected Connecting to Accessdev and running Rose]  
 
*[https://accessdev.nci.org.au/trac/wiki/GettingConnected Connecting to Accessdev and running Rose]  
 
*[[Running_the_UM_with_Rose|Tips on using Rose with the UM]]  
 
*[[Running_the_UM_with_Rose|Tips on using Rose with the UM]]  
 +
* [http://nespclimate.com.au/wp-content/uploads/2020/10/Instruction-document-Getting_started_with_ACCESS.pdf Getting Started with ACCESS]
 
*[https://code.metoffice.gov.uk/trac/um UM code & issue tracker]  
 
*[https://code.metoffice.gov.uk/trac/um UM code & issue tracker]  
 
*[https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM 10.X Documentation]  
 
*[https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM 10.X Documentation]  
Line 30: Line 31:
 
*[http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2016 UM User Tutorial 2016]  
 
*[http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2016 UM User Tutorial 2016]  
  
*[[GA7_Performance|GA7 Performance]]  
+
*[[GA7_Performance|GA7 Performance]]
  
= UM 7.3 / ACCESS 1.x =
+
= Pre-UM 10 =
  
The ACCESS climate model as used in CMIP5 uses model version 7.3. This version of the model uses the older `UMUI` user interface
+
See [[Unified Model pre10]] for documentation on older versions of the model
 
 
== Links & More Information ==
 
 
 
*[[UM_Environment|Setting up the UMUI environment]]  
 
*[[Introduction_to_UMUI|Introduction to UMUI]]
 
*[https://accessdev.nci.org.au/umdocs/7.3 UM 7.3 Documentation]
 
*[http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2013 UM User Tutorial 2013]
 
  
 
= Experiments =
 
= Experiments =
Line 51: Line 45:
 
*[[ACCESS_2.0|ACCESS 2.0]]  
 
*[[ACCESS_2.0|ACCESS 2.0]]  
 
*[[ACCESS-ESM|ACCESS-ESM]]  
 
*[[ACCESS-ESM|ACCESS-ESM]]  
*[[GlobalAtmosphere|GA 7]]  
+
*[[Global Atmosphere|GA 7]]  
*[[Nesting_Suite|Nesting Suite]]  
+
*[[U-aa753_Nested_Suite|Nesting Suite]]
  
 
= Guides =
 
= Guides =
  
Assorted information on running the UM and available job configurations is listed in the sections below. Feel free to email [[mailto:climate_help@nci.org.au| climate_help@nci.org.au]] if you have any difficulties using the UM or suggestions for how we can make using the UM simpler.
+
Assorted information on running the UM and available job configurations is listed in the sections below. Feel free to email [mailto:cws_help@nci.org.au climate_help@nci.org.au] if you have any difficulties using the UM or suggestions for how we can make using the UM simpler.
  
 
*[[Getting_Help_with_the_UM|Getting Help with the UM]]  
 
*[[Getting_Help_with_the_UM|Getting Help with the UM]]  
Line 63: Line 57:
 
== Starting Up ==
 
== Starting Up ==
  
*[[New_UM_User_message|New UM User message]]
+
*[[Running_the_UM_with_Rose|Running the UM with Rose]]
*[[Building_the_UM|Building the UM]]
+
*[[UM_Helper_Scripts|UM Helper Scripts]]
*[[Standard_UM_Runs|Standard UM Runs]]
 
*[[Restarting_UM_Runs|Running the UM using automatic resubmission]]
 
*[[Recovering_from_an_interrupted_job|Recovering from an interrupted job]]  
 
*[[UM_Helper_Scripts|UM Helper Scripts]]
 
*[[Moving_UM_jobs_to_Raijin|Moving UM jobs to Raijin]]
 
*[[Running_the_UM_with_Rose|Running the UM with Rose]]  
 
  
 
== Run Types ==
 
== Run Types ==
Line 79: Line 67:
 
*[[KPP_Coupling|KPP Coupling]]  
 
*[[KPP_Coupling|KPP Coupling]]  
 
*[https://trac.nci.org.au/trac/access/wiki/APS1_ACCESS_C ACCESS-C High-resolution NWP]  
 
*[https://trac.nci.org.au/trac/access/wiki/APS1_ACCESS_C ACCESS-C High-resolution NWP]  
*[[UM_Nested_Models|UM Nested Models]]
+
*[[UM_Nested_Models|Nested / Limited Area Models]]  
*[[Limited_Area|Limited Area]]  
+
*[[UKCA|UKCA Chemistry]]  
*[[UKCA|UKCA]]  
 
  
 
*[http://www.ukca.ac.uk/wiki/index.php/UKCA_&_UMUI_Tutorials UKCA Tutorials]  
 
*[http://www.ukca.ac.uk/wiki/index.php/UKCA_&_UMUI_Tutorials UKCA Tutorials]  
*[https://trac.nci.org.au/trac/access/wiki/AccessModelExperimentLibrary CAWCR's ACCESS experiment library] (log in with your NCI account)  
+
*[https://trac.nci.org.au/trac/access/wiki/AccessModelExperimentLibrary CAWCR's ACCESS experiment library] (log in with your NCI account)
  
 
= Common Errors =
 
= Common Errors =
Line 96: Line 83:
  
 
*[[UM_Ancillary_files|UM Ancillary files]]  
 
*[[UM_Ancillary_files|UM Ancillary files]]  
*[[Concatenate_AMIP_Ancillaries|Concatenate AMIP Ancillaries]]
 
*[[Copying_CO2_values|Copying CO2 values]]
 
 
*[[Modifying_UM_Files|Modifying UM files with Mule]]  
 
*[[Modifying_UM_Files|Modifying UM files with Mule]]  
 +
*[[SCM_with_ERA-Interim|SCM with ERA-Interim]]
  
 
== Job Output ==
 
== Job Output ==
  
 
*[[Using_STASH|Using STASH]]  
 
*[[Using_STASH|Using STASH]]  
*[[Copying_STASH_settings_between_jobs|Copying STASH settings between jobs]]
 
 
*[[UM_Filenames|UM output filename convention]]  
 
*[[UM_Filenames|UM output filename convention]]  
 
*[[Analysing_UM_outputs|Analysing UM outputs & Converting to NetCDF]]  
 
*[[Analysing_UM_outputs|Analysing UM outputs & Converting to NetCDF]]  
Line 112: Line 97:
 
== Modifying the UM ==
 
== Modifying the UM ==
  
*[[UM_Source_Control|UM Source Control]]  
+
*[https://code.metoffice.gov.uk/trac/um/wiki/working_practices Met Office UM Development Working Practices]  
*[[User_fields|User fields]]
+
*[[Adding New Fields to STASH]]  
*[[Oasis_Coupling_with_the_UM|Oasis Coupling with the UM]]
 
*[[Oasis_coupling_in_UM_8.5|Oasis coupling in UM 8.5]]  
 
 
*[[Profiling_with_IPM_and_Vampir|Profiling MPI]]  
 
*[[Profiling_with_IPM_and_Vampir|Profiling MPI]]  
*[[Hand_Edits|Hand Edits]]
 
  
 
== Informative ==
 
== Informative ==
  
*[[UM_Version_Summaries|UM Version Summaries]]
+
*[https://code.metoffice.gov.uk/trac/um/wiki/PastReleases UM Version Summaries]  
*[[UM_Run_Scripts|UM Run Scripts]]
 
*[[UMUI_over_VNC|UMUI over VNC]]  
 
 
*[[Downloading_from_MASS|Downloading from MASS]]  
 
*[[Downloading_from_MASS|Downloading from MASS]]  
*[[Vertical_Coordinates|Vertical Coordinates]]  
+
*[[Vertical_Coordinates|Vertical Coordinates]]
 
 
  
 
== [[UM_and_ACCESS_FAQ|UM and ACCESS FAQs]] ==
 
== [[UM_and_ACCESS_FAQ|UM and ACCESS FAQs]] ==
  
*[http://climate-cms.wikis.unsw.edu.au/UM_and_ACCESS_FAQ#Who_can_gain_access_to_the_UM_and_the_ACCESS_models.3F Who can gain access to the UM and the ACCESS models?]  
+
*[[UM_and_ACCESS_FAQ#Who_can_gain_access_to_the_UM_and_the_ACCESS_models.3F|Who can gain access to the UM and the ACCESS models?]]
*[http://climate-cms.wikis.unsw.edu.au/UM_and_ACCESS_FAQ#What_to_do_to_gain_access_to_the_UM_and_the_ACCESS_models.3F What to do to gain access to the UM and the ACCESS models?]  
+
*[[UM_and_ACCESS_FAQ#What_to_do_to_gain_access_to_the_UM_and_the_ACCESS_models.3F|What to do to gain access to the UM and the ACCESS models?]]
*[http://climate-cms.wikis.unsw.edu.au/UM_and_ACCESS_FAQ#What_to_do_to_use_the_software_in_.2Fprojects.2Faccess.2Fbin.3F What to do to use the software in /projects/access/bin?]
+
*[[UM_and_ACCESS_FAQ#What_to_do_to_use_the_software_in_.2Fprojects.2Faccess.2Fbin.3F|What to do to use the software in /projects/access/bin?]]
 
 
== Work in progress ==
 
 
 
*[[SCM_with_ERA-Interim|SCM with ERA-Interim]]  
 
  
 
= Resources =
 
= Resources =
  
 
*[https://code.metoffice.gov.uk/trac/um UM code & issue tracker]  
 
*[https://code.metoffice.gov.uk/trac/um UM code & issue tracker]  
*[https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM 10.X Documentation]  
+
*[https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM Documentation]  
 
*[https://code.metoffice.gov.uk/doc/um/latest/um-training/index.html Rose Interface Tutorial]  
 
*[https://code.metoffice.gov.uk/doc/um/latest/um-training/index.html Rose Interface Tutorial]  
*[https://nf.nci.org.au/facilities/software/UM/7.8/umdoc_system/UM_docs/papers/html/X0/X0.html Getting started with UM and UMUI]
 
 
*[http://cms.ncas.ac.uk/ NCAS]  
 
*[http://cms.ncas.ac.uk/ NCAS]  
*[http://collab.metoffice.gov.uk/twiki/bin/view/Main/WebHome Met Office Wiki] - Contact [mailto:UM_collaboration@metoffice.gov.uk UM_collaboration@metoffice.gov.uk] or [mailto:climate_help@nf.nci.org.au climate_help] to register
 
*Met Office mailing list (Read by scientists at the Met Office) - Contact [mailto:UM_collaboration@metoffice.gov.uk UM_collaboration@metoffice.gov.uk]
 
*ACCESS users mailing list (Notifications about ACCESS systems) - Contact [mailto:climate_help@nf.nci.org.au climate_help]
 
  
 
*[[UM_Admin|UM Admin]]  
 
*[[UM_Admin|UM Admin]]  

Latest revision as of 23:34, 29 April 2021

The Unified Model is the atmospheric component of ACCESS, developed by the UK's Met Office. The Centre of Excellence sublicences the UM from CAWCR, our licence allows us to run the UM at NCI only. To run the UM you will first need an NCI account, then ask for connection to the ACCESS group through NCI's account website.

The ACCESS climate models are based on version 7.3 of the UM, most Australian university research uses this version. The Bureau makes use of the more recent version 7.8 for forecasting, and is evaluating moving to version 8.2. These are the primary versions supported at NCI, other versions are available but may not be quite as well tested. Different versions include changed science configurations, for details see the release notes.

Getting Started

The UM is configured through a graphical interface, which is run from the server Accessdev. Follow the Set Up Instructions for the version of the model you want to run.

There are two ways to run the model. Newer versions (post UM 10) use Rose & Cylc, older versions (pre UM 10) use a program called UMUI.

The Met Office have a tutorial for the model at https://code.metoffice.gov.uk/doc/um/latest/

A variety of model configurations are within the Centre. Feel free to contact CMS to discuss the different model types and what might be most appropriate for your work. If you plan on contributing work to the Met Office make sure you use the most recent version of the model.

UM 10 / Global Atmosphere / ACCESS 2.x

The current version of the Unified Model is available from the Met Office's repository site https://code.metoffice.gov.uk.

ARCCSS researchers need to email climate_help@nci.org.au to request an account on the Met Office server.

Links & More Information

Pre-UM 10

See Unified Model pre10 for documentation on older versions of the model

Experiments

A full list of experiments we support or have helped set up can be found at UM Experiments

These configurations are currently our primary support targets:

Guides

Assorted information on running the UM and available job configurations is listed in the sections below. Feel free to email climate_help@nci.org.au if you have any difficulties using the UM or suggestions for how we can make using the UM simpler.

Starting Up

Run Types

Common Errors

If a run fails, search for 'UM ERROR' in the .leave file to see what went wrong. Common issues are listed here

Job Input

Job Output

Modifying the UM

Informative

UM and ACCESS FAQs

Resources