UKCA Chemistry and Aerosol Tutorials: Things to know before you start the vn10.9 practicals
You will need to have the details of your PUMA and ARCHER accounts to hand.
Before you begin the UKCA Tutorials
These tutorials assume that you are familiar with FCM, and training on this can be found here:
The UM FCM tutorial that is linked from this page uses the old user interface (the "UMUI"), so will be less relevant here.
You should also familiarise yourself with Rose & Cylc, and more information on these can be found here:
The Met Office provide some on-line UM specific Rose training here:
Also, if you do not have a PUMA or ARCHER account, you can use the Met Office provided Virtual Machine to run the VM, provided here:
You should follow the instructions in UMDP X10.
It is possible to run a simple UKCA suite in the VM, but note that this requires at least 6GB of RAM to run successfully.
To run these tutorials the minimum you will need is
- an account on the Met Office Science Repository Service
which will then allow you to run the tutorials in a Virtual Machine.
To run these on ARCHER you will need
- a PUMA account
- an ARCHER account
For information on how to get these, please see the Getting Started with UKCA page.
If you are attending the face-to-face training workshop you will be provided with ARCHER training accounts, although you still need your own PUMA account.
Developing code for the UM
During this tutorial you will be creating tickets on the Met Office Science Repository Service, and making code changes to UM branches. Please note that this is a live system, used by scientists all over the world to develop their code. However, please don't worry about breaking anything, as there are practices in place to prevent this.
For more information about developing for the UM, please see the Working Practices for UM Development with Rose, FCM and trac.
UKCA Training Suite
|Machine||UM Version/Configuration||Suite ID||Owner||Comments|
|ARCHER||vn10.9 N48L38 Intel Compiler||u-as101||lukeabraham||May be compiled manually (recommended)|
|vm||vn10.9 N48L38 GNU Compiler||u-as159||lukeabraham||1x2 decomposition|
|XC40 (Monsoon2/NEXCS)||vn10.9 N48L38 GNU Compiler||u-au234||lukeabraham||4x9 decomposition (36-core)|
These suites are based on the
um_n48_ukca_eg app, which is available in the MetUM trunk (in
rose-stem/app/). A ticket giving more details on these (and the code changes) can be found at: um:#3578.
To set-up using the UM with Rose & Cylc correctly, go to
and follow the instructions from Section 1.2 onwards if you are using Linux/Mac (after opening a terminal).
Note: when entering MOSRS password, a rose window will open behind everything all your other windows. You will also need to enter your username here to complete the process.
When you have completed this, you should launch the Rose browser by typing
rosie go &
and there you should search for training suite and make a copy of it.
When you have copied the suite, you will need to remember to change the username & tic code in suite conf Machine Options.
Additional Requirements (Virtual Machine)
To be able to do Tutorials 5 and 10 you will need emissions data and python scripts. These files, as well as worked solutions for all the Rose and code changes can be obtained by running the following command from the
home/ directory of your VM:
wget -q --show-progress http://gws-access.ceda.ac.uk/public/ukca/UKCA_Tutorial_vn109.tgz
There is 880MB to download, so it might take some time.
Once the download has finished, you can extract the archive by running
tar -xzvf UKCA_Tutorial_vn109.tgz
This will make a directory called
Tutorial/ containing 1.4GB of files. If you
cd into this you can check that the files have not been corrupted by running the following command:
md5sum --status -c vn109.md5
You will need to download Xconv (
xconv1.93) from here:
You can download this by
Download it to your $HOME/bin on the VM, cd into this directory,
tar -zxvf the tar-ball, and then
ln -s xconv1.93 xconv ln -s xconv1.93 convsh
There is an
install-iris script provided, but you will need to set-up modules yourself to be able to use it properly. The anaconda install breaks Rose if put in your PATH, however, there is now an alias
which will open a new terminal with all the anaconda python packages in its $PATH. This will allow you to use Rose in one terminal and Iris in another.
I have found a handy way to use python is to use
ipython with the following arguments
ipython --pylab --logfile=ipython-`date +\"%Y%m%d-%H%M%S\"`.py"
I have aliased this to
sets-up a MatLab-type environment (numpy, scipy, matplotlib all loaded using standard shortcuts), and
means that all commands are saved to a file of the format
Manual Compiling (ARCHER)
The UKCA Training Suite has been altered slightly to allow it to be easily manually compiled. This can be selected as an option in suite conf UM hosts. With this set to true, when the suite runs the fcm_make2 task will enter the submit-failed state. Then, on ARCHER, you should then change directory into
and compile the
um-recon executables by typing
This will take around 7-12 minutes to compile. When it has finished successfully you will get the following message in the terminal, just before the prompt:
JOB SCRIPT EXITING (TASK SUCCEEDED)
You can follow the progress of this process in detail by
tail-ing the following file
Once this step has completed, you can send the rest of the suite off by going back to the Gcylc window and right-clicking on the fcm_make2 task and click Reset State "succeeded". This will then allow the rest of the tasks to start in sequence.
Note: manually compiling in this way means that you will no longer have the job.out or job.err files. You should instead look in the fcm-make2.log file.
There are a number of scripts provided for these tutorials. These can be found on GitHub here:
They are also available on ARCHER.
Written by Luke Abraham 2017.