PyPRECIS is principally designed as a learning tool to faciliate processing of regional climate model (RCM) output. It is desgined to be used in conjunction with taught workshops in an instructor led environment. The name PyPRECIS is a refefence to the initial version of these notebooks which were designed for analysis of data from the PRECIS model but the training is now designed to be more general.
PyPRECIS is built on Jupyter Notebooks, with data processing performed in python, making use of Iris. A conda environment is provided to install these packages, along with their dependencies. A guide containing instructions on how to install the conda environment can be found here.
The data analysed in the first set of notebooks is from the CORDEX-Core simulations which provide an ensemble of high-resolution (at least 25 km) regional climate change information. Further information about CORDEX-Core can be found on the CORDEX website. There is also a Special issue of Climate Dynamics which gives more information about this data. There are also a set of notebooks which analyse the 20CR-DS data set covering China.
The teaching elements of PyPRECIS are contained in the notebooks
directory. The core primary worksheets are:
Worksheet | Aims |
---|---|
1 | |
2 | |
3 | |
4 | |
5 | |
6 | An extended coding exercise designed to allow you to put everything you've learned into practise |
Additional tutorials specific to the CSSP 20th Century reanalysis dataset:
Worksheet | Aims |
---|---|
CSSP 1 | |
CSSP 2 | |
CSSP 3 | |
CSSP 4 |
Three additional worksheets are available for use by workshop instructors:
makedata.ipynb
: Provides scripts for preparing raw model output for use in notebook exercises.worksheet_solutions.ipyn
: Solutions to worksheet exercices.worksheet6example.ipynb
: Example code for Worksheet 6.For information on how to access the CORDEX-Core data used in these worksheets, see: CORDEX: How to access the data. Most CORDEX data is available for unrestricted use but some is provided for non commercial use only. Before you download any CORDEX data you must ensure you are aware of the Terms of Use for the data you are accessing.
Data relating to the CSSP 20CRDS tutorials is held online in an Azure Blob Storage Service. To access this data user will need a valid shared access signature (SAS) token. The data is in Zarr format and the total volume is ~2TB. The data is in hourly, 3 hourly, 6 hourly, daily and monthly frequencies stored seperatrely under the metoffice-20cr-ds
container on MS-Azure. Monthly data only is also via Zenodo.
Information on how to contribute can be found in the Contributing guide.
Please also consult the CONTRIBUTING.ipynb
for information on formatting the worksheets in Jupyter Notebooks. Note that we do not currently make use of Jupyter Lab as it doesn't currently support the types of html formatting we use in Jupyter Notebooks.
PyPRECIS is licenced under BSD 3-clause licence for use outside of the Met Office.