Skip to content

Add Pressure Gradient design document#226

Open
sbrus89 wants to merge 6 commits intoE3SM-Project:developfrom
sbrus89:omega/pgrad-design
Open

Add Pressure Gradient design document#226
sbrus89 wants to merge 6 commits intoE3SM-Project:developfrom
sbrus89:omega/pgrad-design

Conversation

@sbrus89
Copy link
Collaborator

@sbrus89 sbrus89 commented Apr 22, 2025

This PR adds the design document for the pressure gradient module for Omega-1. Compiled version here.

Checklist

  • Documentation:
    • Design document has been generated and added to the docs
    • Documentation has been built locally and changes look as expected

Copy link
Collaborator

@vanroekel vanroekel left a comment

Choose a reason for hiding this comment

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

Looks good, just a couple tiny questions from me.

Copy link

@philipwjones philipwjones left a comment

Choose a reason for hiding this comment

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

Just a couple of questions...

@mark-petersen
Copy link
Collaborator

Test compiled and posted here.

Copy link

@xylar xylar left a comment

Choose a reason for hiding this comment

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

@sbrus89, a few things to chat about at our Wednesday meeting (or sooner if you prefer). Nothing that should hold up moving forward on this.

## Verification and Testing

### Test: Spatial convergence to exact solution
For a given analytical $v$, $h$, and $b$, the spatial convergence of the pressure gradient can be assessed by computing errors on progressively finer meshes.
Copy link

Choose a reason for hiding this comment

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

What is $b$ in this case?

Copy link

Choose a reason for hiding this comment

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

I think maybe this should be fleshed out a bit more. What analytic test would we use?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I revised this part slightly. I think we just need to specify arbitrary functions for the $\alpha$, $h$, and $z$, then we can test the convergence of the discrete tendency compared to the analytical solution.

@sbrus89 sbrus89 force-pushed the omega/pgrad-design branch 4 times, most recently from 674c345 to 16c3c49 Compare September 17, 2025 14:05
@mark-petersen
Copy link
Collaborator

Latest version compiled here.

Copy link
Collaborator

@mark-petersen mark-petersen left a comment

Choose a reason for hiding this comment

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

Thanks for your work on this. It looks great!

Co-authored-by: Mark Petersen <mark.petersen.la@gmail.com>
Copy link

@xylar xylar left a comment

Choose a reason for hiding this comment

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

A few comments on the design doc, all of them small and hopefully easy to address.

Comment on lines +250 to +251
### Test: Baroclinic gyre
The baroclinic gyre test case will test the pressure gradient term in the full non-Boussinesq equations.
Copy link

Choose a reason for hiding this comment

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

I don't think we'll have the baroclinic gyre test in time for our testing needs.

Let's link to the seamount and the overflow test cases here (actually liking to the Polaris docs).

And we'll add my 2-column test as soon as I have a draft PR.

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants