NCAS Unified Model Introduction

Part 6: UM tools and facilities

University of Reading, 16-18 December 2015

2

UM

GRIB

ASCI

UM

PP

GRIB

UM

PP

ASCI

netcdfnetcdf

UM Tools should provide a full range of input and output format possibilities

File formats

3

Model64-bit UM

GRIBECMWF data

reconfiguration

DECODE

netcdf 64-bit PP

pptoanc

32-bit PP(from UKMO)

IDL/Fortran

32-bit UM

um32to64

GRIBMetview

Fortran

64-bit PP

32-bit PPMet Office graphics

netcdf Python, idl Ferret, Grads cdat

convpp

fftopp

xconv

ieee

convpp32-bit

wconv.pl

Conversion tools

4

Tool Input Output

pptoanc PP UM (ancillary)

xancil netCDF UM (ancillary)

convpp UM PP

ff2pp UM (fields format) 32-bit PP

ieee UM 32-bit UM

bigend UM byte-swapped UM

xconv UM , PP and netCDF netCDF

cf-python UM and PP CF-netCDF

All tools and output 64-bit unless otherwise stated

Data conversion

UM tools (i)

5

Tool Purpose

cumf Compares UM format files

pumf Prints out header information for PP files

uminfo Header information UM

ppinfo Header information PP

Data information

Data manipulation

Tool Purpose

umpack Removes spare headers and extra buffers from UM files

fieldop Adds, subtracts, multiplies, divides UM (fields files) format

UM tools (ii)

6

Xconv

• Xconv can be used to see what fields are contained within a data file and to look at the data values, either directly at the numerical values or at a gridbox fill plot of the data.

• It can also convert model output into netCDF. Supported input formats: – Data output from the UM– PP format– GRIB format– netCDF format

• Data manipulations available:– Spectral to gridpoint– Interpolation (bilinear or area-weighted)– Conversion to and from rotated grids

7

8

Central Ancillary Program

• For creating standard ancillary files can use CAP– Orography– Land-sea mask– Soil moistue, snow– Vegetation– Aerosol– Sea surface temperatue, sea-ice– Ozone

• Typically used for running the LAM

• Contact the CMS helpdesk for more information: http://cms.ncas.ac.uk/wiki/CmsHelpdesk

9

Xancil

• Xancil provides a GUI for generating ancillary files from your own data. – Input data should be in NetCDF format. – Supports the creation of standard atmosphere and

(UM) ocean ancillary files. – Allows the creation of custom ancillary files.

• Xancil can take command-line options. – Complex workflows can be automated using tcl

scripts.

10

xancil

11

ff2pp

NDdiag

xconv

Ferret grads

Jplot

Python, idlMATLAB etc

UKMO library (midl)

Visualisation and analysis

cf-python

cfplot

Iris

UM fields filesUM run

12

Jasmin Analysis Platform (JAP)

• Collection of tools commonly used for atmospheric and Earth observation science, including: – NetCDF and nco tools – Cf-python, cfplot and Iris– Xconv, CDAT and lots more

• Installed on all the Jasmin systems (at BADC, Bristol, Reading and Leeds) and on the RDF at Archer.

• Can download as: – Virtual Machine, which will work on any system running

VirtualBox– RPMs for RHEL/CentOS Linux https://github.com/cedadev/jasmin_scivm/wiki

13

Availability of tools

• The UM tools are available on Archer under:– $UMDIR/bin– $UMDIR/vnX.Y/cce/utils

• CMS-developed tools (xconv, xancil, cf-python, cfplot) can be downloaded to your own platform.

• Further information can be found through the CMS site: http://cms.ncas.ac.uk/wiki/ToolsAndUtilities