Skip to content

More fixes to substepping of tracers - #814

Closed
Thomas Bendall (tommbendall) wants to merge 8 commits into
MetOffice:mainfrom
tommbendall:tracer_substep_more
Closed

Thomas Bendall (tommbendall) wants to merge 8 commits into
MetOffice:mainfrom
tommbendall:tracer_substep_more

Conversation

@tommbendall

@tommbendall Thomas Bendall (tommbendall) commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

PR Summary

Sci/Tech Reviewer: James Kent (@jameskent-metoffice)
Code Reviewer: mo-lucy-gordon

This PR adds three further fixes to the stability of the transport scheme when substepping the transport of tracers separately from the main prognostics.

  1. The Watkins algorithm takes into account the substepping, by limiting the threshold of intermediate Lipschitz numbers based on the 3D Lipschitz number that will accumulate over the substepping. This avoids the Watkins algorithm "succeeding" only for a negative reference density to be calculated in later.
  2. The timestep used for the "wind flux" when initialising the ffsl_precomputations object is incorrect. This caused the wrong stencil extent to be calculated for substepped transport.
  3. Ensuring that the total_ref_flux owned by the flux_precomputations object is deallocated, so does not persist between separately initialised instances.

The situations that this occurs in are very rare, and cannot happen in the GC6 science configuration. However they can be seen with the TR-BDF2 timestepper when running at operational resolutions (e.g. 10 km using a 10 minute time step). There is no test in the test suite that generates this situation so no KGOs change.

Code Quality Checklist

  • I have performed a self-review of my own code
  • My code follows the project's style guidelines
  • Comments have been included that aid understanding and enhance the readability of the code
  • My changes generate no new warnings
  • All automated checks in the CI pipeline have completed successfully

Testing

  • I have tested this change locally, using the LFRic Apps rose-stem suite
  • If any tests fail (rose-stem or CI) the reason is understood and acceptable (e.g. kgo changes)
  • I have added tests to cover new functionality as appropriate (e.g. system tests, unit tests, etc.)
  • Any new tests have been assigned an appropriate amount of compute resource and have been allocated to an appropriate testing group (i.e. the developer tests are for jobs which use a small amount of compute resource and complete in a matter of minutes)

trac.log

Test Suite Results - lfric_apps - tracer_substep_more/run2

Suite Information

Item Value
Suite Name tracer_substep_more/run2
Suite User thomas.bendall
Workflow Start 2026-09-29T08:54:33
Groups Run all
Dependency Reference Main Like
casim MetOffice/casim@2026.07.1 True
jules MetOffice/jules@2026.07.1 True
lfric_apps tommbendall/lfric_apps@tracer_substep_more False
lfric_core MetOffice/lfric_core@2026.07.1 True
moci MetOffice/moci@2026.07.1 True
SimSys_Scripts MetOffice/SimSys_Scripts@2026.07.1 True
socrates MetOffice/socrates@2026.07.1 True
socrates-spectral MetOffice/socrates-spectral@2026.07.1 True
ukca MetOffice/ukca@2026.07.1 True

Task Information

✅ succeeded tasks - 1594

Security Considerations

  • I have reviewed my changes for potential security issues
  • Sensitive data is properly handled (if applicable)
  • Authentication and authorisation are properly implemented (if applicable)

Performance Impact

  • Performance of the code has been considered and, if applicable, suitable performance measurements have been conducted

AI Assistance and Attribution

  • Some of the content of this change has been produced with the assistance of Generative AI tool name (e.g., Met Office Github Copilot Enterprise, Github Copilot Personal, ChatGPT GPT-4, etc) and I have followed the Simulation Systems AI policy (including attribution labels)

Documentation

  • Where appropriate I have updated documentation related to this change and confirmed that it builds correctly

PSyclone Approval

  • If you have edited any PSyclone-related code (e.g. PSyKAl-lite, Kernel interface, optimisation scripts, LFRic data structure code) then please contact the HPC Optimisation Team

Sci/Tech Review

  • I understand this area of code and the changes being added
  • The proposed changes correspond to the pull request description
  • Documentation is sufficient (do documentation papers need updating)
  • Sufficient testing has been completed

(Please alert the code reviewer via a tag when you have approved the SR)

Code Review

  • All dependencies have been resolved
  • Related Issues have been properly linked and addressed
  • CLA compliance has been confirmed
  • Code quality standards have been met
  • Tests are adequate and have passed
  • Documentation is complete and accurate
  • Security considerations have been addressed
  • Performance impact is acceptable

@tommbendall Thomas Bendall (tommbendall) added the enhancement New feature or request label Sep 25, 2026
@github-actions github-actions Bot added the cla-modified The CLA has been modified as part of this PR - added by GA label Sep 25, 2026
@github-actions

Copy link
Copy Markdown

⚠️ Hello Thomas Bendall (@tommbendall)!

Your CLA signature was found on the base branch, but you appear to have modified the CONTRIBUTORS.md file in this PR.

Please do not edit the CONTRIBUTORS.md file. If you have already signed the CLA, revert changes to the file and your signature will be picked up.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR improves the Watkins algorithm when there is substepping of tracers. The 3D Lipschitz number is now included in the threshold, and the correct dt is used to multiply the transporting_wind in the transport_controller. The code is clear and well commented.

This PR does not change KGOs as these stability issues are very rare and only become apparent in some of the longer GC tests. I am happy to approve.

@tommbendall

Copy link
Copy Markdown
Contributor Author

Closing as these changes will now be included in #733

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-modified The CLA has been modified as part of this PR - added by GA enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants