Priorities

From UKCA

The aim of this page is to record progress with UKCA priority tasks.

Progress with priorities table

ACTION REQUEST FROM UKCA SCIENCE & MANAGEMENT BOARD: CMG to provide list of priorities & their status.

The current priorities are:

# Tickets Description Owner Status Technical urgency
High / Normal / NA
Science urgency
High / Normal / NA
Milestone or date targeted Complete
1 ukca:#28 Removal of remaining UM module dependencies in non-UM/LFRic builds John Hemmings This will allow UKCA to be built with no UM repository modules (7 are currently needed). Unassigned ticket UKCA:#28 covers most of the required work.
[Essential: It must be possible to use UKCA without access to the UM repository.]
High NA UM summer 2024 release
2 Standalone UKCA configurations Luke Abraham See UKCA Box Model page. Currently still require non-UKCA code in build process. Branch needs to be committed to UKCA trunk. ??? NA ???
3 Updates/fixes to GLOMAP routines Dan Grosvenor Graham and Sandip developed updates for stratospheric aerosol on old branch
It is desirable to include this to the trunk at some point
November 23 - we clarified what this priority was Graham and Sandip developed updates for stratospheric aerosol on old branch
It is desirable to include this to the trunk at some point
(originally owned by Adrian Hill)
NA ??? ???
4 ukca:#30 Reworking of internal data flow for API-level multi-thread capability Luke Abraham Covered by unassigned ticket UKCA:#30.
(High priority for both LFRic and NAME: Needed a.s.a.p. to achieve the required performance but expected to be a big job)
Will be covered under NG-ARCH.
High NA End of 2024
5 Glomap aerosol and GPU Alan J Hewitt (main)
Joe Abram
Started at vn13.3 High NA Gen 2 HPC prototype
2025
6 Photolosis and GPU Joe Wallwork
Joe Abram
Under development High NA Gen 2 HPC prototype
2025
7 ASAD Chemistry solver and GPU Luke Abraham Nov 23 - Working with PsyClone for this, as itdoes most of the directives.
Will be covered under NG-ARCH.
High NA Gen 2 HPC prototype
2025
8 ukca:#123 Removal of unnecessary UM module dependencies in LFRic builds TBC (main)
This is not a high priority for Rich, so this needs to be worked on by a UKCA developer.
LFRic currently uses the UM version of ukca_um_legacy_mod which is dependent on a large number of modules (e.g. STASH system modules) that are not required.
In principle, this could be fixed by an LFRic version of ukca_um_legacy_mo.
Rich has been looking at an alternative method using compiler directives (see Ticket ukca:#123 Purge usage of copydiag and friends for non-UM use cases).
[Essential: Remaining dependencies on a large number of unused modules (e.g. STASH etc.) are impacting on efficiency of LFRic build.]
High NA ???
9 ukca:#79 Removal of photolysis support code TBC Photolysis still relies on UKCA to determine its environmental driver requirements. Covered by unassigned ticket UKCA:#79. Needs to be coordinated with photolysis API development.
[Essential: Until this is done, photolysis cannot be run independently of UKCA and the need to retain support for photolysis adds unnecessary complexity to UKCA.]
High NA ???
10 ukca:#29 New error handling method John Hemmings (a)
Replace error handling in API routines with new method using 'error_report' (see Ticket UKCA:#29).
(b)
Replace all 'ereport' calls with 'error_report' and add support for optional return of control to parent.
[Desirable on technical grounds: Current inconsistencies are confusing and make code over complex. (a) is therefore relatively high priority. Return-control-to-parent functionality to be completed by (b) is lower priority but is desirable for anticipated large ensemble runs (to avoid having to abandon the whole ensemble on failure).]
High NA part (a) targeted end of 2024
11 UKCA API user guide John Hemmings (main) This needs to include comprehensive instructions for setting up UKCA from scratch, independently from the UM, in a new parent application.
[Essential.]
High NA 2025
12 RADAER optimisation
integration points
Alan Hewitt
Ben Johnson (main)
Have had someone looking to see if something could be changed to make it faster to make a trimmed-down version with less calculations for e.g. NWP.
AJH and BJ to look at making number of integration points a user variable
AJH has functionality to do 1 integration point now. BJ is going to lead this one and see what happens when run with this for use in a weather context. Would give a ~4x speed-up for RADAER.
NA
on trunk
High 2024
13 ukca:#36 Tuning of SOL/INSOL simple aerosol scheme to replace MURK Anthony Jones This will change the default SOL/INSOL configuration to better match aerosol observations compared to Clean Air observations NA High LFRic release
14 Review UKCA tests to cover all requirements Luke Abraham / Mohit Dalvi Will cover these in a table in future for review.
Updated testing coverage on Linux and can run 1x1 decomposition
??? NA ???
15 Emissions flexibility probably Mohit Dalvi??? (a)
Modify ‘ukca_set_emissions’ to handle data for 1D domains (for consistency with

ukca_set_environment).
(b)
Improve interface for registration of aerosol emissions by avoiding the need for parent to know the number of entries required for each emission in the internal data structure.
(c)
Improve handling of vertical scaling factors to reduce redundancy.
[Desirable on technical grounds: (a), (b) and potentially (c) will remove unnecessary complexity for parents. (b) will require linked tickets for compatibility so becomes harder to do later if used by more parents. Vertical scaling factors are 3D fields, often all 0 apart from surface - cannot persist internally between time steps in LFRic/NAME and must be regenerated or handled by parent, so scope for efficiency savings with (c).]

??? Normal ??? NA TBC
16 RADAER API Alan Hewitt (main) Radaer API on hold until after GA7 port to LFRic.
Functionality of RADAER in LFRic will work without an API although it will be preferable to update this in future.
Not clear if RADAER will work independently of UM in single column mode.
AJH and AJ and JH and Ben Johnson and NB need to work out if desirable and practical to run independent of UM.
Normal NA TBC
17 RADAER optimisation
emulation
Alan Hewitt (main)
Ben Johnson
AJH highlighted that there have been some discussions about this - a few people interested in this (James Manners, AJ, Ben Johnson, AJH).
AJH and others to look at emulation of RADAER
Normal Normal TBC
18 UM:#2689 FastJX-GLOMAP coupling TBC
Ticket owned by Fiona
UMvn10.8 branches exist - see ticket
Note: FastJX rates also need updating - potential for code as well as input-file changes
NA Normal TBC
maybe ukesm3
maybe IPCC AR7
19 Cloud-J Owner TBC Notes ??? ??? TBC
20 UKCA STASHmaster PP-codes Luke Abraham Verification system makes some use of existing PP-codes. New items should have a PP-code of 0 and verification team will use STASH items for these if required. ??? NA TBC
21 GLOMAP-CLIM API refresh Alan J Hewitt Cuurently parked.
Extend API to include GLOMAP-clim within the core UKCA code (or alternatively provide UKCA routines required by GLOMAP-clim in the UKCA API). Required to avoid the need to by-pass the API.
Normal NA TBC
22 None N48L85 configuration TBC notes NA ??? TBC
23 ACTIVATE optimisation TBC A quick win here is to reduce nwbins in namelist ( see um:#4740 ).
Parked for now.
There does not seem to be resource to look at this at present.
This could be tested for UKESM-fast. Another potential change would be to alter the call to only when there are clouds
??? NA TBC
24 ukca:#27
ukca:#92
Handling of solar calculations and time inputs TBC Covered by unassigned tickets UKCA:#27 and UKCA:#92. Ticket #27 addresses inconsistencies between calculations for offline oxidants and isoprene and the potential for inconsistency with photolysis as well as avoiding the need for a 'previous_time' input.
[Desirable on scientific and technical grounds: Current redundancy in required inputs adds unnecessary complexity for parent models and there is significant scope for efficiency improvements and internal simplification.]
Normal NA TBC
25 Replace/remove UM legacy code in UKCA (where possible) TBC Includes UM humidity calculations, grid-specific aspects of volcanic SO2 and mass calculations, surface area calculation for heterogeneous chemistry on CLASSIC aerosols. May include ozone column calculation which is also used by photolysis (can be provided as a parent callback routine to act on post chemistry ozone).
[Desirable on technical grounds: Current code is over complex, by-passes the API (thus restricting UKCA development) and is difficult to maintain.]
Normal NA TBC
26 several Removal of redundant code ALL Parked whilst GA7.0 is a protected suite. Normal NA NA
27 Support for UM hybrid resolution model and provision of internal variables via the API Mark Stringer (main) Required to avoid the need to by-pass the API.
Currently a low priority task.
Code is protected by rose-stem so do not need to fix this urgently.
Nov 23 - MS has little time to work on this at present. An edge case for API usage.
Low NA None

Table of previously completed priority tasks

Description Owner Status Comments
UKCA API John Hemmings (main) UKCA API work is progressing (AJH). Radaer API on hold until after GA7 port to LFRic. Functionality of RADAER in LFRic currently works without an API although it will be preferable to update this in future.
Main task complete
Main task complete
Some follow up tasks have been created
UKCA and NAME coupling John Hemmings (main) ukca:#25 was lodged for UM13.2
Now working with RAQ. PMJ has been able to build UKCA as a shared library for NAME use.
Work complete on UKCA side
Science testing started with NAME
Separare UKCA repository Luke Abraham Separate UKCA trac environment set-up on MOSRS here, will hold UKCA code on completion of current ExCALIBUR project.
Aiming for vn12.3.
UKCA removed from UM at UMvn13.0 - see UKCA repo
Closed
Non-API LFRic work, e.g. Porting aerosol science functionality etc. Alan J Hewitt Porting calculation of CDNC from GLOMAP Climatology aerosols complete.
I will pass required elements of ukca_radaer to ukca_radaer_band_average (um:#5957)
Porting calculation of fields in radaer_band_average to be passed to Socrates underway(lfric:#2488)
Includes RADAER, need to use imode_setup=8
RADAER now callable from LFRic, can do GA-type comparisons from LFRic to UM. JH to put UKCA into LFRic soon - working in an SCM configuration (GLOMAP with offox) - needs more testing. A lot more work to do, possibly until end of 2021.
AJH has tickets going in for 12.1 that would cover all of the basic GA7 but with climatological aerosol. JH tickets will do the prognostic alternative. JH currently has an LFRic-SCM configuration with prognostic aerosol.
JH now has UKCA working in proto-GAL7 (LFRic) config. Needs to couple with convection & plume scavenging.
Convection & plume scavenging has been done.
AJH - some of this has been done or is in progress.
Dry deposition and Jules tiles Garry If Jules adds extra tiles for UKESM2 we may need to hard code options in dry deposition (like in um:#1761)
Aerosol Dry Deposition will be considered in the JULES context once the gas-phase changes have been committed.
Completed for UM13.1
Fixes for chemistry rates and ASAD (bugs #101 & #103) Luke Abraham #101 still open, #103 completed (necessary for GC5 ticket GMED:#551)
Issues on EX1A.
Closed - see also UKESM:#841 for UKCA package ticket
Rc fixes for water (bug #104) UKESM Core Team Lodged at UMvn11.7 in ticket UM:#5167
CH4 deposition fixes (bug #109) Gerd Folberth Closed
Solar cycle in photolysis Luke Abraham Some code lodged at UMvn10.9 (UM:#2587) but needs bugfixing. This work has stalled in ticket UM:#4828 (bug #110).
UM:#4828 lodged for UMvn12.2.
See also UKESM:#841 for UKCA package ticket
Deposition updates from CSIRO Code lodged in UM:#4020 (UMvn11.4, oceanic dry deposition) and UM:#5713 (UMvn11.8, Lightning NOx updates).
See also UKESM:#841 for UKCA package ticket
Sol/Insol Anthony Jones (main) ukca:#14 was lodged for UM13.2
Stratospheric Ozone improvements James Keeble/Luke Abraham Work lodged and in package testing for UKESM2