Difference between revisions of "UKCA Chemistry and Aerosol Tutorials: Things to know before you start the vn11.8 practicals"
Line 55: | Line 55: | ||
<span style="color:red">'''YOU ONLY NEED THESE ADDITIONAL REQUIREMENTS IF YOU ARE SETTING UP THE VIRTUAL MACHINE YOURSELF'''</span> |
<span style="color:red">'''YOU ONLY NEED THESE ADDITIONAL REQUIREMENTS IF YOU ARE SETTING UP THE VIRTUAL MACHINE YOURSELF'''</span> |
||
+ | |||
+ | You will be using a version of the Met Office provided Virtual Machine to run the VM, provided here: |
||
+ | |||
+ | https://github.com/metomi/metomi-vms |
||
+ | |||
+ | It will have been set-up for you, but if you are making your own VM you should follow the instructions in [https://code.metoffice.gov.uk/doc/um/latest/umdp.html UMDP X10]. There is also some (possibly out of date) information that can be found [[Met_Office_Virtual_Machine|here]]. These tutorials have been documented on the VM in [https://doi.org/10.5194/gmd-11-3647-2018 Abraham et al. (2018)][1]. |
||
+ | |||
+ | To to run a simple UKCA suite in the VM you need at least 6GB of RAM to work successfully. |
||
+ | |||
+ | '''References''' |
||
+ | # Abraham, N. L., Archibald, A. T., Cresswell, P., Cusworth, S., Dalvi, M., Matthews, D., Wardle, S., and Whitehouse, S.: Using a virtual machine environment for developing, testing, and training for the UM-UKCA composition-climate model, using Unified Model version 10.9 and above, Geosci. Model Dev., 11, 3647–3657, https://doi.org/10.5194/gmd-11- |
||
===Tutorial Data=== |
===Tutorial Data=== |
Revision as of 12:24, 20 January 2021
UKCA Chemistry and Aerosol Tutorials at vn11.8
You will need to have the details of your MOSRS account and VM connection details to hand.
Before you begin the UKCA Tutorials
You should be comfortable using a GNU/Linux operating system, including using and navigating around using a terminal. You should also be familiar with programming, ideally Fortran.
These tutorials assume that you are familiar with FCM, and training on this can be found here:
http://cms.ncas.ac.uk/wiki/Fcm
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:
http://cms.ncas.ac.uk/wiki/RoseCylc
The Met Office provide some on-line UM specific Rose training here:
https://code.metoffice.gov.uk/doc/um/latest/um-training/index.html (MOSRS password required)
3647-2018, 2018.
Accounts
To run these tutorials you will need
- an account on the Met Office Science Repository Service
which will then allow you to run the tutorials in a Virtual Machine.
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 |
---|---|---|---|---|
vm | vn11.8 N48L38 GNU Compiler | u-ca021 | lukeabraham | 1x2 decomposition |
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.
Additional Requirements when using a personal Virtual Machine
YOU ONLY NEED THESE ADDITIONAL REQUIREMENTS IF YOU ARE SETTING UP THE VIRTUAL MACHINE YOURSELF
You will be using a version of the Met Office provided Virtual Machine to run the VM, provided here:
https://github.com/metomi/metomi-vms
It will have been set-up for you, but if you are making your own VM you should follow the instructions in UMDP X10. There is also some (possibly out of date) information that can be found here. These tutorials have been documented on the VM in Abraham et al. (2018)[1].
To to run a simple UKCA suite in the VM you need at least 6GB of RAM to work successfully.
References
- Abraham, N. L., Archibald, A. T., Cresswell, P., Cusworth, S., Dalvi, M., Matthews, D., Wardle, S., and Whitehouse, S.: Using a virtual machine environment for developing, testing, and training for the UM-UKCA composition-climate model, using Unified Model version 10.9 and above, Geosci. Model Dev., 11, 3647–3657, https://doi.org/10.5194/gmd-11-
Tutorial Data
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_vn118.tgz
There is 915MB to download, so it might take some time.
Once the download has finished, you can extract the archive by running
tar -xzvf UKCA_Tutorial_vn118.tgz
This will make a directory called Tutorials/
containing 1.5GB 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 vn118.md5
Xconv
You will need to download Xconv (xconv1.94
) from here:
You can download this by
wget http://cms.ncas.ac.uk/documents/xconv/_downloads/xconv1.94_linux_x86_64.tar.gz
Download it to your $HOME/bin on the VM, cd into this directory, tar -zxvf
the tar-ball, and then
ln -s xconv1.94 xconv ln -s xconv1.94 convsh
Iris
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
conda
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. You should edit the install-iris
to have the line
conda install -y -c conda-forge python=3.6 iris=1.13 ipython mo_pack numpy=1.15
instead of the existing line, otherwise the scripts will not work correctly.
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
pylab
in my .bashrc
. The
--pylab
sets-up a MatLab-type environment (numpy, scipy, matplotlib all loaded using standard shortcuts), and
--logfile=ipython-`date +\"%Y%m%d-%H%M%S\"`.py
means that all commands are saved to a file of the format
ipython-YYMMDD-HHMMSS.py
Scripts
There are a number of scripts provided for these tutorials. These can be found on GitHub here:
Written by Luke Abraham 2020.