Setting UKCA up at NCI

There are two approaches to getting UKCA working at a particular version at NCI.

  • Take a working atmospheric job and turn UKCA on.
  • Get a UKCA job from the Met Office and change the set up to work at NCI.

This requires different steps for each subsequent version of the UM, so this page will describe a general process, focusing on the first method.

Adding UKCA to a UM job

  • Firstly we would need to obtain a package from the Met Office containing patches for UKCA with a particular configuration.
  • In addition, there are often extra hand edits and userstash files for UKCA.
  • We also need ancillaries for emissions and initial conditions for the chemistry.
  • A standard UKCA job should be obtained from the Met Office (to allow setting up a consistent configuration).

An example of this proceedure for vn8.2 is at vn8.2 setup

UKCA setup at vn8.4

Set up of vabrf ( NCI port of puma xkawa, RC6).

See for details about UKCA official release candidates.

  • Scott's job vabra is an NCI port of puma xhmaj (RC1).

UK original jobs copied to accessdev are:

  • vabry (xhmaj, RC1)
  • vabrz (xkawa, RC6)

vabrf was set up by updating vabra, using the differences between vabry and vabrz.

To get this to work, the following changes were made:

  • extra bug fixes were made in fcm:um_dev/pfu599/vn8.4_ukca_pkg
  • Ancillary files from monsoon had non-uniform polar values. This required fixing using ~mrd599/src/python/v1.0_new_umfile/
  • Note, there is still an issue with non-uniform polar values developing during a run. This will need further investigation.

UKCA configuration at vn8.2

Steps to turn on UKCA

UMUI: UKCA settings are at: Atmosphere -> Model Configuration -> UKCA Chemistry and Aerosols

normal switches for ukca ...

NOTE. The UKCA_TRA window needs to be opened, then the job saved, after UKCA is switched on.

Directories needed for ancillary files: Base directory: ~access/data/ukca/vn8.2/N96L85

  • UKCA photolysis rates: photol/ Files have endianness that doesn't match vayu system, so code ukca_phot2d.F90 modified to convert this. (committed to branch vn8.2_UKCA_patches rev 5291)
  • top boundary conditions: topbound/

Diagnostics needed by UKCA

Where usage Profile UPUKCA uses a secondary store with tag 98.

Initialisation of UKCA prognostics

Atmosphere -> Stash -> Specification of User prognostics

  • 301-340 should be set to "2" (user ancillary file used for emissions)
  • Long lived chemical species are initialised from /projects/access/data/ukca/vn8.2/N96L85/init/CCMVal_init_StratChem_N96L85.anc (set option "7").
  • You can also set option "1" (initialise from a dump file), "6" to set a field to a constant value or "3" to set field to all zeros


Atmosphere -> Ancillary and input data files -> Climatologies & potential climatologies

The fields that are set to 2 above are initialised from the ancillary files specified in this section

We have two different sources of emission datasets to choose from:

CSIRO emissions: ~access/data/ukca/vn8.2/N96L85/ems_CSIRO_noxfix/

  • User single level ancillary file & fields:
    • surf_ems_????_v82.pp for time varying emissions, or
    • surf_ems_????_v82_p.pp for periodic emissions
  • User multi-level ancillary file and fields
    • air_ems_????_v82.pp for time varying emissions, or
    • air_ems_????_v82_p.pp for periodic emissions

To turn on time varying emissions, add the hand edit: ~access/umui_jobs/hand_edits/ukca/vn8.2/ukca_ancilchg_scr.ed Note. ???? is set to the start year for time varying emissions.

The process of generating the emissions datasets is described at Generating Emissions.

Met Office emissions: ~access/data/ukca/vn8.2/N96L85/ems_metoffice

  • User single level ancillary file & fields:
    • surf_ems_ipcc2k_geia_N96
  • User multi-level ancillary file and fields
    • GFED2_AIR_AR5_2000.N96L85

Turning on UKCA-MODE

Turning on MODE aerosols in addition to UKCA. Example job is uaiam (on accesscollab).

UMUI settings: UKCA settings: Tick "Include Aerosol Chemistry", "UKCA-MODE Aerosol Scheme"

Next go to the menu: "MODE":

Options are as below.

In addition to this, the following items need to be added to the stash diagnostic outputs: 38,401->38,407 (dry particle diameters).

Also it would be recommended to turn off Aerosol feedbacks for the Classic scheme when using MODE aerosols

Menu: Model Configuration -> Aerosols -> AERO_FX MODE aerosol radiative feedbacks can be turned on from the UKCA settings -> COUPL (not available at this stage)

Last modified 6 years ago Last modified on Feb 3, 2015 4:35:36 PM

Attachments (2)

Download all attachments as: .zip