Difference between revisions of "Unified Model"

(Getting Started)
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
  
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 [https://my.nci.org.au/mancini/project/access/join NCI's account website].
+
The Unified Model is the atmospheric component of [[ACCESS|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 [https://my.nci.org.au/mancini/project/access/join 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 [https://code.metoffice.gov.uk/trac/um/wiki/ReleaseNotes release notes].
 
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 [https://code.metoffice.gov.uk/trac/um/wiki/ReleaseNotes release notes].
  
=Getting Started=  
+
= Getting Started =
  
The UM is configured through a graphical interface, which is run from the server <span style="font-family:monospace">accessdev.nci.org.au</span>. 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]
 
  
=UM 10 / Global Atmosphere / ACCESS 2.x=  
+
The Met Office have a tutorial for the model at https://code.metoffice.gov.uk/doc/um/latest/
The current version of the Unified Model is available from the Met Office's repository site https://code.metoffice.gov.uk.
+
 
 +
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 https://code.metoffice.gov.uk].
  
 
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.
  
==Supported Experiments==  
+
=== Links & More Information ===
* [[GlobalAtmosphere | 'Global Atmosphere' (GA) configurations at NCI]]
 
* [https://code.metoffice.gov.uk/trac/roses-u/ticket/52 Nesting Suite]
 
  
==Unsupported Experiments==
+
*[https://accessdev.nci.org.au/trac/wiki/GettingConnected Connecting to Accessdev and running Rose]
This list contains Models and Experiments that are currently adapted for NCI and/or developed, but are not yet operational for scientific use at ARCCSS
+
*[[Running_the_UM_with_Rose|Tips on using Rose with the UM]]  
* [[High Res MIP | GA7.1 N216 Model Intercomparison Project]]
+
* [http://nespclimate.com.au/wp-content/uploads/2020/10/Instruction-document-Getting_started_with_ACCESS.pdf Getting Started with ACCESS]
* [[ACCESS 2.0]]
+
*[https://code.metoffice.gov.uk/trac/um UM code & issue tracker]  
* [[HighResLAM | High Resolution 400m Australia Domain ]]
+
*[https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM 10.X Documentation]  
 +
*[https://code.metoffice.gov.uk/doc/um/latest/um-training/index.html Rose Interface Tutorial]
 +
*[http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2017 UM User Tutorial 2017]  
 +
*[http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2016 UM User Tutorial 2016]  
  
==Links & More Information==
+
*[[GA7_Performance|GA7 Performance]]
* [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]]
 
* [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/um-training/index.html Rose Interface Tutorial]
 
* [http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2017 UM User Tutorial 2017]
 
* [http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2016 UM User Tutorial 2016]
 
  
* [[GA7 Performance]]
+
= Pre-UM 10 =
  
=UM 7.3 / ACCESS 1.x=
+
See [[Unified Model pre10]] for documentation on older versions of the model
The ACCESS climate model as used in CMIP5 uses model version 7.3. This version of the model uses the older `UMUI` user interface
 
  
==Supported Experiments==
+
= Experiments =
*
 
  
==Links & More Information==
+
A full list of experiments we support or have helped set up can be found at [[UM_Experiments|UM Experiments]]
* [[UM Environment | Setting up the UMUI environment]]
 
* [[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]
 
  
=Guides=
+
These configurations are currently our primary support targets:
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.
 
  
* [[Getting Help with the UM]]
+
*[[ACCESS_2.0|ACCESS 2.0]]
* [[um-errors | Common Errors]]
+
*[[ACCESS-ESM|ACCESS-ESM]]
 +
*[[Global Atmosphere|GA 7]]  
 +
*[[U-aa753_Nested_Suite|Nesting Suite]]
  
==Starting Up==
+
= Guides =
* [[New UM User message]]
 
* [[Building the UM]]
 
* [[Standard UM Runs]]
 
* [[Restarting UM Runs | Running the UM using automatic resubmission]]
 
* [[Recovering from an interrupted job]]
 
* [[UM Helper Scripts]]
 
* [[Moving UM jobs to Raijin  |  Moving UM jobs to Raijin]]
 
* [[Running the UM with Rose]]
 
  
==Run Types==
+
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.
* [[AMIP]]
 
* [[ACCESS | CMIP]]
 
* [https://trac.nci.org.au/trac/access/wiki/SCM_testcases Single Column]
 
* [[KPP Coupling]]
 
* [https://trac.nci.org.au/trac/access/wiki/APS1_ACCESS_C ACCESS-C High-resolution NWP]
 
* [[UM Nested Models]]
 
* [[Limited Area]]
 
* [[UKCA]]
 
  
* [http://www.ukca.ac.uk/wiki/index.php/UKCA_%26_UMUI_Tutorials  UKCA Tutorials]
+
*[[Getting_Help_with_the_UM|Getting Help with the UM]]  
* [https://trac.nci.org.au/trac/access/wiki/AccessModelExperimentLibrary  CAWCR's ACCESS experiment library] (log in with your NCI account)
+
*[[Um-errors|Common Errors]]  
  
=Common Errors=  
+
== Starting Up ==
 +
 
 +
*[[Running_the_UM_with_Rose|Running the UM with Rose]]
 +
*[[UM_Helper_Scripts|UM Helper Scripts]]
 +
 
 +
== Run Types ==
 +
 
 +
*[[AMIP|AMIP]]
 +
*[[ACCESS|CMIP]]
 +
*[https://trac.nci.org.au/trac/access/wiki/SCM_testcases Single Column]
 +
*[[KPP_Coupling|KPP Coupling]]
 +
*[https://trac.nci.org.au/trac/access/wiki/APS1_ACCESS_C ACCESS-C High-resolution NWP]
 +
*[[UM_Nested_Models|Nested / Limited Area Models]]
 +
*[[UKCA|UKCA Chemistry]]
 +
 
 +
*[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)
 +
 
 +
= Common Errors =
  
 
If a run fails, search for 'UM ERROR' in the .leave file to see what went wrong. Common issues are listed here
 
If a run fails, search for 'UM ERROR' in the .leave file to see what went wrong. Common issues are listed here
  
* [[um-errors#pp-headers | REPLANCA: PP HEADERS ON ANCILLARY FILE DO NOT MATCH]]
+
*[[Um-errors#pp-headers|REPLANCA: PP HEADERS ON ANCILLARY FILE DO NOT MATCH]]  
* [https://code.metoffice.gov.uk/trac/um/wiki/KnownUMFailurePoints Known UM failures at UKMO]
+
*[https://code.metoffice.gov.uk/trac/um/wiki/KnownUMFailurePoints Known UM failures at UKMO]  
 +
 
 +
== Job Input ==
 +
 
 +
*[[UM_Ancillary_files|UM Ancillary files]]
 +
*[[Modifying_UM_Files|Modifying UM files with Mule]]
 +
*[[SCM_with_ERA-Interim|SCM with ERA-Interim]]
 +
 
 +
== Job Output ==
 +
 
 +
*[[Using_STASH|Using STASH]]
 +
*[[UM_Filenames|UM output filename convention]]
 +
*[[Analysing_UM_outputs|Analysing UM outputs & Converting to NetCDF]]
 +
*[[Archiving_Output|Archiving Output]]
 +
*[[Comparing_UM_Files|Comparing UM Files]]
 +
*[https://code.metoffice.gov.uk/trac/UKESM/wiki/CMIP6/DiagnosticMappings Mapping UM outputs to CMIP fields]
 +
 
 +
== Modifying the UM ==
  
==Job Input==
+
*[https://code.metoffice.gov.uk/trac/um/wiki/working_practices Met Office UM Development Working Practices]  
* [[UM Ancillary files]]
+
*[[Adding New Fields to STASH]]  
* [[Concatenate AMIP Ancillaries]]
+
*[[Profiling_with_IPM_and_Vampir|Profiling MPI]]  
* [[Copying CO2 values]]
 
* [[Modifying UM Files | Modifying UM files with Mule]]
 
  
==Job Output==  
+
== Informative ==
* [[Using STASH]]
 
* [[Copying STASH settings between jobs]]
 
* [[UM Filenames | UM output filename convention]]
 
* [[Analysing UM outputs | Analysing UM outputs & Converting to NetCDF]]
 
* [[Archiving Output]]
 
* [[Comparing UM Files]]
 
* [https://code.metoffice.gov.uk/trac/UKESM/wiki/CMIP6/DiagnosticMappings Mapping UM outputs to CMIP fields]
 
  
==Modifying the UM==
+
*[https://code.metoffice.gov.uk/trac/um/wiki/PastReleases UM Version Summaries]  
* [[UM Source Control]]
+
*[[Downloading_from_MASS|Downloading from MASS]]  
* [[User fields]]
+
*[[Vertical_Coordinates|Vertical Coordinates]]
* [[Oasis Coupling with the UM]]
 
* [[Oasis coupling in UM 8.5]]
 
* [[Profiling with IPM and Vampir | Profiling MPI]]
 
* [[Hand Edits]]
 
  
==Informative==
+
== [[UM_and_ACCESS_FAQ|UM and ACCESS FAQs]] ==
* [[UM Version Summaries]]
 
* [[UM Run Scripts]]
 
* [[UMUI over VNC]]
 
* [[Downloading from MASS]]
 
  
==Work in progress==
+
*[[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#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_use_the_software_in_.2Fprojects.2Faccess.2Fbin.3F|What to do to use the software in /projects/access/bin?]]
  
* [[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 Documentation]  
* [https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM 10.X 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]
+
*[http://cms.ncas.ac.uk/ NCAS]  
* [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://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 Partial guides]]
+
*[[UM_Partial_guides|UM Partial guides]]  
  
 
[[Category:Unified Model]]
 
[[Category:Unified Model]]

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