Skip to content

External gravity wave#325

Merged
cbegeman merged 22 commits into
E3SM-Project:mainfrom
jeremy-lilly:external-gravity-wave
Jun 5, 2025
Merged

External gravity wave#325
cbegeman merged 22 commits into
E3SM-Project:mainfrom
jeremy-lilly:external-gravity-wave

Conversation

@jeremy-lilly
Copy link
Copy Markdown
Contributor

@jeremy-lilly jeremy-lilly commented May 23, 2025

This PR reimplements the test case from #187 on top of modern Polaris.

We create a new ocean task for testing the temporal convergence rate of time-stepping schemes. The case is that of a simple external gravity wave on an aquaplant. The normal velocity is initialized to zero and the layer thickness is initialized as a Gaussian bump. The PR also implements a version of the task for local time-stepping schemes. Convergence plots produced by this task for FB_LTS are given below.

convergence_normalVelocity
convergence_layerThickness

Note that the external gravity wave case was chosen so as to have as few terms in the tendencies as possible -- because of this, both the LTS and FB-LTS schemes show their "true" order of convergence, rather than the first order convergence caused by the operator splitting that both the LTS and FB_LTS codes implement.

Big thanks to @gcapodag who wrote a lot of the original test case.

Checklist

  • User's Guide has been updated
  • Developer's Guide has been updated
  • Documentation has been built locally and changes look as expected
  • Testing comment in the PR documents testing used to verify the changes
  • New tests have been added to a test suite

@gcapodag
Copy link
Copy Markdown

Nice @jeremy-lilly

Comment thread polaris/ocean/convergence/__init__.py
Comment thread polaris/ocean/convergence/analysis.py
@jeremy-lilly jeremy-lilly marked this pull request as ready for review May 29, 2025 14:59
Comment thread docs/developers_guide/ocean/tasks/external_gravity_wave.md Outdated
Comment thread docs/developers_guide/ocean/tasks/external_gravity_wave.md Outdated
Comment thread docs/developers_guide/ocean/tasks/external_gravity_wave.md Outdated
Comment thread docs/developers_guide/ocean/tasks/external_gravity_wave.md Outdated
Comment thread docs/users_guide/ocean/tasks/external_gravity_wave.md Outdated
Comment thread docs/users_guide/ocean/tasks/external_gravity_wave.md Outdated
Comment thread polaris/tasks/ocean/external_gravity_wave/init.py
Comment thread polaris/tasks/ocean/external_gravity_wave/__init__.py Outdated
Comment thread polaris/tasks/ocean/external_gravity_wave/__init__.py Outdated
Comment thread polaris/tasks/ocean/external_gravity_wave/forward.py Outdated
Comment thread polaris/tasks/ocean/external_gravity_wave/forward.py Outdated
Comment thread polaris/tasks/ocean/external_gravity_wave/forward.py Outdated
Comment thread polaris/tasks/ocean/external_gravity_wave/forward.yaml Outdated
@xylar xylar added the enhancement New feature or request label May 30, 2025
@xylar xylar added the ocean Related to the ocean component label May 30, 2025
jeremy-lilly and others added 5 commits June 2, 2025 06:42
Co-authored-by: Carolyn Begeman <cbegeman@lanl.gov>
Co-authored-by: Carolyn Begeman <cbegeman@lanl.gov>
Co-authored-by: Carolyn Begeman <cbegeman@lanl.gov>
@jeremy-lilly jeremy-lilly requested a review from cbegeman June 3, 2025 15:32
Copy link
Copy Markdown
Collaborator

@cbegeman cbegeman left a comment

Choose a reason for hiding this comment

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

@jeremy-lilly Thanks for addressing all of my comments and suggestions! Great work here. This time integrator convergence test will be useful as we test Omega as well.

@cbegeman
Copy link
Copy Markdown
Collaborator

cbegeman commented Jun 3, 2025

@jeremy-lilly I see that some items in the checklist are not marked as completed. Can you look those over and let me know if this is ready to merge?

@jeremy-lilly
Copy link
Copy Markdown
Contributor Author

Testing

All tasks have been tested using MPAS-O on Perlmutter.

@jeremy-lilly
Copy link
Copy Markdown
Contributor Author

@jeremy-lilly I see that some items in the checklist are not marked as completed. Can you look those over and let me know if this is ready to merge?

Should be good to go!

@cbegeman
Copy link
Copy Markdown
Collaborator

cbegeman commented Jun 5, 2025

Great! Thanks for all your hard work on this @jeremy-lilly!

@cbegeman cbegeman merged commit be5e369 into E3SM-Project:main Jun 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request ocean Related to the ocean component

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants