Skip to content

Fix sign of the radial-velocity term in the documented mixture pressure - #1740

Merged
sbryngelson merged 1 commit into
masterfrom
docs/eos-bubble-ptilde-sign
Aug 20, 2026
Merged

Fix sign of the radial-velocity term in the documented mixture pressure#1740
sbryngelson merged 1 commit into
masterfrom
docs/eos-bubble-ptilde-sign

Conversation

@sbryngelson

Copy link
Copy Markdown
Member

Description

docs/documentation/equations.md gave the Euler-Euler modified mixture pressure as

p = (1 - alpha) p_l + alpha ( <R^3 p_bw>/<R^3> - rho <R^3 Rdot^2>/<R^3> )

with a minus on the radial-velocity term. That sign is wrong. Ando (Caltech thesis, 2010) writes the mixture momentum flux as p_l - ptilde in Eq. (2.2), with

ptilde = alpha ( p_l - <R^3 p_bw>/<R^3> - rho <R^3 Rdot^2>/<R^3> )   Eq. (2.5)

Both terms are negative inside the parenthesis, so

p_l - ptilde = (1 - alpha) p_l + alpha ( <R^3 p_bw>/<R^3> + rho <R^3 Rdot^2>/<R^3> )

and the radial-velocity contribution is positive. Eq. (A.71) of the same thesis carries the two contributions in a single bracket with the same sign, which is an independent check.

This matches what m_riemann_solver_hllc.fpp computes, where the correction is folded into pres_L and pres_R in place. The documentation was wrong, not the solver.

Type of change

  • Documentation

Scope

  • This PR comprises a set of related changes with a common goal

Testing

Documentation only. No solver code is touched and no golden files move. ./mfc.sh precheck passes.

Notes

Reported by R. Jason Scharff in #1739, which this resolves.

The Euler-Euler modified mixture pressure in equations.md carried a minus on
the rho <R^3 Rdot^2> / <R^3> term. Ando (Caltech thesis, 2010) writes the
momentum flux as pl - ptilde in Eq. (2.2) with

  ptilde = alpha (pl - <R^3 pbw>/<R^3> - rho <R^3 Rdot^2>/<R^3>)   Eq. (2.5)

so both terms are negative inside the parenthesis and the radial-velocity
contribution to pl - ptilde is positive. Eq. (A.71) carries the two terms in a
single bracket with the same sign. This matches what the HLLC solver computes
in m_riemann_solver_hllc.fpp, which folds the correction into pres_L and
pres_R directly. The documentation was wrong, not the solver.

Reported by R. Jason Scharff in #1739.
Copilot AI lite review requested due to automatic review settings August 19, 2026 20:52

Copilot AI left a comment

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.

Pull request overview

Updates MFC’s governing-equations documentation for Euler–Euler bubbles to match the solver’s implemented modified mixture pressure formulation by correcting the sign of the radial-velocity-squared contribution.

Changes:

  • Corrected the documented modified mixture pressure equation by flipping the sign of the radial-velocity term contribution from negative to positive.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@sbryngelson
sbryngelson merged commit 555f3e4 into master Aug 20, 2026
34 of 35 checks passed
@sbryngelson
sbryngelson deleted the docs/eos-bubble-ptilde-sign branch August 20, 2026 03:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants