Difference between revisions of "Unified Model"

(Getting Started)
(24 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 [[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]
 
  
=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.
  
==Links & More Information==  
+
=== Links & More Information ===
* [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://accessdev.nci.org.au/trac/wiki/GettingConnected Connecting to Accessdev and running Rose]  
* [https://code.metoffice.gov.uk/trac/um UM code & issue tracker]
+
*[[Running_the_UM_with_Rose|Tips on using Rose with the UM]]
* [https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM 10.X Documentation]
+
* [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/doc/um/latest/um-training/index.html Rose Interface Tutorial]
+
*[https://code.metoffice.gov.uk/trac/um UM code & issue tracker]  
* [http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2017 UM User Tutorial 2017]
+
*[https://code.metoffice.gov.uk/doc/um/latest/umdp.html UM 10.X Documentation]  
* [http://collab.metoffice.gov.uk/twiki/bin/view/Support/UMUserTutorial2016 UM User Tutorial 2016]
+
*[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]]
+
*[[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
 
  
==Links & More Information==
+
See [[Unified Model pre10]] for documentation on older versions of the model
* [[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]
 
  
=Experiments=
+
= Experiments =
  
A full list of experiments we support or have helped set up can be found at [[UM Experiments]]
+
A full list of experiments we support or have helped set up can be found at [[UM_Experiments|UM Experiments]]
  
 
These configurations are currently our primary support targets:
 
These configurations are currently our primary support targets:
  
* [[ACCESS 2.0]]
+
*[[ACCESS_2.0|ACCESS 2.0]]  
* [[ACCESS-ESM]]
+
*[[ACCESS-ESM|ACCESS-ESM]]  
* [[GlobalAtmosphere | GA 7]]
+
*[[Global Atmosphere|GA 7]]  
* [[Nesting Suite]]
+
*[[U-aa753_Nested_Suite|Nesting Suite]]
 +
 
 +
= Guides =
 +
 
 +
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]]
 +
*[[Um-errors|Common Errors]]  
  
=Guides=  
+
== Starting Up ==
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]]
+
*[[Running_the_UM_with_Rose|Running the UM with Rose]]
* [[um-errors | Common Errors]]
+
*[[UM_Helper_Scripts|UM Helper Scripts]]
  
==Starting Up==  
+
== Run Types ==
* [[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==
+
*[[AMIP|AMIP]]  
* [[AMIP]]
+
*[[ACCESS|CMIP]]  
* [[ACCESS | CMIP]]
+
*[https://trac.nci.org.au/trac/access/wiki/SCM_testcases Single Column]  
* [https://trac.nci.org.au/trac/access/wiki/SCM_testcases Single Column]
+
*[[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|Nested / Limited Area Models]]  
* [[UM Nested Models]]
+
*[[UKCA|UKCA Chemistry]]  
* [[Limited Area]]
 
* [[UKCA]]
 
  
* [http://www.ukca.ac.uk/wiki/index.php/UKCA_%26_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 =
  
 
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