Document the baseline, hypotheses, measured results, failed approaches, current policy defaults, and remaining rotating n=3 and virial limitations. Include the authoritative LaTeX report, Pandoc-generated Markdown, compiled PDF, source provenance, branch decisions, and consolidation validation. Organize raw results and miscellaneous artifacts under working/ without deleting them; version the directory guide, relocation hashes, archive verifier, and report build/conversion checks. Keep build caches at their original paths and clearly distinguish retained binaries from the validated research build. Preserve experimental policies without promoting failed trials to defaults.
3554 lines
191 KiB
TeX
3554 lines
191 KiB
TeX
\documentclass[11pt,a4paper]{article}
|
|
\usepackage[T1]{fontenc}
|
|
\usepackage[utf8]{inputenc}
|
|
\usepackage{lmodern}
|
|
\usepackage[margin=23mm]{geometry}
|
|
\usepackage{amsmath,amssymb}
|
|
\usepackage{booktabs,longtable,array}
|
|
\usepackage{graphicx}
|
|
\usepackage{xcolor}
|
|
\usepackage{xurl}
|
|
\usepackage{microtype}
|
|
\usepackage{enumitem}
|
|
\usepackage{hyperref}
|
|
\hypersetup{colorlinks=true,linkcolor=blue!45!black,urlcolor=blue!55!black,
|
|
pdftitle={MeanField numerical research and consolidation handoff},
|
|
pdfauthor={MeanField research record}}
|
|
\setlength{\emergencystretch}{3em}
|
|
\setlength{\parskip}{0.35em}
|
|
\setlength{\parindent}{0pt}
|
|
\setcounter{tocdepth}{2}
|
|
\setcounter{secnumdepth}{3}
|
|
\setlist{itemsep=0.25em,topsep=0.35em}
|
|
\title{MeanField numerical research\\and consolidation handoff\\
|
|
\large Formulation, experiments, evidence, architecture, and remaining work}
|
|
\author{Research record prepared with Codex\\
|
|
\small Source and numerical evidence: 16--20 September 2026}
|
|
\date{20 September 2026}
|
|
\begin{document}
|
|
\maketitle
|
|
\thispagestyle{empty}
|
|
\vfill
|
|
\begin{center}
|
|
Experimental three-dimensional FEM stellar equilibria\\
|
|
Independent density; coupled free surface; polytropic EOS\\[1em]
|
|
\textbf{The moderately rotating $n=3$ and full virial targets remain open.}\\[1em]
|
|
This document separates measured results from hypotheses, and retained
|
|
research tools from promoted defaults.
|
|
\end{center}
|
|
\clearpage
|
|
\tableofcontents
|
|
\clearpage
|
|
|
|
\section{Purpose, scope and current conclusion}
|
|
|
|
MeanField is an experimental three-dimensional finite-element laboratory for
|
|
steady rotating stellar equilibria. Its immediate purpose is to establish
|
|
reliable numerical choices for a later implementation, rather than to present
|
|
a finished stellar-evolution or production equilibrium code. The user is
|
|
independently rewriting the implementation in order to own and understand the
|
|
eventual shipped software. The useful output of this investigation is therefore
|
|
the formulation, verified contracts, measured successes and failures, and
|
|
reproducible evidence that can guide that rewrite.
|
|
|
|
This report consolidates the work recorded from 16 through 19 September 2026
|
|
and the source/evidence integration performed on 20 September. Earlier
|
|
optimization and validation records are preserved as historical sources. The
|
|
conversation is not treated as an experimental log: quantitative claims below
|
|
come from committed reports, campaign manifests, saved vectors, diagnostic
|
|
tables and recorded checks. The initial approximately tenfold performance gain
|
|
and approximately 20-second Newton step for the nonrotating $n=1$ model were
|
|
the user's starting observation. They are not remeasured as a new speedup in
|
|
this consolidation. At the outset, limited testing suggested plausible $n=1$
|
|
models at very low rotation, described by the user as roughly 1.5 percent of
|
|
critical, while increasing index or rotation produced residual plateaus. That
|
|
rough starting description is not a calibrated critical-rotation measurement
|
|
for the later campaign inputs.
|
|
|
|
\subsection{Physical and software objectives}
|
|
|
|
The immediate physical target is a moderately rotating $n=3$ polytrope, with
|
|
an eventual comparison against ESTER. The operational rotation goal is at least
|
|
50 percent of critical rotation. The more distant ambition of exceeding
|
|
99 percent of critical rotation is outside the demonstrated regime and would
|
|
require renewed attention to surface regularity and the vanishing effective
|
|
gravity near mass shedding. No value of the dimensionless angular momentum
|
|
used in these campaigns has been calibrated to a critical-rotation fraction.
|
|
Neither a visually oblate model nor a small $J$ proves a particular fraction
|
|
of critical rotation.
|
|
|
|
The key global milestone is a relative virial error no larger than $10^{-5}$.
|
|
The original July project README described an aspirational $10^{-6}$ target;
|
|
the research acceptance target in this report is the subsequently specified
|
|
$10^{-5}$. Internal pointwise correctness remains necessary. Exterior accuracy
|
|
is required insofar as it supports the correct interior and boundary response;
|
|
an independently accurate external field everywhere is not the immediate
|
|
scientific objective. Nevertheless, the exterior formulation can influence
|
|
interior gravity and cannot be disregarded merely because its own residual is
|
|
small.
|
|
|
|
The software objectives are equally explicit: retain a physics-oriented user
|
|
API, express algorithm and field compatibility through types where practical,
|
|
use runtime checks for mesh-dependent and state-dependent conditions, preserve
|
|
independent density, and solve surface coefficients and interior fields in the
|
|
same coupled system. Central density is an optional physical specification;
|
|
it must not be silently imposed on every polytrope. Log density and new
|
|
positivity enforcement are deferred. Existing optional feasibility experiments
|
|
remain available for reproduction but are not enabled by consolidation.
|
|
|
|
\subsection{What has actually been demonstrated}
|
|
|
|
There is substantial progress, but the central rotating $n=3$ goal is open.
|
|
The strongest established results are:
|
|
\begin{enumerate}
|
|
\item The native all-$m$, degree-four real spherical-harmonic surface
|
|
prescription is integrated and tested against the corresponding nodal geometry,
|
|
physical residuals and Jacobian actions. It reduces the surface to 25
|
|
independent coefficients without decoupling it from the interior solve.
|
|
\item Some low-index, slowly rotating native-harmonic cases meet both their
|
|
algebraic stopping criterion and the global virial target. Higher-index
|
|
representation errors and unresolved pointwise checks prevent generalizing
|
|
this to every algebraically converged case.
|
|
\item At the same frozen state, gravity-Schur coupling reduced the measured
|
|
total linear cost by 41.5 percent for $n=3,J=0$ and by 30.6 percent for
|
|
$n=1.5,J=0.1$, at the stated true-defect gate. These are single matched
|
|
comparisons, including setup, rather than statistical timing estimates.
|
|
\item In the compatible rotating $n=3,J=0.035,K/K_0=0.99$ family, stellar LDU
|
|
plus gravity-Schur reached a 12.687-times lower residual after ten updates than
|
|
gravity-Schur alone, at 14.593 percent greater Newton time. This is an
|
|
equal-update endpoint comparison, not a speedup to the same converged model.
|
|
\item The best rotating $n=3$ endpoint still fails the full virial target:
|
|
the enthalpy-pressure energy error is $1.81141\times10^{-5}$, and the
|
|
density-pressure energy error is $3.51558\times10^{-5}$. Passing one force
|
|
virial is insufficient.
|
|
\item Physical-plane slices now show independent density and enthalpy on the
|
|
actual deformed stellar geometry, with signed values and the undeformed
|
|
outline available for comparison. Export refinement has been checked for
|
|
selected $n=2$ and rotating $n=1.5$ states; it is not a mesh-convergence proof.
|
|
\end{enumerate}
|
|
|
|
Several attractive paths did not justify promotion: simple one-way
|
|
material-to-gravity completion, increasing displacement order alone, expensive
|
|
coarse surface/scalar corrections, and universal use of second-order trial
|
|
corrections. Some improve an isolated metric while increasing total work or
|
|
worsening the accepted nonlinear trajectory. Those negative results are
|
|
preserved because they constrain the next design, not because the algorithms
|
|
are impossible to improve.
|
|
|
|
\subsection{How to use this record}
|
|
|
|
The report first reconstructs the baseline and sequence of hypotheses, then
|
|
describes the current implementation, numerical evidence and interpretation.
|
|
Later sections distinguish active defaults from selectable experimental
|
|
policies and record the consolidation checks. The source reports under
|
|
\nolinkurl{experiments/} provide the most direct detailed companion records.
|
|
\nolinkurl{reports/archive/} contains branch and relocation inventories.
|
|
\nolinkurl{working/research/diagnostics/} contains the preserved raw campaigns.
|
|
The large raw archive is local and intentionally not committed to Git; a
|
|
source-only clone will not contain its saved models or copied executables.
|
|
Versioned figure copies and this report remain usable without that archive.
|
|
|
|
\section{Definitions and evidence discipline}
|
|
|
|
\subsection{Physical variables and virial diagnostics}
|
|
|
|
For the polytropic experiments, pressure obeys
|
|
\begin{equation}
|
|
P(\rho)=K\rho^{1+1/n},\qquad
|
|
h(\rho)=(n+1)K\rho^{1/n},\qquad
|
|
\rho_\star(h)=\left(\frac{h}{(n+1)K}\right)^n
|
|
\label{eq:report-polytrope}
|
|
\end{equation}
|
|
on their physical nonnegative domains. The discrete density and enthalpy are
|
|
independent finite-element fields; the weak closure equation does not make
|
|
them pointwise equal. Consequently an integral formed from $P(\rho_h)$ need
|
|
not agree with one formed from $P(h_h)$ at the same discrete state. Undefined
|
|
fractional powers of negative density must be reported as undefined, not
|
|
silently replaced with a positive or clipped value.
|
|
|
|
For a zero-pressure stellar boundary, define
|
|
\begin{equation}
|
|
T=\frac12\int_{\mathcal{D}_\star}\rho \lvert \boldsymbol{v}\rvert^2\,dV,
|
|
\qquad \Pi=\int_{\mathcal{D}_\star}P\,dV,
|
|
\qquad W_\Phi=\frac12\int_{\mathcal{D}_\star}\rho\Phi\,dV.
|
|
\end{equation}
|
|
With the usual negative gravitational potential, $W_\Phi<0$. The force
|
|
binding integral $W_f$ uses the corresponding gravitational force moment and
|
|
agrees with $W_\Phi$ for a consistent isolated equilibrium. The campaign
|
|
observers report energy and force virials using the common normalization
|
|
$\lvert W_\Phi\rvert$:
|
|
\begin{equation}
|
|
v_\Phi=\frac{2T+3\Pi+W_\Phi}{\lvert W_\Phi\rvert},\qquad
|
|
v_f=\frac{2T+3\Pi+W_f}{\lvert W_\Phi\rvert}.
|
|
\label{eq:report-virials}
|
|
\end{equation}
|
|
Tables generally show their absolute values unless signs are explicitly
|
|
given. A nonzero external pressure requires the boundary-pressure term;
|
|
the stated campaign comparisons use the zero-pressure surface convention.
|
|
Both pressure reconstructions and both gravity forms are retained where
|
|
they are defined. Agreement at quadrature orders 14 and 18 is an integration
|
|
consistency check on a fixed discrete state, not evidence of spatial
|
|
convergence or exact pointwise physics.
|
|
|
|
The common campaign scale is $M=R_{\rm reference}=G=1$ unless a manifest
|
|
states otherwise. Angular momentum $J$, angular velocity, $T/\lvert W\rvert$, radius
|
|
and critical-rotation fraction are different quantities. The physical-family
|
|
compatibility study later explains why this distinction is particularly
|
|
important at $n=3$.
|
|
|
|
\subsection{Algebraic quantities and cost accounting}
|
|
|
|
Let $x$ denote the complete normalized coupled coordinate vector and $F(x)$ its
|
|
normalized residual. Write $A=DF(x)$ for its Jacobian; this notation avoids
|
|
confusing the Jacobian with the stellar angular momentum $J$. A Newton
|
|
correction $p$ is checked through the fresh full-system defect
|
|
\begin{equation}
|
|
\eta_{\rm true}=\frac{\lVert F(x)+Ap\rVert}{\lVert F(x)\rVert}.
|
|
\label{eq:report-linear-defect}
|
|
\end{equation}
|
|
An internal Krylov recurrence or a reduced-system residual cannot substitute
|
|
for this full-system endpoint test. The nonlinear merit function is
|
|
$\mathcal{M}(x)=\tfrac12\lVert F(x)\rVert^2$; its directional derivative is
|
|
$F(x)^T A p$. Linear success and a negative initial merit derivative do not
|
|
guarantee acceptance of a finite step on a curved coupled path.
|
|
|
|
The state and residual norms are produced by the configured physical Riesz
|
|
normalization. They should not be compared across a change of basis, field
|
|
order or normalization as though they were the same physical norm. The
|
|
experiments therefore retain physical residual checks and integrals in
|
|
addition to normalized algebraic quantities. A block's fraction of $\lVert F\rVert^2$
|
|
is an algebraic attribution; it is not an elementwise PDE error estimate.
|
|
|
|
Frozen comparisons hold the complete base state, Jacobian, right-hand side,
|
|
mesh and coordinates fixed. Their relevant linear cost includes
|
|
construction, binding, setup, solve and a fresh endpoint verification. Live
|
|
comparisons follow evolving nonlinear states and include preparation,
|
|
accepted/rejected trials and auxiliary solves in the recorded Newton time.
|
|
Process wall time can additionally include observers and export overhead.
|
|
Setup amortization must therefore be demonstrated on an actual repeated-use
|
|
path rather than assumed from a smaller outer iteration count.
|
|
|
|
\subsection{Controls, provenance and limits of inference}
|
|
|
|
The adopted methodology used an isolated branch for each hypothesis or a
|
|
clearly identified cumulative integration branch. A source revision and
|
|
configuration were recorded before numerical work; campaign runners copied
|
|
the executable, recorded its digest and retained the exact commands, mesh
|
|
digest, saved state and block diagnostics. Builds, FEM runs and timing trials
|
|
were serialized within the later controlled studies. Read-only analysis and
|
|
source review could proceed independently. Single-run timings are reported
|
|
as observations; no confidence interval or cross-machine performance claim
|
|
is inferred from them.
|
|
|
|
The pressure/shape investigations separated preparation feasibility,
|
|
linear accuracy, initial descent and finite-step curvature. Derivative probes
|
|
used directional or centered differences over a stated step grid and compared
|
|
full versus component actions. Later snapshot loaders check dimensions,
|
|
mesh, coordinate conventions and provenance rather than accepting a vector
|
|
solely because its length matches. Unconverged restarts require an explicit
|
|
diagnostic override. Saved-state initialization prepares and refreshes before
|
|
committing, clears stale warm starts and rolls back failed initialization.
|
|
|
|
The evidence checkers reject corrupt or inconsistent fixtures as well as
|
|
accepting valid ones. Passing an artifact audit establishes consistency of
|
|
the recorded experiment under that checker's contract. It does not establish
|
|
that the nonlinear model converged, that all interior samples are physical,
|
|
or that a target virial was attained. Similarly, passing code assertions is
|
|
not equivalent to obtaining a validated stellar model.
|
|
|
|
All finite iteration budgets and diagnostic ceilings remain explicit.
|
|
A late small-step trajectory can be described as a stall observed over the
|
|
available window. It cannot be promoted to a mathematically established
|
|
convergence floor. Dense quadrature samples can locate negativity but cannot
|
|
certify its absence everywhere; interval subdivision and polynomial bounds
|
|
have their own scope and unresolved cases. Conclusions in this report retain
|
|
those distinctions.
|
|
|
|
\section{Starting point, problem definition, and architecture}
|
|
|
|
The work began on 16 September 2026 with an already substantial experimental
|
|
finite-element code. Its purpose was to discover a reliable numerical route to
|
|
three-dimensional steady stellar equilibria before a later, independently
|
|
written general-EOS implementation. The immediate physical model was a
|
|
self-gravitating, rigidly rotating barotrope with a free stellar surface. The
|
|
presence of older transport, Coriolis, viscosity, and continuity components did
|
|
not mean that those equations participated in the active equilibrium solve.
|
|
This distinction remains important when comparing the experimental code with
|
|
the broader physics ultimately desired from a stellar structure application.
|
|
|
|
The incoming Git HEAD was \texttt{75cc63873992984966ea20011cc04d9984f54be4}.
|
|
It did not uniquely describe the audited source: 49 tracked files already
|
|
differed, with 3,626 additions and 267 deletions, and additional untracked
|
|
experiments and results were present. The later baseline commit
|
|
\texttt{80cc3d8} on \nolinkurl{research/baseline-20260916} preserved that optimized
|
|
source. The initial architecture audit was read-only. The subsequent diagnosis
|
|
used fresh Release builds rather than assuming that existing executables
|
|
represented the modified source. This provenance distinction is essential:
|
|
historical binaries and historical passing tests are evidence about their own
|
|
source, not automatically about the current checkout.
|
|
|
|
The user reported approximately a tenfold reduction in the cost of an ordinary
|
|
nonrotating $n=1$ Newton step, to about twenty seconds. Fresh measurements found
|
|
22--24 seconds for the first three accepted steps and were consistent with that
|
|
operating point. The old pre-optimization source was not rerun in a matched
|
|
comparison; the full historical factor of ten was therefore not independently
|
|
remeasured. The inherited 9 September report had separately measured factors
|
|
of 1.53 in whole-process time, 1.70 in Newton time, and 2.02 in linear-solve time
|
|
for its particular batch. Later tensor, cache, and compact-action changes had
|
|
different baselines. These gains must not be multiplied together.
|
|
|
|
\subsection{Continuum equations and independent discrete fields}
|
|
|
|
For a polytrope of index $n\geq1$ and constant $K>0$,
|
|
\begin{align}
|
|
P&=K\rho^{1+1/n}, &
|
|
h&=(n+1)K\rho^{1/n}, &
|
|
\rho_{\mathrm{EOS}}(h)&=\left[\frac{h}{(n+1)K}\right]^n,
|
|
\qquad h\geq0.
|
|
\end{align}
|
|
With positive centrifugal potential
|
|
$\Psi=\lvert\boldsymbol\Omega\mathbin{\times}\boldsymbol x\rvert^2/2$,
|
|
the Bernoulli imbalance is
|
|
\begin{equation}
|
|
B=h+\Phi-\Psi-C.
|
|
\end{equation}
|
|
The gravity flux represents $\boldsymbol g=\nabla\Phi$, so physical
|
|
gravitational acceleration is $-\boldsymbol g$. The active system combines a
|
|
mixed gradient--potential gravity formulation, a weak density closure, weak
|
|
Bernoulli balance, reduced mechanical virtual work, and integral constraints
|
|
for total mass and axial angular momentum. Density, enthalpy, potential, and
|
|
the gravity flux are independent finite-element fields. In particular, the
|
|
mechanical pressure is evaluated from enthalpy while gravity and centrifugal
|
|
forces use independent density. Continuum equivalence of these quantities
|
|
does not force their pointwise equality after discretization.
|
|
|
|
The surface condition replaces the relevant enthalpy test rows by the
|
|
enthalpy value corresponding to prescribed surface pressure. At zero surface
|
|
pressure this is an $h=0$ trace condition. The mechanical residual is first
|
|
formed against volume displacements and then pulled back by the transpose of
|
|
the surface-to-volume deformation derivative. If $q$ denotes independent
|
|
surface parameters and $D(q)$ the generated displacement, its schematic form is
|
|
\begin{equation}
|
|
R_s(q,u)=D'(q)^T R_{\mathrm{mech}}(D(q),u).
|
|
\end{equation}
|
|
The Jacobian includes both the derivative of the mechanical force and the
|
|
derivative of this pullback. A zero $R_s$ proves equilibrium only against the
|
|
chosen extension-generated mechanical tests; it does not set every unrestricted
|
|
volume mechanical row to zero.
|
|
|
|
The usual initial example additionally imposed a central-density specification.
|
|
Its actual row was a central enthalpy point condition,
|
|
\begin{equation}
|
|
R_c=h(0)-h(\rho_{c,\mathrm{target}}),\qquad
|
|
R_h\longleftarrow R_h+\lambda_c e_c.
|
|
\end{equation}
|
|
It was not a direct point condition on the independent discontinuous density.
|
|
This distinction motivated measuring the unbordered residual and artificial
|
|
source amplitude. The user clarified that the central condition should remain
|
|
optional, principally useful for the $n=3$ homology, and should not be
|
|
automatically inserted at other indices or hidden in a physics-facing API.
|
|
|
|
\subsection{Discretization and model compilation}
|
|
|
|
The common mesh had 1,216 hexahedra: 832 stellar and 384 vacuum elements. Its
|
|
SHA-256 was
|
|
\nolinkurl{ce11ae99e21e6c3bbfbee402acd2e191c1da0d8261d2227b4203f73f2f337a74}.
|
|
Reference geometry was order four. The ordinary spaces were RT index two for
|
|
gravity, discontinuous $Q_2$ for potential and stellar density, and continuous
|
|
$Q_3$ for enthalpy and displacement. The original scalar nodal radial surface
|
|
had 866 parameters. With its three scalar constraints the root had 178,074
|
|
unknowns; removing the central specification removed one scalar, yielding
|
|
178,073. Mesh geometry order and the approximation order of an individual
|
|
physical field were distinct controls.
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{105mm}p{40mm}@{}}
|
|
\hline
|
|
Initial root block & Number of unknowns \\
|
|
\hline
|
|
Gravity gradient & 98,928 \\
|
|
Potential & 32,832 \\
|
|
Stellar density & 22,464 \\
|
|
Stellar enthalpy & 22,981 \\
|
|
Nodal radial surface & 866 \\
|
|
Generated scalar coordinates & 3 \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
The architecture was already strongly compositional. A compile-time model
|
|
specification pack generated the block layout, scalar coordinates, Jacobian
|
|
couplings, normalization metadata, and prepared specification runtimes. The
|
|
active aggregate was the variadic prepared equilibrium operator. C++23 module
|
|
interfaces under \nolinkurl{libmeanfield/interface} were separated from
|
|
implementations under \nolinkurl{libmeanfield/impl}. MFEM/MPI spaces used explicit
|
|
maps between supported solver coordinates and full true degrees of freedom.
|
|
The nonlinear context owned accepted and trial states, normalization, inverse
|
|
preparation, and linear backend; refresh, stale-view rejection, rollback, and
|
|
observer lifetime were explicit contracts rather than informal conventions.
|
|
|
|
Prepared matrix-free actions cached reference basis tables, geometry,
|
|
thermodynamics, and local contractions. Their dependency identities and
|
|
revisions controlled invalidation. The numerical work therefore emphasized
|
|
reusing established ownership and preparation interfaces rather than adding
|
|
ad hoc mutable solver state. Static choices such as block identities,
|
|
compatible policy combinations, and registered capabilities were checked at
|
|
compile time. Mesh sizes, rank agreement, actual FE eligibility, values,
|
|
normalization factors, and preparation generations necessarily required
|
|
runtime validation.
|
|
|
|
The geometry map initially used nodal radial surface variation, a logical
|
|
radius-squared interior extension, and a fixed-infinity vacuum extension.
|
|
Kelvin compactification represented the exterior through infinity. The root
|
|
geometry unknown was the surface, not the much larger volume displacement
|
|
field. Surface parameterization, interpolation of displacement, extension,
|
|
and the physical map were therefore distinct architectural responsibilities.
|
|
|
|
The seed initialized density and enthalpy independently by finite-element
|
|
coefficient interpolation of a spherical Lane--Emden profile, using MFEM's
|
|
\texttt{ProjectCoefficient}, and solved mixed gravity separately. This
|
|
initialization was distinct from solving the weak closure's weighted $L^2$
|
|
projection relation; the method name must not be read as implying such a
|
|
mass-matrix solve. It set shape to zero,
|
|
initialized $C$ from $-GM/R$, and initialized $\Omega$ from the target $J$
|
|
divided by spherical inertia. A seed with nonzero target $J$ was not an
|
|
already rotating equilibrium. Throughout the early controlled campaign,
|
|
$M=R_{\mathrm{reference}}=G=1$; at $n=1$, $K=2/\pi$ and
|
|
$\rho_c=\pi/4$. Other indices used the production Lane--Emden integrator
|
|
with step $10^{-3}$ to calibrate the seed. That was a consistent seed
|
|
reference, not an independent high-precision continuum solution.
|
|
|
|
\subsection{Physical acceptance and measurement conventions}
|
|
|
|
The required milestone was virial balance within $10^{-5}$, together with
|
|
credible interior fields. Exterior pointwise accuracy was not an independent
|
|
goal; exterior errors mattered through their effect on stellar equilibrium.
|
|
The campaign measured both gravitational energies
|
|
\begin{equation}
|
|
W_E=\frac12\int_\star\rho\Phi\,dV,
|
|
\qquad
|
|
W_F=-\int_\star\rho\,\boldsymbol x\cdot\nabla\Phi\,dV,
|
|
\end{equation}
|
|
and, for the zero-pressure surface,
|
|
\begin{equation}
|
|
\epsilon_V(W,P)=
|
|
\frac{\left\lvert 2T+W+3\int_\star P\,dV\right\rvert}{\lvert W_E\rvert}.
|
|
\end{equation}
|
|
Pressure from $h$ and pressure from $\rho$ were evaluated separately, at
|
|
independent diagnostic quadrature orders 14 and 18. Signed density was retained.
|
|
When the EOS could not define pressure at a negative density sample, the full
|
|
density-pressure diagnostic was reported undefined, rather than manufactured
|
|
by clipping. Quadrature agreement tested integration sensitivity; it did not
|
|
constitute spatial convergence or global positivity certification.
|
|
|
|
The first physical checker required recorded nonlinear convergence and all
|
|
eight finite virial measurements to satisfy $10^{-5}$. This conservative
|
|
combined screen was stricter than a statement that a particular enthalpy-based
|
|
virial passed. Neither passing the checker nor a small scalar virial alone was
|
|
a pointwise continuum-accuracy certificate. Useful accompanying observations
|
|
were mass and angular-momentum errors, Bernoulli variation, EOS mismatch,
|
|
gravity consistency, geometry minima, density sign, and surface shape.
|
|
No early value of $J$ or reference-unit $\Omega$ was calibrated as a fraction
|
|
of critical rotation.
|
|
|
|
The inherited saved $n=1,J=0$ benchmark already provided a useful physical
|
|
reference beyond the scalar residual: density, enthalpy, interior potential,
|
|
and gravity-gradient relative volume $L^2$ errors were approximately
|
|
$4.70\,10^{-4}$, $3.27\,10^{-4}$, $1.26\,10^{-4}$, and
|
|
$5.98\,10^{-4}$; surface-radius RMS error divided by reference radius was
|
|
$2.75\,10^{-4}$. Its density-pressure energy virial was
|
|
$3.10\,10^{-7}$ and mass error $2.36\,10^{-11}$. These were the
|
|
particular saved coarse model's errors against its radial reference, not
|
|
accuracy estimates for later rotating or higher-index cases. A one-level
|
|
refined mesh and analytic geometry controls existed, but the corresponding
|
|
directory did not contain completed refined equilibrium fields or an
|
|
equilibrium convergence result. The audit did not infer completed mesh
|
|
convergence from the presence of that directory.
|
|
|
|
The historical full-suite XML contained 592 cases, 588 passing and four
|
|
failing: centrifugal-virial refinement geometry, an $n=3$ projected-seed
|
|
closure screen, and two- and four-rank MPI groups. Those failures had been
|
|
reproduced in earlier preserved binaries. They were neither silently removed
|
|
nor treated as fresh validation of the incoming modified source. At the
|
|
initial audit, twelve production source files were newer than the available
|
|
release sandbox binary and thirty newer than the test binary. This motivated
|
|
the subsequent explicit rebuilds and targeted regression ledgers. A
|
|
previous between-sample mesh fold was also documented, but the later saved
|
|
$n=1$ mesh had healthier sampled geometry; it was not assumed to suffer the
|
|
same demonstrated folding mechanism.
|
|
|
|
\paragraph{Evidence.}
|
|
The original workspace reports were
|
|
\nolinkurl{reports/sources/original_audits/MeanField_audit_2026-09-16.md},
|
|
\nolinkurl{reports/sources/original_audits/MeanField_solver_diagnosis_2026-09-16.md}, and
|
|
\nolinkurl{reports/sources/original_audits/formulation_audit_notes.md}. Their archival relocation is recorded in
|
|
the consolidation manifest. Repository evidence includes
|
|
\nolinkurl{experiments/POLYTROPE_VALIDATION_FINDINGS_2026-09-09.md},
|
|
\nolinkurl{experiments/POLYTROPE_H_CONVERGENCE_2026-09-09.md}, and
|
|
\nolinkurl{experiments/NUMERICAL_CAMPAIGN_2026-09-16.md}.
|
|
|
|
\section{Initial diagnosis: several different plateaus}
|
|
|
|
\subsection{Fresh control measurements}
|
|
|
|
The diagnostic rebuilt the incoming optimized source in Release using
|
|
Homebrew Clang 22.1.8, with IPO enabled, profiling disabled, and uniform field
|
|
order increment zero. Cases ran serially on one MPI rank. Initial live controls
|
|
used FGMRES restart 40, at most 200 linear iterations, relative forcing
|
|
tolerance $\eta=0.03$, nonlinear relative tolerance $10^{-8}$ and zero absolute
|
|
tolerance. The nonlinear threshold was relative to the initial residual, not
|
|
an absolute $10^{-8}$ requirement.
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{26mm}p{24mm}p{35mm}p{59mm}@{}}
|
|
\hline
|
|
Model & Accepted updates & Retained $\lVert F\rVert$ & $P(h)$ energy/force virials \\
|
|
\hline
|
|
$n=1,J=0$ & 3 full & $6.6053\,10^{-9}$ & $2.616\,10^{-7}/3.246\,10^{-7}$ \\
|
|
$n=1,J=0.01$ & 4 full & $5.0898\,10^{-10}$ & $2.610\,10^{-7}/3.246\,10^{-7}$ \\
|
|
$n=1,J=0.05$ & 5 full & $6.0406\,10^{-9}$ & $3.016\,10^{-7}/3.188\,10^{-7}$ \\
|
|
$n=1.5,J=0$ & $1,1/16$ & $1.6976\,10^{-4}$ & $2.245\,10^{-6}/2.318\,10^{-6}$ \\
|
|
$n=3,J=0$ & 0 & $3.1006\,10^{-3}$ & $5.326\,10^{-5}/8.341\,10^{-5}$ \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
All these controls stopped at a failed linear gate. The $n=3$ measurement was
|
|
the unchanged seed. At $n=1,J=0$ the strict target was approximately
|
|
$1.81\,10^{-12}$, whereas an earlier validation driver accepted the same
|
|
three-step state under an absolute $10^{-8}$ threshold. These descriptions
|
|
were consistent; they did not imply that a previously converged model had
|
|
become physically invalid. Conversely, the $n=1$ seed itself already passed
|
|
the virial threshold, directly demonstrating why virial alone was not a
|
|
complete equilibrium test.
|
|
|
|
The initial audit separated three mechanisms: loss of useful Krylov
|
|
information late in otherwise accurate $n=1$ solves; stronger coupled linear
|
|
difficulty at higher index; and severe nonlinear curvature or admissibility
|
|
restrictions after a usable linear direction was obtained. It did not find
|
|
evidence for one universal numerical floor.
|
|
|
|
\subsection{Normalization audit}
|
|
|
|
The state and residual registrations supplied their own physical scales and
|
|
reference Gram diagonals. Writing these as $s_x,d_{x,i}$ for a value block and
|
|
$s_F,d_{F,i}$ for its residual/test block, ordinary coefficient factors were
|
|
\begin{equation}
|
|
S_{ii}=\frac{\sqrt{d_{x,i}}}{s_x},\qquad
|
|
L_{ii}=\frac{1}{s_F\sqrt{d_{F,i}}}.
|
|
\end{equation}
|
|
The Gram factors form paired primal and dual maps where the registered
|
|
function-space topologies correspond, but the physical scales need not agree.
|
|
For example, surface parameters use a length scale while mechanical shape
|
|
residuals use a force scale; potential uses specific energy while its Poisson
|
|
residual uses inverse time squared. Point replacement rows and scalar blocks
|
|
have their declared special treatment. These distinctions are explicit in
|
|
\nolinkurl{libmeanfield/interface/normalization/physical_riesz.cppm}.
|
|
|
|
The reference factors were frozen through a solve. Their characteristic
|
|
scales came from $M,R_{\mathrm{reference}},G$ and did not divide by the
|
|
requested angular momentum $J$; zero rotation was therefore not a
|
|
normalization singularity.
|
|
|
|
Let $\widehat x=Sx$ and $\widehat F=LF$. The consistent transformations were
|
|
\begin{equation}
|
|
\widehat A=LAS^{-1},\qquad
|
|
\widehat P^{-1}=SP^{-1}L^{-1},\qquad
|
|
\widehat A\widehat P^{-1}=LAP^{-1}L^{-1}.
|
|
\end{equation}
|
|
Consequently, changing only state scales cancels from a consistently
|
|
right-preconditioned system. Direct probes multiplying block state scales by
|
|
$10^{-3}$ through $10^3$ preserved the physical correction and preconditioned
|
|
action to approximately $10^{-16}$. Wrapper/explicit actions and coordinate
|
|
round trips agreed at roundoff. This ruled against a basic scaling-wrapper
|
|
implementation error at the inspected states. It did not show that the chosen
|
|
residual norm was optimal: changing $L$ changes what both Krylov and line
|
|
search minimize.
|
|
|
|
The same $M=R=G=1$ factors were used across indices despite changing stellar
|
|
concentration. Large factor ranges alone did not diagnose a bug. Similarly,
|
|
small normalized border matrices had raw condition numbers
|
|
$2.78\,10^7$ and $9.69\,10^7$, dominated by a central-column scale near
|
|
$7.3\,10^6$; diagnostic equilibration reduced these to about 1.46 and 2.39.
|
|
Those were border-matrix observations, not the condition number of the full
|
|
stellar Jacobian or proof of a singular physical system.
|
|
|
|
\subsection{Central condition: a useful example correction}
|
|
|
|
At $n=1,J=0.05$, matched restart-40 runs with and without the central
|
|
condition had identical first five accepted step lengths and linear iteration
|
|
counts. Both then failed the sixth linear gate near relative defect 0.505.
|
|
Removing the condition nevertheless markedly improved localized physical
|
|
consistency:
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{70mm}p{38mm}p{38mm}@{}}
|
|
\hline
|
|
Quadrature-18 measurement & With central condition & Without \\
|
|
\hline
|
|
Peak absolute EOS density mismatch & $7.30451\,10^{-3}$ & $3.32568\,10^{-4}$ \\
|
|
Peak mismatch / sampled density scale & $9.33951\,10^{-3}$ & $4.30594\,10^{-4}$ \\
|
|
Bernoulli sampled range & $1.45751\,10^{-2}$ & $1.30398\,10^{-3}$ \\
|
|
Unbordered residual & $4.54227\,10^{-6}$ & $6.03609\,10^{-9}$ \\
|
|
$P(h)$ energy virial & $3.01617\,10^{-7}$ & $3.06913\,10^{-7}$ \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
The formerly fixed central enthalpy changed from 1 to 0.983383508. Mass,
|
|
angular momentum, angular velocity, and volume RMS errors changed little.
|
|
The result supported removing that artificial restriction from the $n=1$
|
|
example, while leaving explicit central constraints available. It did not
|
|
establish that central constraints caused the general plateau.
|
|
|
|
\subsection{Krylov window and warm-guess safeguard}
|
|
|
|
Frozen cold comparisons retained the same state, full Jacobian, physical
|
|
right-hand side, and inverse. Increasing only the restart window from 40 to
|
|
160 gave:
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{70mm}p{38mm}p{38mm}@{}}
|
|
\hline
|
|
Frozen state & Window 40: iterations / defect & Window 160: iterations / defect \\
|
|
\hline
|
|
$n=1,J=0$ endpoint & $200/0.04442$ & $72/0.02914$ \\
|
|
$n=1,J=0.01$ endpoint & $200/0.35468$ & $125/0.02519$ \\
|
|
$n=1.5,J=0$ endpoint & $200/0.06491$ & $70/0.02694$ \\
|
|
$n=3,J=0$ seed & $200/0.05631$ & $200/0.04026$ \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
For the rotating $n=1$ state, histories coincided through iteration 40 and
|
|
separated immediately after restart. Independently recomputed full residuals
|
|
agreed with reported residuals. This established actual loss of useful Krylov
|
|
information, not false convergence reporting. In a live unbordered
|
|
$n=1,J=0.05$ comparison, restart 160 reached strict convergence in seven full
|
|
steps with $F=3.38036\,10^{-11}$, versus five steps and
|
|
$6.03609\,10^{-9}$ before linear failure with restart 40. Total linear
|
|
iterations were 292 versus 370; complete diagnostic-process times were 271.95
|
|
versus 290.80 seconds. All eight virial checks were below
|
|
$3.735\,10^{-7}$. These were single timing observations with increased
|
|
Krylov storage, not a universal speedup claim.
|
|
|
|
The solver reused $(1-\alpha)p$ after a damped update as the next initial
|
|
linear guess. This was vector reuse, not Krylov recycling. At one $n=1.5$
|
|
state that guess had a true defect larger than the zero guess. A small
|
|
backend safeguard now checks the current true defect of a supplied nonzero
|
|
guess and discards it only if the norm is nonfinite or exceeds $\lVert b\rVert$.
|
|
Nonfinite input coefficients remain an input-contract error. The guard adds
|
|
one action for a nonzero guess and none for a zero guess, without a new public
|
|
option.
|
|
|
|
The matched $n=1$ output was bitwise unchanged. At $n=1.5$, the first shared
|
|
guarded solve reduced the effective initial defect/RHS from 1.5097 to 1 and
|
|
iterations from 71 to 65. Over eight attempts the control had seven successful
|
|
linear solves followed by failure; the guard passed all eight. Total iterations
|
|
fell from 672 to 561, mostly by avoiding that failed 200-iteration attempt.
|
|
The endpoint changed only from $1.75135\,10^{-4}$ to
|
|
$1.74946\,10^{-4}$, a 0.108 percent improvement, with final steps
|
|
$1/2048$ and $1/8192$. This was a modest inner-solver robustness improvement,
|
|
not a cure for nonlinear stagnation.
|
|
|
|
\subsection{Rejected one-way gravity completion}
|
|
|
|
The first coupling hypothesis changed the structure inverse from independent
|
|
material/gravity blocks to material-then-gravity triangular completion. It
|
|
retained the material inverse, order-five Chebyshev flux-mass inverse, and
|
|
three AMG cycles, and rebuilt the scalar border consistently. At the same
|
|
centrally constrained $n=3$ seed, the restart-160 defect changed from
|
|
0.0402590 to 0.0381781 after 200 iterations; both failed $\eta=0.03$.
|
|
Time increased from 98.92 to 117.71 seconds, correction norm from 0.75764
|
|
to 1.54083, and the sampled thermodynamic step limit worsened from 0.15244
|
|
to 0.09135. The candidate's $\alpha=0.1$ trial was inadmissible.
|
|
This particular one-way completion was not promoted.
|
|
|
|
The baseline restart-40 and restart-160 corrections had cosine $-0.985$
|
|
despite the same matrix and right-hand side. Their difference had a response
|
|
bound $\lVert A(p_2-p_1)\rVert/\lVert p_2-p_1\rVert\leq2.77\,10^{-4}$.
|
|
This established a weak measured direction, not a singular value or an
|
|
identification of homology, translation, or a surface mode. Later studies
|
|
therefore examined the actual coupled directions instead of adding a gauge
|
|
on analogy alone.
|
|
|
|
\paragraph{Evidence.}
|
|
\nolinkurl{experiments/NUMERICAL_CAMPAIGN_2026-09-16.md},
|
|
\nolinkurl{experiments/CENTRAL_CONSTRAINT_HYPOTHESIS_2026-09-16.md},
|
|
\nolinkurl{experiments/KRYLOV_WINDOW_HYPOTHESIS_2026-09-16.md}, and
|
|
\nolinkurl{experiments/KRYLOV_HYPOTHESIS_2026-09-16.md}. The combined nonrotating
|
|
$n=1$ case subsequently reached $F=1.65157\,10^{-13}$ in six full steps
|
|
with worst virial $3.73092\,10^{-7}$. The transfer case $n=1,J=0.1$
|
|
passed all twelve linear gates but ended at $6.25389278\,10^{-3}$, with
|
|
final $\alpha=4.76837\,10^{-7}$ and failing enthalpy-based virials
|
|
$4.75186\,10^{-4}/8.18118\,10^{-4}$. That transfer failure motivated
|
|
the next investigation.
|
|
|
|
\section{Separating pressure preparation from shape-related curvature}
|
|
|
|
The focused 17 September campaign made no production numerical changes. It
|
|
captured exact trial states, identified rejection stages, and split the same
|
|
Newton correction into its actual shape block $p_s$ and all remaining fields
|
|
and scalars $p_f$. Frozen replays restored the base before each action;
|
|
probing a trial never committed it as an accepted model.
|
|
|
|
\subsection{The rotating pressure obstruction was localized and real}
|
|
|
|
At $n=1,J=0.1$, exact replays of the first rejected candidates at zero-based
|
|
iterations 2, 3, 4, 7, and 11 all returned the production code
|
|
\texttt{thermodynamic\_domain / pressure\_force / outside\_domain}.
|
|
The pressure source takes this branch for finite negative enthalpy.
|
|
Thus these were enthalpy-domain failures, not inverted geometry. The limiting
|
|
pressure point remained at local stellar element 459, quadrature point 50;
|
|
the closure's different rule limited at point 36 of the same element.
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{14mm}p{30mm}p{30mm}p{30mm}p{30mm}@{}}
|
|
\hline
|
|
Iteration & Pressure-point $h$ & $\delta h$ & Pressure bound & Accepted $\alpha$ \\
|
|
\hline
|
|
2 & $9.63674\,10^{-4}$ & $-1.31441\,10^{-2}$ & $7.33159\,10^{-2}$ & $1/16$ \\
|
|
3 & $1.42165\,10^{-4}$ & $-2.11119\,10^{-3}$ & $6.73390\,10^{-2}$ & $1/16$ \\
|
|
4 & $1.02159\,10^{-5}$ & $-1.89704\,10^{-3}$ & $5.38520\,10^{-3}$ & $1/256$ \\
|
|
7 & $7.04574\,10^{-8}$ & $-1.86569\,10^{-3}$ & $3.77648\,10^{-5}$ & $1/32768$ \\
|
|
11 & $1.07227\,10^{-9}$ & $-1.86493\,10^{-3}$ & $5.74963\,10^{-7}$ & $1/2097152$ \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
The pressure step budget fell by a factor of 127,514 while the late negative
|
|
direction remained finite. The limiting element touched the stellar surface;
|
|
the pressure point's reference Cartesian radius was 0.997553, near the negative
|
|
rotation pole, approximately 8.66 degrees from the negative $z$ axis at onset.
|
|
It was an interior quadrature point, not a boundary row. Topological adjacency
|
|
did not measure distance to the deformed surface.
|
|
|
|
At onset the closure bound, 0.0727489, was slightly tighter than the pressure
|
|
bound; pressure was evaluated first and therefore reported first when both
|
|
failed. A deliberately intermediate trial at
|
|
$\alpha=0.07303236911639208$ passed pressure preparation and failed closure,
|
|
with predicted closure $h=-5.01979\,10^{-6}$ and limiting pressure
|
|
$h=+3.72619\,10^{-6}$. This showed why a first rejection stage must not be
|
|
confused with the tightest thermodynamic constraint.
|
|
|
|
All 866 surface enthalpy coefficients and their directions were exactly zero
|
|
at onset and late capture. Boundary leakage was excluded for these trials.
|
|
Nevertheless, positive nodal values did not imply a positive represented
|
|
polynomial. A step just beyond the onset bound retained nonnegative values
|
|
at all 64 local $Q_3$ nodes while making interior pressure and closure samples
|
|
negative. At the late state even a unit step retained nonnegative nodes but
|
|
gave $h=-1.86493\,10^{-3}$ at the limiting pressure point.
|
|
|
|
An independent reconstruction of the local tensor polynomial reproduced the
|
|
nodes exactly and limiting-point values within $6.94\,10^{-18}$. A much
|
|
denser grid found that the late accepted base already had negative enthalpy:
|
|
a sampled minimum $-2.87114\,10^{-5}$ at reference coordinates
|
|
$(0.0130467,0.515625,0.01)$. A separate 60-digit reconstruction agreed with
|
|
the negative value at another selected interior point. These findings proved
|
|
negative values existed in that element; the reported minimum was not a
|
|
certified global minimum. Passing production quadrature preparation was thus
|
|
not a pointwise positivity certificate. They also did not prove that every
|
|
low-rotation or nonrotating converged control shared this defect.
|
|
|
|
\subsection{Higher-index merit rejection had a different mechanism}
|
|
|
|
For any directional piece $p_d$, the diagnostic measured
|
|
\begin{equation}
|
|
R_d(\alpha)=F(x+\alpha p_d)-F(x)-\alpha Ap_d,
|
|
\qquad R_{\mathrm{mixed}}=R_{\mathrm{full}}-R_s-R_f.
|
|
\end{equation}
|
|
The mixed vector was formed before taking norms. All pieces used common step
|
|
lengths and the original, unrenormalized block amplitudes. With
|
|
$L=F+\alpha Ap$, the exact merit identity was
|
|
\begin{equation}
|
|
\lVert F(x+\alpha p)\rVert^2=
|
|
\lVert L\rVert^2+2\langle L,R_{\mathrm{full}}\rangle
|
|
+\lVert R_{\mathrm{full}}\rVert^2.
|
|
\end{equation}
|
|
|
|
At $n=1.5,J=0$, captured iteration 1, the raw full trial was admissible with
|
|
minimum sampled Jacobian 0.896116. Its linear prediction was only 0.02576812
|
|
of the base norm; the actual residual was 12.243161 times the base norm.
|
|
At $\alpha=0.1$ the actual ratio remained 1.02052 rather than the predicted
|
|
0.900070; at 0.01 it decreased to 0.991209. This established nonlinear merit
|
|
failure separately from the rotating thermodynamic wall.
|
|
|
|
Gravity-gradient actions from shape and fields had norms 0.115959 and
|
|
0.116055, cosine $-0.999999831$, and combined norm
|
|
$1.16990\,10^{-4}$. Poisson actions also nearly cancelled, with cosine
|
|
$-0.999996055$. Damping shape alone would have destroyed this measured
|
|
first-order balance. The full-step second-order remainder was
|
|
$2.18903\,10^{-3}$, with 99.7747 percent of its squared norm in gravity.
|
|
Fixed-shape gravity is affine in its fields in the source; measured
|
|
fields-only gravity remainders remained at arithmetic scale. Resolved
|
|
remainders divided by $\alpha^2$ stabilized, consistent with the directional
|
|
Jacobian rather than a persistent first-order derivative error.
|
|
|
|
At the constrained $n=3$ seed the original correction still failed the
|
|
$0.03$ forcing gate, attaining 0.0402590; it was not silently replaced by
|
|
a better direction. At its common cap $\alpha=0.12194828$, the actual norm
|
|
was 1.0237652 of the base versus prediction 0.87826014. Gravity accounted
|
|
for 90.7812 percent of the squared remainder. At one tenth of this cap the
|
|
trial decreased the residual, and the net curvature contribution was slightly
|
|
favorable. A large mixed term therefore did not imply that its signed merit
|
|
projection was always adverse.
|
|
|
|
The consequence was to keep feasibility and nonlinear path curvature as
|
|
separate hypotheses. A sampled enthalpy cap could avoid futile trials but
|
|
would not remove a wall where $h\to0$ and $\delta h<0$. Nor could exterior
|
|
weighting be justified from whole-gravity-block norms alone: the original
|
|
probes had not yet localized stellar versus exterior contributions.
|
|
|
|
\paragraph{Evidence.}
|
|
\nolinkurl{experiments/PRESSURE_AND_SHAPE_CAMPAIGN_2026-09-17.md},
|
|
\nolinkurl{experiments/PRESSURE_OBSTRUCTION_METHODOLOGY_2026-09-17.md}, and
|
|
\nolinkurl{experiments/POLYNOMIAL_ENTHALPY_ADMISSIBILITY_2026-09-17.md}.
|
|
The eight focused and two supplemental cases restored their base residuals
|
|
exactly; direction partitions and signed-merit identities passed independent
|
|
checks. No additional virial-qualified model was produced by these probes.
|
|
|
|
\section{Three optional numerical strategies and their limits}
|
|
|
|
The next implementation added three interchangeable numerical approaches:
|
|
polynomial enthalpy feasibility, gravity curvature correction, and gravity
|
|
elimination. They were selected by concrete typed policies through
|
|
\texttt{NewtonNumerics}, not added to the physics-facing model declarations.
|
|
Unregistered or incompatible policies failed compile-time constraints;
|
|
actual mesh and FE eligibility were checked collectively at runtime. The
|
|
ordinary Newton path remained available and defaults were unchanged.
|
|
|
|
\subsection{Polynomial enthalpy certification and anchor repair}
|
|
|
|
The diagnostic converted the represented nodal polynomial to a tensor
|
|
Bernstein representation with outward-rounded interval arithmetic. Adaptive
|
|
subdivision returned a nonnegativity certificate, a negative-value witness,
|
|
or unresolved bounds. A negative Bernstein coefficient by itself was not
|
|
misclassified as a negative polynomial. Exact zero traces were retained.
|
|
Certification used physical enthalpy coordinates, because general diagonal
|
|
normalization does not preserve the polynomial represented by the coefficients.
|
|
|
|
For an admissible base, a fixed certified initial field supplied an anchor:
|
|
\begin{equation}
|
|
p_h(\beta)=(1-\beta)p_h+\beta(h_{\mathrm{anchor}}-h),
|
|
\qquad0\leq\beta\leq1.
|
|
\end{equation}
|
|
Sufficient Bernstein inequalities constrained the repair fraction and the full
|
|
linear residual model selected a fraction. The actual normalized-and-added
|
|
candidate was certified again, and its complete merit derivative had to remain
|
|
negative. This was a conservative feasible-direction family, not a constrained
|
|
Newton optimizer, and it did not make the independent density positive.
|
|
|
|
At the rotating onset the base certified and the original full trial was
|
|
proved negative. Whole-mesh certification cost about 3--4 ms. The sufficient
|
|
repair fraction was 0.9152726503; repaired polynomials prepared successfully,
|
|
but trial lengths 1, 0.5, and 0.125 all increased the full residual. The linear
|
|
model's best step was near 0.00825, with only about 0.46 percent predicted
|
|
residual reduction. The already negative late base correctly returned
|
|
\texttt{invalid\_base} and left accepted buffers unchanged. This path supplied
|
|
useful diagnostic and admissibility machinery, but was not established as an
|
|
efficient route through the nonlinear obstacle. The later user decision to
|
|
defer positivity enforcement was consistent with this mixed result.
|
|
|
|
\subsection{Gravity-only curvature correction}
|
|
|
|
Partition the normalized state into retained variables $u$ and gravity
|
|
variables $z$, with gravity equations $G(u,z)$. At a raw trial
|
|
$y=x+\alpha p$, the correction solved
|
|
\begin{equation}
|
|
G_z(y)\,\delta z=
|
|
-\bigl[G(y)-G(x)-\alpha G'(x)p\bigr].
|
|
\end{equation}
|
|
Only gravity coordinates changed. This removes the nonlinear gravity
|
|
remainder, not the entire gravity residual. It preserves the base tangent
|
|
because the right-hand side is second order along a smooth path, and it
|
|
vanishes on an affine gravity path even when the base residual is nonzero.
|
|
The candidate inverse was refreshed, every residual was reevaluated, and
|
|
ordinary full-merit acceptance remained authoritative.
|
|
|
|
The first frozen $n=1.5$ comparison changed the full trial residual from
|
|
$2.18913190375\,10^{-3}$ to $1.40702031008\,10^{-4}$ at base norm
|
|
$1.78804469158\,10^{-4}$. The gravity remainder fell from
|
|
$2.18656200516\,10^{-3}$ to $1.37482284578\,10^{-12}$, with observed
|
|
correction order 1.999898 on the smallest resolved steps. This was direct
|
|
evidence that the identified curvature could be removed from gravity.
|
|
|
|
An initial production attempt was intentionally stopped after repeated
|
|
auxiliary prepared-consistency rejection despite converged inner solves.
|
|
The arithmetic allowance had omitted large cancelling gravity contributions.
|
|
The revised check included separately measured gradient, potential, source,
|
|
and correction actions; it used $256\epsilon$ times their norm sum as a
|
|
heuristic allowance, not a rigorous error bound. The true inner gate, lifted
|
|
full-Jacobian gate, nonlinear tolerance, and physical criteria were not relaxed.
|
|
The interrupted run and correction history were preserved.
|
|
|
|
\subsection{Gravity elimination}
|
|
|
|
Gravity elimination instead completed gravity at the initial state and each
|
|
retained trial, then used the reduced Schur action
|
|
\begin{equation}
|
|
S=F_u-F_zG_z^{-1}G_u.
|
|
\end{equation}
|
|
Right-hand-side condensation included the residual gravity defect, and lifting
|
|
reconstructed a full correction that still had to satisfy the original full
|
|
normalized linear gate. Tolerance-stopped inner Krylov solves only approximated
|
|
this linear action; flexible outer preconditioning did not magically make it
|
|
exact. Tight inner gates, finite-difference checks, and lifted verification
|
|
were therefore retained.
|
|
|
|
The reference implementation restricted the full operator and inverse. A
|
|
capability-checked compact path reused the existing prepared physical gravity
|
|
actions with the same scaling. On three dense actual-FEM directions compact
|
|
and full-restricted outputs agreed exactly. Gravity operator applications
|
|
cost about 0.018 versus 0.244 seconds, around fourteen times faster, while
|
|
inverse applications changed only from approximately 0.205 to 0.160 seconds.
|
|
A matched tight inner solve retained forty iterations and the same result
|
|
while falling from 18.36 to 7.25 seconds. The fourteenfold action gain was
|
|
not a fourteenfold Newton speedup.
|
|
|
|
\subsection{Production outcomes of the three strategies}
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{55mm}p{24mm}p{32mm}p{35mm}@{}}
|
|
\hline
|
|
Model and path & Accepted updates & Final $\lVert F\rVert$ & Newton seconds / outcome \\
|
|
\hline
|
|
$n=1,J=0$, curvature & 6 & $6.51136\,10^{-14}$ & 273.71 / converged \\
|
|
$n=1,J=0$, eliminated & 6 & $8.98743\,10^{-14}$ & 869.67 / converged \\
|
|
$n=1.5,J=0$, curvature & 6 & $1.48794\,10^{-5}$ & 711.72 / outer gate failure \\
|
|
$n=1.5,J=0$, eliminated & 5 & $4.47888\,10^{-6}$ & 1821.79 / completed updates only \\
|
|
$n=1,J=0.1$, polynomial & 3 & $7.13059\,10^{-3}$ & 265.03 / outer gate failure \\
|
|
Polynomial plus curvature & 1 & $8.40387\,10^{-3}$ & 127.05 / outer gate failure \\
|
|
Polynomial plus elimination & 1 & $2.72634\,10^{-2}$ & 149.83 / non-descent repair \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
The two nonrotating $n=1$ gravity paths and polynomial control reached the
|
|
same discrete model to coefficient differences below $2.632\,10^{-11}$.
|
|
All eight virials were below $3.73092\,10^{-7}$; independent enthalpy
|
|
certificates covered all 832 stellar elements. The eliminated control used
|
|
107 inner solves and 3,875 inner iterations, versus six solves and 115
|
|
iterations for curvature correction. It was a verified alternative, but
|
|
substantially more expensive.
|
|
|
|
The $n=1.5$ curvature run reduced the initial norm about eighteenfold but
|
|
failed its seventh outer solve at relative defect 0.059017 after 200
|
|
iterations. All fourteen auxiliary solves passed. The eliminated run was
|
|
externally interrupted at 2,400 seconds during its sixth attempt, after five
|
|
accepted steps of $1,1/2,1/4,1/128,1/2048$. Its last accepted gravity residual
|
|
was about $3.27\,10^{-14}$ while retained equations remained of order
|
|
$10^{-6}$; the last step improved the total residual only 0.00565 percent.
|
|
This showed stagnation despite completed gravity. No final snapshot or
|
|
complete physical diagnostics existed for the timed-out run, so these were
|
|
not invented from its log.
|
|
|
|
Rotating runs remained both unconverged and virially unacceptable. The
|
|
polynomial-only fourth linear attempt attained 0.0331634 rather than the
|
|
required 0.03. Adding curvature improved the first step with the same tangent
|
|
but the second linear solve failed at 0.0826534. Polynomial plus elimination
|
|
passed its reduced and lifted linear gates before a repaired direction failed
|
|
descent. A reporting replay later established that this failure occurred
|
|
before another gravity relift, correcting an earlier ambiguous interpretation
|
|
of counters. All these models retained negative independent density samples.
|
|
|
|
The implementation was covered by 43 targeted serial cases and 1,886
|
|
assertions at the final revision, with 37 supported cases on each of two
|
|
MPI ranks. Full stellar multi-rank operation was not thereby certified:
|
|
logical radial surface interpolation and per-rank material ownership
|
|
restrictions remained. The frozen checks established algebra and lifecycle
|
|
invariants; they did not constitute physical convergence.
|
|
|
|
\paragraph{Evidence.}
|
|
\nolinkurl{experiments/NUMERICAL_STRATEGIES_2026-09-17.md},
|
|
\nolinkurl{experiments/GRAVITY_SUBSYSTEM_IMPLEMENTATION_2026-09-17.md},
|
|
\nolinkurl{experiments/GRAVITY_REDUCTION_IMPLEMENTATION_2026-09-17.md},
|
|
\nolinkurl{experiments/GRAVITY_COMPACT_APPLICATIONS_2026-09-17.md}, and
|
|
\nolinkurl{experiments/GRAVITY_PREPARED_ROUNDOFF_2026-09-17.md} retain the
|
|
complete policy contracts, intermediate failed builds/runs, and replay history.
|
|
|
|
\section{Preconditioner improvements measured at equal accuracy}
|
|
|
|
\subsection{Baseline approximation and work accounting}
|
|
|
|
The original inverse first treated surface and material through a triangular
|
|
surface-then-enthalpy-then-density approximation. Surface used a reference
|
|
mass diagonal; enthalpy used hydrostatic mass and identity treatment at
|
|
replaced boundary rows; density included the live EOS enthalpy derivative.
|
|
Material-to-surface feedback was omitted. Gravity used approximate mixed LDU
|
|
with a degree-five Chebyshev mass inverse and three fixed AMG cycles for a
|
|
potential surrogate. Structure-level material and gravity were independent,
|
|
then a small dense scalar Schur complement completed specification borders
|
|
relative to that approximate inverse. The live high-$n$ EOS derivative was
|
|
present; there was no evidence that the baseline simply omitted it.
|
|
|
|
Frozen benchmark roles each constructed fresh inverses and border responses
|
|
at the same saved state, full Jacobian, normalization, and right-hand side.
|
|
Reported complete verified cost included inverse construction, normalized
|
|
binding, Krylov setup, solve, and an independent full-Jacobian endpoint action.
|
|
Failed solves were retained but never used as finite baseline
|
|
time-to-convergence measurements. Timing runs and large audits were serialized.
|
|
|
|
\subsection{Prepared cross-action optimization}
|
|
|
|
Existing stellar LDU was initially unexpectedly expensive: at an $n=1.5$
|
|
plateau, 200 iterations cost 599.5473 seconds versus 87.9302 for the
|
|
independent baseline, and both failed the gate. The gravity-to-material
|
|
coupling used a legacy geometry-evaluation path. Replacing it with the
|
|
already prepared complete gravity-force action, with zero density and
|
|
displacement variations, preserved the same mathematical gravity-gradient
|
|
column and subsequent deformation adjoint.
|
|
|
|
The cached LDU reduced complete cost to 117.4845 seconds, a factor 5.1032
|
|
relative to the old LDU path, and mean inverse application time by 8.0425.
|
|
The correction changed only $2.7051\,10^{-11}$ relatively and the gate still
|
|
failed at 0.0600669. This was an execution optimization, not a conditioning
|
|
improvement. It deserved retention independently of whether LDU was selected
|
|
as a numerical policy.
|
|
|
|
\subsection{Mass-consistent gravity Schur refinement}
|
|
|
|
Writing the mixed gravity block as
|
|
\begin{equation}
|
|
D=\begin{bmatrix}M&B^T\\B&0\end{bmatrix},\qquad
|
|
D\begin{bmatrix}g\\\Phi\end{bmatrix}=\begin{bmatrix}f\\r_g\end{bmatrix},
|
|
\end{equation}
|
|
let $R$ be the same approximate mass inverse used for flux recovery and $Q$
|
|
the existing AMG inverse on the diagonal-mass surrogate. The added policy
|
|
used
|
|
\begin{align}
|
|
S_R&=BRB^T, & r&=BRf-r_g, & \Phi_0&=Qr,\\
|
|
\Phi_{j+1}&=\Phi_j+\omega Q(r-S_R\Phi_j), &
|
|
g&=Rf-RB^T\Phi_k.
|
|
\end{align}
|
|
The Poisson defect was thereby measured against the same approximate mass
|
|
action as recovery. This was still not an exact inverse of the mixed block.
|
|
Fixed work preserved stationarity only when the child actions themselves
|
|
declared stationary linear behavior. Positive relaxation alone did not prove
|
|
contraction. Each extra sweep cost one application of $R,Q,B,B^T$; zero
|
|
sweeps retained the old arithmetic path for bitwise baseline comparison.
|
|
|
|
One sweep with $\omega=0.5$ first crossed the original $0.03$ gate at the
|
|
$n=1.5$ saved state. An equal-accuracy confirmation gave:
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{55mm}p{22mm}p{34mm}p{29mm}@{}}
|
|
\hline
|
|
Inverse, frozen $n=1.5,J=0$ & Iterations & True relative defect & Complete cost (s) \\
|
|
\hline
|
|
Independent baseline & 231 & 0.0290033753 & 100.9943 \\
|
|
Mass-consistent gravity Schur & 132 & 0.0292091550 & 72.3727 \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
This was a measured 1.39548-fold speedup, 28.34 percent lower complete cost
|
|
and 42.86 percent fewer iterations, without relaxing accuracy. At a saved
|
|
$n=1,J=0.1$ system, the independent and gravity-only controls still failed
|
|
after 600 iterations, at defects 0.0739197 and 0.0408506. Combining cached
|
|
stellar LDU with gravity refinement passed in 142 iterations at defect
|
|
0.0299068971, complete cost 96.8236 seconds. It reduced Poisson and gradient
|
|
defect norms by 63.33 and 94.47 percent relative to the matched 200-iteration
|
|
independent control. Since the baseline had no finite observed successful
|
|
solve, no rotating speedup ratio was asserted.
|
|
|
|
A nine-mode coupled shape coarse inverse was a negative control. All modes
|
|
were active, overlap/rank checks passed, and there was no fallback, but the
|
|
200-iteration defect worsened to 0.0668658. Setup added 8.6012 seconds and
|
|
persistent vectors occupied 28,491,680 bytes. That failed candidate remained
|
|
experimental; it did not rule out every possible coarse space.
|
|
|
|
\subsection{Nonlinear transfer limited the recommendation}
|
|
|
|
For easy $n=1,J=0$, both independent and gravity-refined inverses converged
|
|
in six full steps to the same physical state, with all virials below
|
|
$3.74\,10^{-7}$. Linear iterations fell from 307 to 258, yet Newton time
|
|
rose from 191.068 to 199.375 seconds, 4.35 percent. More expensive inverse
|
|
applications outweighed iteration reduction.
|
|
|
|
For $n=1.5,J=0$ with gravity curvature correction, the stronger inverse
|
|
passed all twelve permitted outer linear gates and all 31 auxiliary gravity
|
|
solves. It removed the earlier immediate linear failure but ended at
|
|
$1.3966991\,10^{-5}$, only 6.13 percent below the old six-update endpoint
|
|
and far above target $2.7365922\,10^{-12}$. All nineteen rejections were
|
|
merit failures, with late accepted steps $1/64$ and $1/512$. Newton time
|
|
was 1075.368 seconds, including 415.038 in outer linear solves and 590.003
|
|
in preparation; nested auxiliary time must not be added again. Enthalpy-based
|
|
virials passed, but negative density persisted.
|
|
|
|
The rotating combined-inverse follow-through accepted one repaired full step
|
|
to $0.00685562$, then failed the next linear gate at 0.0339685. Its
|
|
enthalpy energy virial, 0.00712711, was worse than the historical independent
|
|
endpoint's 0.000544539 despite its smaller nonlinear residual. Both failed
|
|
physically. Frozen linear gains therefore did not justify claiming a solved
|
|
nonlinear or physical problem, and the stronger policies remained optional.
|
|
|
|
\paragraph{Evidence.}
|
|
\nolinkurl{experiments/PRECONDITIONER_IMPROVEMENT_2026-09-18.md},
|
|
\nolinkurl{experiments/GRAVITY_CONSISTENT_SCHUR_2026-09-18.md}, and
|
|
\nolinkurl{experiments/PRECONDITIONER_CACHED_CROSS_ACTION_2026-09-18.md}.
|
|
Focused serial coverage passed 20 cases and 441,978 assertions; two-rank
|
|
algebra/coarse tests passed thirteen cases per rank. The actual multi-rank
|
|
FEM test was blocked by a pre-existing partition where one rank had no
|
|
vacuum element, required by mapped H(div) construction. Refining the mesh
|
|
did not remove that ownership pattern. Serial FEM evidence must not be
|
|
described as distributed FEM validation.
|
|
|
|
\section{Why better linear solves did not remove the nonlinear stall}
|
|
|
|
The next frozen investigation used the saved $n=1.5,J=0$ endpoint with
|
|
$\lVert F\rVert=1.3966991044\,10^{-5}$. All prior linear gates had passed; the final
|
|
squared-residual shares were about 42.42 percent hydrostatic, 26.23 percent
|
|
closure, 15.87 percent surface, 10.43 percent gravity, and 5.05 percent mass.
|
|
It computed fresh cold directions rather than claiming to reconstruct raw
|
|
directions that the earlier trajectory had not saved.
|
|
|
|
For $\phi=\lVert F\rVert^2/2$ and a forcing condition
|
|
$\lVert Ap+F\rVert\leq\eta\lVert F\rVert$, a consistent derivative gives
|
|
\begin{equation}
|
|
\phi'(0)=\langle F,Ap\rangle\leq-(1-\eta)\lVert F\rVert^2.
|
|
\end{equation}
|
|
Thus a gate-passing direction should be strongly locally descending, but
|
|
this says nothing about how far the linear approximation remains useful.
|
|
|
|
\subsection{Tenfold tighter forcing did not improve the useful step}
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{70mm}p{38mm}p{38mm}@{}}
|
|
\hline
|
|
Measurement & $\eta=0.03$ & $\eta=0.003$ \\
|
|
\hline
|
|
Iterations & 84 & 143 \\
|
|
Cold linear seconds & 47.9374 & 81.6901 \\
|
|
Verified relative defect & 0.0295592 & 0.00294840 \\
|
|
Direction norm & 0.0794897 & 0.0796012 \\
|
|
Corrected residual/base at $1/64$ & 1.080323 & 1.080567 \\
|
|
Corrected residual/base at $1/256$ & 1.002025 & 1.002037 \\
|
|
Corrected residual/base at $1/1024$ & 0.999394139 & 0.999394272 \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
The tenfold stricter gate cost about seventy percent more linear work and
|
|
left the useful sampled step essentially unchanged. The directions differed
|
|
by only 0.8885 percent in norm and had cosine 0.99996157. A supplementary
|
|
minimum-norm calculation in their two-dimensional span, subject to the
|
|
original forcing gate, gained only 0.00058549 percent beyond ordinary scalar
|
|
damping of the tighter direction. This was a saved-vector algebra experiment,
|
|
not a fresh FEM trial, and did not rule out richer subspaces.
|
|
|
|
Raw trials at $1,1/4,1/16$ failed pressure preparation for this new late
|
|
direction. At $1/64$, raw and gravity-corrected residual ratios were 1.807268
|
|
and 1.080323; at $1/256$, 1.002510 and 1.002025. At $1/1024$ both decreased,
|
|
to 0.999170 and 0.999394. The remainders were resolved and approximately
|
|
quadratic over the small-step range. No persistent first-order error was
|
|
detected in the tested tangent.
|
|
|
|
\subsection{A large compensated direction amplified moderate curvature}
|
|
|
|
The separate shape and field action norms were 0.7730368 and 0.7730377,
|
|
while their sum had norm $1.396089\,10^{-5}$. The image cosine was
|
|
$-0.999999999838$, and the cancellation factor was approximately 110,743.
|
|
At the seed, the corresponding factor had been about 332.1. Normalization
|
|
factors were byte-identical across these states.
|
|
|
|
The late direction was 17.35 times larger while the residual was 19.59 times
|
|
smaller. The ratio $\lVert p\rVert/\lVert F\rVert$ grew from 16.7433 to 5691.26, about
|
|
340-fold. At the common step $1/64$, corrected curvature per squared
|
|
direction norm grew only from 0.656881 to 0.926040, about 1.41-fold; curvature
|
|
relative to the base residual grew about 8,313-fold. This pointed toward
|
|
weak coupled response and large corrections as the amplification mechanism,
|
|
rather than orders-of-magnitude growth of curvature per unit direction.
|
|
It did not identify a continuum symmetry or estimate the full Hessian.
|
|
|
|
Gravity correction reduced the small-step remainder norm by about 14.7-fold
|
|
at $1/1024$, but increased its adverse projection onto the linear predictor
|
|
2.88-fold. Hydrostatic, closure, surface, and mass rows contributed 43.52,
|
|
32.33, 19.53, and 4.63 percent of that signed projection. A smaller remainder
|
|
therefore need not produce better merit. The observed full/shape gain ratio
|
|
also gave a condition-number lower bound of about $9.07\,10^4$ if the
|
|
finite-dimensional Jacobian was nonsingular; it was not a measured global
|
|
condition number or a license to add a central constraint at $n=1.5$.
|
|
|
|
\paragraph{Evidence.}
|
|
\nolinkurl{experiments/NONLINEAR_STEP_INVESTIGATION_2026-09-18.md}. Three
|
|
immutable probes covered 144 path observations and sixty successful
|
|
auxiliary gravity solves; final saved-artifact audits passed 20,899 checks.
|
|
All states, factors, and restored actions were preserved. Those checks
|
|
established provenance and arithmetic identities, not a new model.
|
|
|
|
\section{Fully coupled second-order trial corrections}
|
|
|
|
\subsection{Bounded correction against the complete residual}
|
|
|
|
Because gravity-only correction moved adverse curvature into retained
|
|
equations, a fully coupled trial correction was implemented. At a prepared
|
|
trial $y$, it preserved the original affine target
|
|
$L(\alpha)=F_0+\alpha A_0p$ and solved
|
|
\begin{equation}
|
|
A(y)c=L(\alpha)-F(y).
|
|
\end{equation}
|
|
The auxiliary backend had its own true full-Jacobian defect check, finite budget,
|
|
and report. The correction was capped by $\lVert c\rVert\leq\alpha\lVert p\rVert$ by
|
|
default. It was attempted only after a prepared candidate failed ordinary
|
|
acceptance, with at most one solve per Newton iteration initially. A failed
|
|
solve, cap, admissibility test, or merit comparison restored the original
|
|
trial with fresh preparation. Accepted-state buffers were not mutated by the
|
|
transaction. The policy composed statically with existing enthalpy/gravity
|
|
choices and deliberately rejected the unimplemented eliminated-gravity
|
|
combination at compile time.
|
|
|
|
At the common late state, the original direction still passed with defect
|
|
0.02955918315. Independent frozen trials showed:
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{40mm}p{22mm}p{22mm}p{22mm}p{30mm}@{}}
|
|
\hline
|
|
Path and $\alpha$ & Before/base & After/base & Auxiliary iterations & Added seconds \\
|
|
\hline
|
|
Raw, $1/64$ & 1.80726810 & 1.03360191 & 34 & 27.33 \\
|
|
Raw, $1/256$ & 1.00250966 & 0.99746464 & 52 & 37.59 \\
|
|
Gravity first, $1/64$ & 1.08032296 & 1.09566246 & 55 & 47.60 \\
|
|
Gravity first, $1/256$ & 1.00202482 & 0.99810801 & 62 & 43.53 \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
All auxiliary solves passed their unchanged gate and cap. The $1/256$
|
|
trials became acceptable, while the gravity-first $1/64$ trial worsened and
|
|
was restored. The already acceptable $1/1024$ and seed full-step controls
|
|
incurred no coupled solve. Raw timing came from an uncontended repeat after
|
|
a mistakenly overlapping artifact audit was stopped and fixed; fifty saved
|
|
vector files matched the first run byte-for-byte, and the original timing
|
|
was excluded.
|
|
|
|
The correction's own curvature remained significant. For
|
|
$b=L-F(y)$, $\delta=A(y)c-b$, and
|
|
$E=F(y+c)-F(y)-A(y)c$,
|
|
\begin{equation}
|
|
F(y+c)-L=\delta+E.
|
|
\end{equation}
|
|
At $1/256$, $\lVert E\rVert$ exceeded the verified auxiliary defect by about 11.28
|
|
for the raw path and 254 for the gravity-first path. Correction/direction
|
|
cosines were $-0.9999330$ and $-0.9999942$: much of the correction reversed
|
|
the original step. Actual displacement increases relative to the old
|
|
$1/1024$ path were only 1.7596 and 1.2342, not the nominal factor four in
|
|
$\alpha$.
|
|
|
|
Fresh scalar controls matched projection along the original direction.
|
|
They decreased residual 0.115623 and 0.096934 percent, whereas the coupled
|
|
candidates decreased 0.253536 and 0.189199 percent. Small transverse components
|
|
therefore had a measured benefit; the improvement was not just scalar damping.
|
|
It remained a small absolute gain purchased with another coupled solve.
|
|
Moreover, the independent frozen alphas each had a fresh correction budget,
|
|
so this screen did not measure a live shared-budget line search.
|
|
|
|
\subsection{Damping and work-aware eligibility}
|
|
|
|
The next optional policy reused one computed $c$ across
|
|
$\beta=1,1/2,1/4,1/8$, always preparing $y+\beta c$ from the same $y$.
|
|
The first ordinarily acceptable improvement ended the search; otherwise the
|
|
best admissible improvement could be retained as a trial, with fresh replay.
|
|
An eligibility rule reserved the single solve for a candidate near the affine
|
|
prediction. For the configured deterministic merit $M$, it required positive
|
|
finite $D=M(F_0)-M(L)$ and
|
|
\begin{equation}
|
|
\frac{M(F(y))-M(F_0)}{D}\leq k,\qquad k=1\ \hbox{by default}.
|
|
\end{equation}
|
|
This was a bounded-work heuristic, not a theorem of global convergence.
|
|
|
|
A sequential halving screen exposed an important correction to the earlier
|
|
interpretation. Ordinary raw and gravity paths already accepted $1/512$;
|
|
the previous sparse grid had omitted it. The near-acceptance policy instead
|
|
accepted $1/256$, a twofold nominal increase. Without eligibility deferral,
|
|
the sole solve was spent at an unsuccessful $1/32$ and the final state was
|
|
the baseline. Both successful frozen rescues used $\beta=1$, so eligibility,
|
|
not damping, explained that particular improvement.
|
|
|
|
In uncontended raw repeats, baseline search work cost 45.76 seconds for
|
|
0.116541 percent decrease; near-acceptance correction cost 74.90 seconds
|
|
for 0.253536 percent decrease. The fractional decrease per measured
|
|
operation-second was 1.329 times greater. Those timings excluded ordinary
|
|
outer solve, commit refresh, initialization, and physical replay; they were
|
|
not Newton speedups. A clock-anomalous original gravity/full run was retained
|
|
and excluded, then repeated with independent UTC, monotonic, and child CPU
|
|
measurements.
|
|
|
|
\subsection{Matched six-update live test}
|
|
|
|
The live pair kept the seed, mesh, $n=1.5,J=0$, absent central constraint,
|
|
gravity-Schur inverse, restart 160, and $\eta=0.03$ fixed. Only the trial
|
|
policy changed. Both first updates reached
|
|
$1.614841549\,10^{-5}$ with the same recorded diagnostics.
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{70mm}p{38mm}p{38mm}@{}}
|
|
\hline
|
|
Endpoint after six updates & Gravity curvature control & Coupled policy \\
|
|
\hline
|
|
Final residual & $1.497197\,10^{-5}$ & $1.245830\,10^{-5}$ \\
|
|
Newton iteration seconds & 502.21 & 613.09 \\
|
|
Outer Krylov iterations & 354 & 341 \\
|
|
Auxiliary coupled iterations & 0 & 163 \\
|
|
$P(h)$ energy virial & $4.22590\,10^{-6}$ & $3.78554\,10^{-6}$ \\
|
|
$P(h)$ force virial & $2.71367\,10^{-6}$ & $2.31894\,10^{-6}$ \\
|
|
Minimum sampled density & $-7.73185\,10^{-4}$ & $-7.85522\,10^{-4}$ \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
The new endpoint residual was 16.79 percent lower for 22.08 percent more
|
|
Newton time. Excluding the common first update, residual decreases were
|
|
22.85 versus 7.29 percent, giving 2.53 times more decrease per iteration-second
|
|
over that bounded interval. Both stopped at the six-update cap; neither
|
|
converged. The new method initially crossed several modest residual thresholds
|
|
later than the control before eventually overtaking it.
|
|
|
|
Only one of three coupled searches was committed. At update two the full
|
|
correction worsened merit but $\beta=1/2$ passed, with a very small 0.01795
|
|
percent residual decrease. Later ordinary steps benefited from the changed
|
|
trajectory. Two other kept improvements remained unacceptable and were
|
|
followed by ordinary backtracking; they were not accumulated into the model.
|
|
This result supported retaining the policy as an experiment, not promoting it
|
|
or treating every rescued step as an efficient update. Density-pressure
|
|
virials remained undefined and local EOS extrema did not uniformly improve.
|
|
|
|
\paragraph{Evidence.}
|
|
\nolinkurl{experiments/COUPLED_TRIAL_CORRECTION_2026-09-18.md} and
|
|
\nolinkurl{experiments/DAMPED_COUPLED_TRIAL_2026-09-18.md}. The latter covered
|
|
58 serial numerical/solver cases, 23 correction cases on two MPI ranks,
|
|
56 Python checker tests, twelve frozen cases including repeats, and the
|
|
matched live pair. Its tests covered fallback, exceptions, budgets,
|
|
rank-local rejection, preserved outer reports, and typed composition.
|
|
|
|
\section{Shape freedom, field transport, and the displacement-order control}
|
|
|
|
The next investigation targeted the weak coupled response itself, preserving
|
|
the equations and avoiding an assumed gauge interpretation. At independent
|
|
quadrature orders 10 and 14, scalar pullback changes were decomposed as
|
|
\begin{equation}
|
|
\delta f_{\mathrm{Eulerian}}=\delta\widehat f-\nabla f\cdot v,
|
|
\end{equation}
|
|
where $v$ was the generated physical displacement. Density and potential
|
|
gradients were broken within-element gradients; facet jumps and RT transport
|
|
were not included. Small Eulerian/pullback ratios therefore suggested
|
|
transport compensation but could not certify a pure relabeling nullspace.
|
|
|
|
At the old twelve-update $Q_3$ endpoint, these ratios were 0.05769 for
|
|
density, 0.18870 for enthalpy, and 0.01288 for potential, versus seed values
|
|
0.3243, 0.3080, and 0.1993. A six-block sampled singular-response minimum
|
|
fell from 0.0580574 at seed to 0.000143543 late, with largest sampled response
|
|
near 22.1--22.6. The normalized block direction span itself changed with the
|
|
state, so this was not a full-Jacobian spectrum or a rank proof.
|
|
|
|
Despite an enthalpy energy virial of $4.06909\,10^{-6}$, the late
|
|
nonrotating nodal surface radii spanned 0.997674--1.010093. Its direction was
|
|
99.9995107 percent cubic-invariant in sampled squared norm, while degree-eight
|
|
spherical harmonics left 0.893679 of its nodal norm unexplained. This was
|
|
fine angular structure consistent with mesh/discretization coupling, not
|
|
evidence that all omitted modes were unphysical. The bulk and gravity
|
|
discretizations also shared cubic symmetry.
|
|
|
|
\subsection{The isolated $Q_4$ displacement experiment}
|
|
|
|
The original $Q_3$ displacement could not exactly represent the order-four
|
|
reference coordinate map: the affine identity control gave relative value
|
|
error $9.01277\,10^{-5}$ and gradient error $1.23472\,10^{-3}$.
|
|
On an isolated branch, only
|
|
\nolinkurl{libmeanfield/interface/field/field_registry.cppm},
|
|
\texttt{Displacement::vectorOrder}, changed from $3+$ uniform increment
|
|
to $4+$ uniform increment, with the increment fixed at zero. The rationale
|
|
and date were recorded in source. The shared scalar surface collection
|
|
therefore also changed from $Q_3$ to $Q_4$, increasing surface unknowns from
|
|
866 to 1538. Density/potential $Q_2$, enthalpy $Q_3$, RT2 gravity, geometry,
|
|
and the radius-squared lift were retained.
|
|
|
|
This was not a pure interpolation intervention: it added shape modes,
|
|
changed surface normalization/preconditioning, increased derived pressure
|
|
quadrature by one and gravity-force quadrature by two, and raised the
|
|
geometry-inspection request from 18 to 24. Both variants started from analytic
|
|
seeds; incompatible coefficient snapshots were not transferred.
|
|
|
|
$Q_4$ reduced affine value and gradient errors to
|
|
$2.11629\,10^{-16}$ and $3.24701\,10^{-15}$. Nevertheless, seed physical
|
|
displacement direction norm grew 31.63-fold, from 0.00121967 to 0.0385749,
|
|
and seed linear iterations grew from 26 to 67. Both initial linear gates
|
|
passed, and small trial remainders remained quadratic. The fixed six-attempt
|
|
live comparison was unfavorable:
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{70mm}p{38mm}p{38mm}@{}}
|
|
\hline
|
|
Measurement & $Q_3$ displacement/surface & $Q_4$ displacement/surface \\
|
|
\hline
|
|
Root unknowns & 178,073 & 178,745 \\
|
|
Accepted updates & 6 & 3 \\
|
|
First three accepted-step seconds & 269.31 & 505.65 \\
|
|
Residual after three / own initial & 0.056755 & 0.906188 \\
|
|
All attempted Newton seconds & 547.34 & 638.42 \\
|
|
Krylov iterations, including failure & 354 & 492 \\
|
|
$P(h)$ energy virial & $4.22590\,10^{-6}$ & $8.89666\,10^{-5}$ \\
|
|
$P(h)$ force virial & $2.71367\,10^{-6}$ & $8.27467\,10^{-6}$ \\
|
|
Hydrostatic-gradient RMS & 0.0106811 & 0.325413 \\
|
|
Nodal radius span / nodal mean & 1.09849\% & 12.2559\% \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
The fourth $Q_4$ solve and an independent cold endpoint solve both failed
|
|
after 200 iterations at relative defect 0.0868564. Even its first three
|
|
gate-passing corrections had already produced poor progress. The differing
|
|
spaces and stopped endpoints prevented an equal-accuracy comparison; the
|
|
result nevertheless ruled out matching displacement order alone as a
|
|
sufficient cure in this configuration. The $Q_4$-only change was explicitly
|
|
not recommended for promotion. It did not rule out compatible enrichment
|
|
of multiple fields.
|
|
|
|
\subsection{Two structural cautions}
|
|
|
|
A naive replacement of mechanical shape rows by surface Bernoulli moments
|
|
was identified as rank-deficient at an ideal $B=0,J=0$ root for the current
|
|
trace spaces. On the actual closed surface, continuous $Q_p$ had
|
|
$96p^2+2$ degrees of freedom, versus $96p^2$ for broken $Q_{p-1}$ potential
|
|
traces. After enforcing the zero enthalpy trace, $Q_3$ surface supplied 866
|
|
rows against 864 DG $Q_2$ trace coefficients; $C$ added no independent
|
|
constant trace dimension and the direct shape-measure derivative vanished
|
|
with $B$. This was an objection to that proposed replacement, not proof of
|
|
rank deficiency in the existing mechanical operator. Any alternative
|
|
boundary formulation needed compatible spaces and a stability analysis.
|
|
|
|
Second, correcting ambient interpolation did not make the radius-squared
|
|
extension generate a physical dilation. If $b$ was the boundary trace of
|
|
reference position $X$, the existing lift $E_0(b)$ differed from $X$; at a
|
|
logical radius $1/8$ vertex it gave one eighth of the desired affine value.
|
|
A proposed but unimplemented rank-one correction was
|
|
\begin{equation}
|
|
E(z)=E_0(z)+\bigl[X-E_0(b)\bigr]\ell(z),\qquad\ell(b)=1.
|
|
\end{equation}
|
|
It would give $E(b)=X$ while retaining the supplied trace and admit an exact
|
|
transpose. This could place physical dilation in the mechanical test space,
|
|
but would not automatically enforce the potential-energy virial, which uses
|
|
the independent mixed potential. It was kept separate from surface-space
|
|
reduction and was not claimed as an implemented remedy.
|
|
|
|
\paragraph{Evidence.}
|
|
\nolinkurl{experiments/SHAPE_FIELD_WEAK_RESPONSE_2026-09-18.md}. The $Q_4$
|
|
production change was isolated at commit
|
|
\texttt{4be1a23c3ec2650af6a2a49528a8f5248cb001c3}; 22 targeted cases and
|
|
380,856 assertions passed. That correctness coverage did not convert its
|
|
negative numerical outcome into a recommendation.
|
|
|
|
\section{The bounded smooth-surface study}
|
|
|
|
The user authorized a one-hour study, recorded as 19:30:15--20:30:15 UTC on
|
|
18 September. It retained $Q_3$ displacement, $Q_4$ reference geometry,
|
|
$Q_2$ density/potential, $Q_3$ enthalpy, RT2 gravity, the same extension,
|
|
$n=1.5,J=0$, and no central constraint. It changed only independent surface
|
|
variation through a frozen affine embedding
|
|
\begin{equation}
|
|
q=q_0+Ba.
|
|
\end{equation}
|
|
The existing base $q_0$ was never projected. Real spherical harmonics through
|
|
degree $L$ were evaluated at actual radial surface nodes and their
|
|
interpolants orthonormalized in a quadrature-defined physical surface-area
|
|
metric. All azimuthal components in that harmonic span were included.
|
|
|
|
Correct primal and dual normalized maps were essential. For physical state
|
|
scales $S$ and residual scales $R$, separate thin QR decompositions gave
|
|
\begin{equation}
|
|
SB=Q_xT_x,\qquad R^{-1}B=Q_fT_f,
|
|
\end{equation}
|
|
so that
|
|
\begin{equation}
|
|
Q_f^T(RF_{\mathrm{physical}})=T_f^{-T}B^TF_{\mathrm{physical}}.
|
|
\end{equation}
|
|
The reduced operator was $Q_f^T\widehat AQ_x$, not a blind transpose of a
|
|
normalized state basis. Other fields and scalar equations remained active.
|
|
The projected existing inverse was an approximation, not an exact reduced
|
|
inverse. Both retained and original full residuals, and excluded shape force,
|
|
were always exported.
|
|
|
|
\subsection{Frozen late-state result}
|
|
|
|
At the common six-update $Q_3$ endpoint,
|
|
$\lVert F\rVert=1.4971971\,10^{-5}$, cold FGMRES used restart 160, cap 200,
|
|
$\eta=0.03$, and one gravity-Schur sweep with relaxation 0.5.
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{40mm}p{22mm}p{22mm}p{22mm}p{30mm}@{}}
|
|
\hline
|
|
Shape space & Parameters & Iterations & Solve seconds & Unit-trial full norm \\
|
|
\hline
|
|
Full nodal trace & 866 & 61 & 32.184 & Pressure rejection \\
|
|
$L=2$ & 9 & 12 & 6.447 & $2.263903\,10^{-6}$ \\
|
|
$L=4$ & 25 & 21 & 11.249 & $2.432960\,10^{-6}$ \\
|
|
$L=8$ & 81 & 29 & 15.745 & $2.964119\,10^{-6}$ \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
All reduced directions passed their retained linear gates, with relative
|
|
defects 0.01719, 0.01608, and 0.01409. Their original full linear defects
|
|
were 0.15121, 0.16187, and 0.19207: none passed the original full Newton
|
|
gate. Nevertheless, all four sampled trial alphas prepared and decreased
|
|
both norms, and full residual decreases at unit step were 84.88, 83.75,
|
|
and 80.20 percent. This was a real improvement in the original residual,
|
|
obtained by restricting the shape equations, not a more accurate solution
|
|
of the original Newton system.
|
|
|
|
The $L=4$ root had 177,232 unknowns, only 841 fewer than the full root;
|
|
its less than 0.5 percent dimension reduction did not explain a factor 2--5
|
|
drop in cold solve time by itself. Fewer Krylov iterations supplied most
|
|
of the observed gain. Physical displacement norm fell from
|
|
$3.96028\,10^{-3}$ for the full direction to $9.14977\,10^{-5}$ at
|
|
$L=4$, 43.28-fold. The $L=2$ direction was nearly field-only, while admitting
|
|
higher modes increased coupled displacement and curvature.
|
|
|
|
After the $L=4$ unit trial, excluded shape force accounted for 98.38 percent
|
|
of the remaining original squared norm. The inherited fine-scale geometry
|
|
also remained, since $q_0$ had not been projected. Enthalpy-based energy and
|
|
force virials improved to $8.11913\,10^{-7}$ and
|
|
$6.41398\,10^{-7}$, but local EOS/hydrostatic errors were almost unchanged
|
|
and minimum sampled density remained $-7.27628\,10^{-4}$.
|
|
|
|
\subsection{Three cold reduced updates from the analytic seed}
|
|
|
|
A conditional extension, recorded before launching, chained three saved
|
|
unit candidates from the analytic seed. Each stage passed preparation,
|
|
the retained independent linear gate, and both recorded norm-decrease
|
|
screens. This was an externally replayed cold reduced-Newton chain, not a
|
|
production warm-start trajectory or a fully converged model.
|
|
|
|
{\small
|
|
\begin{longtable}{@{}p{14mm}p{30mm}p{30mm}p{30mm}p{30mm}@{}}
|
|
\hline
|
|
Updates & Full norm & Retained norm & Excluded shape norm & Energy virial $P(h)$ \\
|
|
\hline
|
|
0 & $2.736592\,10^{-4}$ & $2.590732\,10^{-4}$ & $8.815010\,10^{-5}$ & $2.410694\,10^{-5}$ \\
|
|
1 & $8.624827\,10^{-5}$ & $9.387845\,10^{-6}$ & $8.573583\,10^{-5}$ & $2.180785\,10^{-6}$ \\
|
|
2 & $8.473526\,10^{-5}$ & $3.147803\,10^{-6}$ & $8.467677\,10^{-5}$ & $8.660498\,10^{-7}$ \\
|
|
3 & $8.465191\,10^{-5}$ & $7.357283\,10^{-8}$ & $8.465188\,10^{-5}$ & $6.769653\,10^{-7}$ \\
|
|
\hline
|
|
\end{longtable}
|
|
}
|
|
|
|
The retained norm fell about 3521-fold but the original norm only 3.23-fold.
|
|
At the final trial, excluded shape force represented 99.999924 percent of
|
|
the original squared norm. Cold solves took 18, 20, and 18 iterations and
|
|
10.574, 11.341, and 9.594 seconds. Full relative linear defects were 31.45,
|
|
98.18, and 99.90 percent; these were not full-system Newton solutions.
|
|
|
|
The final force virial was $5.769064\,10^{-7}$ and mass error
|
|
$3.79142\,10^{-9}$. Yet hydrostatic-gradient RMS rose from 0.001528098
|
|
at seed to 0.007255981, about 4.75-fold, while density remained negative at
|
|
some samples. Nodal radius spread grew to 0.154699 percent, substantially
|
|
less than unrestricted late distortion but not an exact spherical result.
|
|
Small retained residual and excellent virial could therefore coexist with
|
|
significant omitted mechanical force and imperfect interior fields.
|
|
|
|
The result supported decoupling smooth independent surface parameters from
|
|
the ambient displacement carrier, with nested configurable spaces and
|
|
consistent dual restriction. It did not establish that a fixed degree-four
|
|
space was sufficient at all rotation rates, that excluded force was
|
|
irrelevant, or that the complete original mechanical system had converged.
|
|
The subsequent native spherical-harmonic implementation and higher-index
|
|
studies should be read as later developments, not retroactively attributed
|
|
to this bounded experiment.
|
|
|
|
All seven case audits passed 2,098 saved-artifact checks; a separate chain
|
|
audit passed 107 checks with bitwise physical-state and residual handoffs.
|
|
Actual builds, FEM cases, and expensive audits were serialized, and all seven
|
|
FEM probes completed by 20:09:58 UTC. No production order, operator, or lift
|
|
changed in this study. Optional $L=6$, rotating cases, higher indices,
|
|
mesh/enrichment sweeps, and production integration were outside its scope.
|
|
|
|
\paragraph{Evidence.}
|
|
\nolinkurl{experiments/REDUCED_SURFACE_STUDY_2026-09-18.md}, producer commit
|
|
\texttt{21cdbda22486e408adc52b65b25413f9380c7c30}, and the archived
|
|
\nolinkurl{working/research/diagnostics/reduced_surface_2026-09-18} campaigns. Together with the
|
|
failed $Q_4$ experiment, this was the main reason to prefer a controlled
|
|
smooth surface span over indiscriminate addition of nodal surface freedom.
|
|
|
|
\section{Native spherical-harmonic surface prescription}
|
|
\label{sec:recent-harmonics}
|
|
|
|
The reduced-surface experiments motivated making spherical harmonics a native,
|
|
selectable surface prescription. The implementation on
|
|
\nolinkurl{research/spherical-harmonic-surface-20260919} preserved the simultaneous
|
|
Newton solve: surface coefficients, material fields, gravity fields and global
|
|
multipliers remain coordinates of one coupled nonlinear system. This was not a
|
|
separate surface-relaxation iteration. The preferred research candidate became
|
|
maximum degree $L=4$ with all real azimuthal orders, hence 25 independent
|
|
coefficients. The unrestricted nodal radial prescription remained available as
|
|
a control. The choice of $L=4$ was an experimentally useful starting point, not
|
|
a demonstrated resolution requirement for 50\% critical rotation.
|
|
|
|
At reference boundary node $i$, with fixed radial direction $\widehat r_i$, the
|
|
radial displacement is
|
|
\[
|
|
q_i=\sum_{\ell=0}^{L}\sum_{m=-\min(\ell,M)}^{\min(\ell,M)}
|
|
a_{\ell m}Y_{\ell m}(\widehat r_i).
|
|
\]
|
|
Omitting the optional azimuthal cutoff retains $M\ge L$. The real harmonics are
|
|
normalized to unit squared integral over solid angle, include the
|
|
Condon--Shortley phase, and use negative $m$ for sine and positive $m$ for cosine.
|
|
The catalog is ordered by increasing $\ell$ and then signed $m$. Coefficients
|
|
have dimensions of length. Zero coefficients preserve the reference mesh;
|
|
$\ell=0$ is a genuine monopole rather than a removed gauge.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{115mm}p{30mm}@{}}
|
|
Configuration & Independent coefficients \\
|
|
\hline
|
|
\endfirsthead
|
|
Configuration & Independent coefficients \\
|
|
\hline
|
|
\endhead
|
|
$L=4$, all $m$ & 25 \\
|
|
$L=4$, $\lvert m\rvert\le2$ & 19 \\
|
|
$L=4$, $m=0$ & 5 \\
|
|
$L=8$, all $m$ & 81 \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
No odd-degree or nonaxisymmetric modes are silently excluded. Choosing $m=0$
|
|
constrains the shape about the fixed global $z$ axis; it does not impose
|
|
axisymmetry on the three-dimensional interior fields. The reference center is
|
|
configurable, but the frame does not move as another Newton unknown.
|
|
|
|
\subsection{Architecture and normalization}
|
|
|
|
The prescription implements the existing forward, transpose and pullback
|
|
contracts, with a cached reference basis and zero derivative of that fixed
|
|
pullback. It composes with the existing interior and fixed-infinity vacuum
|
|
extensions. The numerical discretization now owns typed surface, interior and
|
|
vacuum prescriptions, instead of the modern equilibrium compiler hardcoding a
|
|
nodal surface. Existing two-argument discretization calls preserve their nodal
|
|
behavior. The physics-facing EOS, pressure boundary, mass and angular-momentum
|
|
specification is unchanged.
|
|
|
|
Prescription/extension compatibility and coupled operator structure remain
|
|
compile-time constrained. Requested degree, sampled rank and actual mesh
|
|
resolution are runtime facts. Sampled aliasing is rejected rather than silently
|
|
reducing the mode set. Modal normalization and the default material/surface
|
|
inverse use a diagonal of the pulled-back reference vector trace mass matrix;
|
|
state and residual factors retain their primal/dual relationship. Metric
|
|
assembly checks FEM identity and a canonical trace-layout capability. The older
|
|
nodal $H^1$ surface surrogate explicitly rejects harmonic coordinates.
|
|
|
|
Geometry remained Q4 and displacement remained Q3. The harmonic samples feed
|
|
the existing finite-element trace, so the resulting surface between nodes is
|
|
not an exact analytic spherical-harmonic graph. Reference-mesh interpolation
|
|
error remains. The native implementation also differs from the earlier frozen
|
|
reduced-space experiment, which retained an arbitrary nodal base shape and used
|
|
area whitening and QR maps. Physical residual and Jacobian equivalence is the
|
|
appropriate comparison; identical normalized Krylov trajectories are not
|
|
expected from those different coordinate metrics.
|
|
|
|
The implementation was single-rank, consistent with the radial volume
|
|
extension. Successful two-rank rejection tests do not establish distributed
|
|
harmonic-solver support.
|
|
|
|
\subsection{Native coupled results}
|
|
|
|
Five live cases used the same mesh, cold Lane--Emden initialization, no central
|
|
constraint, a six-update budget, restart 160, at most 200 linear iterations and
|
|
a true relative linear gate $\eta=0.03$. Nonlinear convergence required
|
|
$\lVert F\rVert/\lVert F_0\rVert\le10^{-8}$, with zero absolute tolerance. All 29 accepted updates
|
|
were full steps, with one trial each and passing linear gates.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{47mm}p{15mm}p{30mm}p{31mm}p{18mm}@{}}
|
|
Case & Updates & Final $\lVert F\rVert$ & $\lVert F\rVert/\lVert F_0\rVert$ & Newton s \\
|
|
\hline
|
|
\endfirsthead
|
|
Case & Updates & Final $\lVert F\rVert$ & $\lVert F\rVert/\lVert F_0\rVert$ & Newton s \\
|
|
\hline
|
|
\endhead
|
|
$n=1,J=0$, all $m$ & 5 & $1.52715\,10^{-12}$ & $9.64952\,10^{-9}$ & 146.00 \\
|
|
$n=1.5,J=0$, all $m$ & 6 & $1.29965\,10^{-12}$ & $5.01751\,10^{-9}$ & 221.40 \\
|
|
$n=1,J=.01$, all $m$ & 6 & $3.86299\,10^{-13}$ & $4.29274\,10^{-10}$ & 197.23 \\
|
|
$n=1,J=.01$, $m=0$ & 6 & $3.08442\,10^{-13}$ & $3.42757\,10^{-10}$ & 164.90 \\
|
|
$n=1.5,J=0$, gravity-Schur & 6 & $2.19823\,10^{-11}$ & $8.48662\,10^{-8}$ & 189.54 \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
The first four cases converged by their stated criterion. The gravity-Schur
|
|
case exhausted its budget, although its last update still reduced the residual
|
|
by approximately a factor of 40; calling that endpoint a plateau would be
|
|
incorrect. Process wall times, including setup and observations, were 210.55,
|
|
290.70, 265.89, 232.54 and 257.49 seconds, respectively. Timings are single-run
|
|
observations on the workstation, not replicated benchmark statistics.
|
|
|
|
At q18, absolute energy/force virial errors formed with $P(h)$ were
|
|
$3.87036\,10^{-7}$ / $2.65938\,10^{-7}$ for the nonrotating $n=1$ case,
|
|
$6.55153\,10^{-7}$ / $6.00565\,10^{-7}$ for $n=1.5$, and approximately
|
|
$3.87\,10^{-7}$ / $2.66\,10^{-7}$ for both low-rotation $n=1$ cases. They also passed
|
|
$10^{-5}$ at q14. The corresponding density-pressure virials passed for the
|
|
sampled $n=1$ cases, but were undefined for $n=1.5$, whose independent density
|
|
was negative at some integration points. The later sign-region investigation
|
|
also detected a thin $n=1$ negative layer missed by ordinary volume quadrature.
|
|
|
|
Global balance did not establish pointwise accuracy. For nonrotating $n=1.5$,
|
|
the normalized EOS-density RMS was $1.25551\,10^{-4}$ and the hydrostatic-gradient
|
|
RMS increased from $1.52810\,10^{-3}$ in the seed to $7.27475\,10^{-3}$ at the
|
|
root, a factor of 4.76. This gradient diagnostic has acceleration units in the
|
|
model normalization; it is not the normalized weak residual. The four converged
|
|
cases had mass errors below $5.3\,10^{-14}$ and angular-momentum errors below
|
|
$3.6\,10^{-16}$.
|
|
|
|
The full nodal mechanical force remained almost entirely outside the harmonic
|
|
span: Euclidean nodal-dual norms were approximately $9.22\,10^{-6}$ for
|
|
$n=1,J=0$ and $8.99\,10^{-6}$ for $n=1.5,J=0$. In the latter case the retained
|
|
modal force norm was only $3.61\,10^{-14}$. This is convergence of the selected
|
|
Galerkin shape problem, not convergence of the former unrestricted nodal shape
|
|
problem. The excluded dimensional Euclidean norm cannot be directly compared
|
|
with a normalized nonlinear norm or the dimensionless virial tolerance.
|
|
|
|
Nonaxisymmetric coefficients persisted in nominally spherical models. The
|
|
$(\ell,m)=(4,4)$ coefficients were $8.97263\,10^{-5}$ for $n=1$ and
|
|
$9.23867\,10^{-4}$ for $n=1.5$, compared with $a_{40}=1.09313\,10^{-3}$ in the
|
|
latter. These are evidence to examine mesh/discretization imprint, not evidence
|
|
of a physical nonaxisymmetric branch.
|
|
|
|
Total Krylov counts were 212, 335, 296, 219 and 206 in the table's order. The
|
|
$m=0$ rotating control used 26.0\% fewer Krylov iterations and 16.4\% less Newton
|
|
time than the all-$m$ control, but changes the admissible shape and is not a pure
|
|
preconditioner speedup. All $m$ remained the preferred three-dimensional
|
|
candidate. Ten new harmonic tests and 64 selected existing regression cases
|
|
passed; independent audits checked saved basis pullbacks, excluded force and
|
|
physical/nodal equivalence. Those implementation checks do not validate the
|
|
higher-rotation target.
|
|
|
|
\section{Negative density: a located discrete representation defect}
|
|
\label{sec:recent-negative}
|
|
|
|
The subsequent investigation was observational: it changed no equilibrium
|
|
equation, field order, shape prescription, normalization, preconditioner or
|
|
Newton policy, and solved no new equilibrium. It examined four frozen states:
|
|
converged $n=1$ and $n=1.5$ nonrotating harmonic models, the original $n=1.5$
|
|
seed, and the $n=3$ nonrotating seed. Only the $n=3$ case had a central condition;
|
|
it was not a converged $n=3$ model.
|
|
|
|
\subsection{What the weak EOS equation determines}
|
|
|
|
Density and enthalpy are independent unknowns. Baseline density is DGQ2 and
|
|
enthalpy is continuous Q3. On a stellar element the closure is
|
|
\[
|
|
R_i=\sum_q w_q\varphi_i(q)\left[\rho_h(q)-\rho_*(h_h(q))\right],
|
|
\qquad \rho_*(h)=\left[\frac{h}{(n+1)K}\right]^n,
|
|
\]
|
|
with physical mapped weights. At zero closure residual,
|
|
\[
|
|
M\boldsymbol\rho=\boldsymbol b(h),\quad
|
|
M_{ij}=\sum_qw_q\varphi_i\varphi_j,\quad
|
|
b_i=\sum_qw_q\varphi_i\rho_*(h_h).
|
|
\]
|
|
Thus the closure selects a quadrature-defined weighted $L^2$ projection, not
|
|
pointwise EOS equality. Its unique polynomial can have negative regions even
|
|
when the sampled EOS target is nonnegative.
|
|
|
|
Independently assembled element mass matrices and Cholesky solutions reproduced
|
|
the converged $n=1.5$ density coefficients within $1.40\,10^{-14}$ and the field
|
|
within $2.25\,10^{-15}$ in physical $L^2$, while its negative density was of order
|
|
$10^{-4}$. Independent/production closure-residual differences were approximately
|
|
$1.2\,10^{-17}$ to $2.1\,10^{-17}$ across the four states. Raising projection
|
|
quadrature to q26 changed coefficients by at most $2.36\,10^{-7}$ and did not
|
|
remove the undershoot. These comparisons identify the defect at the measured
|
|
discrete root; it is not explained by incomplete closure convergence or the
|
|
small measured quadrature difference.
|
|
|
|
The implemented dependency also corrects an earlier intuitive explanation:
|
|
negative density does not directly generate the represented enthalpy. Pressure
|
|
is evaluated from independently represented enthalpy; negative sampled enthalpy
|
|
is rejected during preparation. All negative-density q18/q26 volume samples in
|
|
this investigation had positive enthalpy. Some surface witnesses had exactly
|
|
zero enthalpy. Density influences enthalpy indirectly through the coupled
|
|
stellar equations.
|
|
|
|
\subsection{Spatial location and root-based integration}
|
|
|
|
All 96 surface-adjacent stellar cells contained measured negative regions; no
|
|
negative intervals were found on the sampled lines through the other 736
|
|
stellar cells. All stored density nodal values nevertheless remained positive.
|
|
The nodes are interior Gauss--Legendre points, and positivity of their values
|
|
does not imply positivity between them.
|
|
|
|
Ordinary quadrature can miss thin sign regions: q18 and q26 missed the $n=1$
|
|
volume layer, while its sampled boundary trace was negative. For the same
|
|
unchanged $n=1.5$ field, negative-mass estimates changed from
|
|
$2.89\,10^{-5}$ at q18 to $2.18\,10^{-5}$ at q26 and the apparent negative volume
|
|
nearly halved. The investigation therefore isolated zero crossings of the
|
|
polynomial along reference-cell lines and integrated negative intervals.
|
|
Define $M=\int\rho_h\,dV$ and $M_-=-\int\min(\rho_h,0)\,dV$. The mass denominator
|
|
below is $\lvert M\rvert$, not $\int\lvert \rho_h\rvert\,dV$.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{41mm}p{32mm}p{30mm}p{42mm}@{}}
|
|
Frozen state & $M_-/\lvert M\rvert$ & $V_-/V$ & Measured physical radius range \\
|
|
\hline
|
|
\endfirsthead
|
|
Frozen state & $M_-/\lvert M\rvert$ & $V_-/V$ & Measured physical radius range \\
|
|
\hline
|
|
\endhead
|
|
$n=1$ equilibrium & $6.09585\,10^{-8}$ & $0.0327346\%$ & $.999643$--$.999886$ \\
|
|
$n=1.5$ seed & $3.66771\,10^{-5}$ & $1.83795\%$ & $.993813$--$1.000019$ \\
|
|
$n=1.5$ equilibrium & $2.24535\,10^{-5}$ & $1.49252\%$ & $.994917$--$1.001222$ \\
|
|
$n=3$ seed & $2.88372\,10^{-5}$ & $12.0835\%$ & $.934409$--$.978469$ \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
Radii are in reference-radius units and are not distances from the local,
|
|
slightly deformed surface. The first three cases have intervals reaching the
|
|
surface; the $n=3$ seed has an interior pocket in the same outer cell layer. Its
|
|
surface trace is positive. Minimum-density witnesses were approximately
|
|
$-1.14756\,10^{-4}$, $-9.26332\,10^{-4}$, $-7.21171\,10^{-4}$ and
|
|
$-8.54870\,10^{-5}$, respectively; the $n=3$ witness had enthalpy $0.0455581$.
|
|
These are sampled witnesses, not certified global minima.
|
|
|
|
Tangential rules with 8, 12 and 16 points per direction agreed on the negative
|
|
integrals to roundoff in these cases. The finest two negative masses differed
|
|
by at most $10^{-14}$ relative, and whole mass/volume agreed with separate
|
|
observations within $1.77\,10^{-13}$ relative. Eight points integrated each
|
|
root-partitioned interval. Analytic controls, decimal-arithmetic audits and
|
|
state/coefficient hash checks support the measurements. They are not rigorous
|
|
three-dimensional sign certificates: unsampled angular pockets or roots below
|
|
reconstruction uncertainty remain possible.
|
|
|
|
\subsection{Mechanism controls and their limits}
|
|
|
|
The initial seed independently interpolates tabulated Lane--Emden density and
|
|
enthalpy into their respective spaces. The converged closure instead projects
|
|
the EOS image of represented enthalpy. Both operations can undershoot; neither
|
|
Newton nor rotation is necessary. With inward surface-cell coordinate
|
|
$t\in[0,1]$, a linear enthalpy gives target density proportional to $t^n$.
|
|
Exact quadratic $L^2$ projections in a flat one-dimensional cell are
|
|
\[
|
|
\Pi_2t^{3/2}=-\frac{2}{105}+\frac{16}{35}t+\frac47t^2,
|
|
\qquad
|
|
\Pi_2t^3=\frac1{20}-\frac35t+\frac32t^2.
|
|
\]
|
|
The fractional profile is negative for $0\le t<0.0396969$. The cubic profile
|
|
has a negative pocket $0.118350<t<0.281650$, with minimum $-0.01$ at $t=.2$.
|
|
Both preserve the exact cell mean and admit positive nodal samples. The cubic
|
|
example demonstrates that a nonpolynomial target or fractional EOS is not
|
|
necessary: insufficient degree alone can produce the pocket.
|
|
|
|
For $n=1$ the leading linear surface model is exact in Q2, but the actual EOS
|
|
image of Q3 enthalpy need not lie in Q2. Geometry weights do not destroy exact
|
|
projection of a target already in the trial space. The measured $n=1$ layer
|
|
therefore cannot be attributed to curved weights alone. In the toy fixed-slope
|
|
model, halving cell width reduces undershoot amplitude by $2^{-n}$ and negative
|
|
mass per unit area by $2^{-(n+1)}$, without removing the fraction of that cell
|
|
that is negative. These formulas explain a possible mechanism and scaling;
|
|
they are not measured three-dimensional refinement rates.
|
|
|
|
The conclusions are specific. Tighter solves or better preconditioning cannot
|
|
remove negativity while converging to this same discrete root. Exact algebraic
|
|
elimination $\rho=M^{-1}b(h)$ reproduces the same polynomial; it does not turn
|
|
weak closure into pointwise EOS density. A basis change alone also preserves
|
|
the polynomial. Conversely, this investigation did not prove that all nonlinear
|
|
plateaus, the hydrostatic-gradient discrepancy or external-domain errors share
|
|
this cause.
|
|
|
|
An early diagnosis report proposed pointwise EOS-derived density as a possible
|
|
barotropic remedy. The user explicitly rejected making density a derived field
|
|
because the eventual code targets a general EOS, and subsequently deferred
|
|
positivity intervention. That recommendation is historical and superseded. The
|
|
current direction retains independent density and reports the defect without
|
|
clipping or post-solve repair.
|
|
|
|
\section{Independent density-order study and logarithmic assessment}
|
|
\label{sec:recent-density-order}
|
|
|
|
The next controlled experiment varied density alone: DGQ2, DGQ3 and DGQ4 in the
|
|
same Gauss--Legendre family. Enthalpy/displacement stayed Q3, gravity RT2/Q2,
|
|
geometry Q4, and the surface all-$m$ $L=4$. There were 832 stellar elements, so
|
|
the density block had 22,464, 53,248 or 104,000 coefficients. The default remained
|
|
Q2. A compile-time registry option propagated order through typed field spaces,
|
|
quadrature, adapters, normalization and block layouts; no extra physics-facing
|
|
parameter was needed.
|
|
|
|
The closure rule must cover both its density mass form and EOS source form.
|
|
The selected rule is the greater resolved request, preserving policy overrides.
|
|
For these cases Q2/Q3 used identical achieved orders: 17, 19 and 23 for
|
|
$n=1,1.5,3$, with 729, 1000 and 1728 points per cell. Q4 used 19, 21 and 25,
|
|
with 1000, 1331 and 2197 points. Thus the coupled Q4 comparison includes
|
|
policy-selected quadrature enrichment; only the frozen common-rule comparison
|
|
strictly isolates approximation order.
|
|
|
|
\subsection{Frozen approximation results}
|
|
|
|
Saved enthalpy and geometry were fixed for the $n=1$ and $n=1.5$ equilibria and
|
|
$n=3$ seed. Each density space received an independent physical-volume-weighted
|
|
projection using common q26 quadrature. EOS error was checked with a separate
|
|
q30 rule; no projection was installed in a solver state. Negative measures use
|
|
the finest root-sliced tangential rule. The EOS $L^2$ error has model density
|
|
and volume units, without further relative normalization.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{33mm}p{18mm}p{33mm}p{29mm}p{32mm}@{}}
|
|
Frozen target & Density & $M_-/\lvert M\rvert$ & $V_-/V$ & EOS $L^2$ error \\
|
|
\hline
|
|
\endfirsthead
|
|
Frozen target & Density & $M_-/\lvert M\rvert$ & $V_-/V$ & EOS $L^2$ error \\
|
|
\hline
|
|
\endhead
|
|
$n=1$ root & Q2 & $6.09585\,10^{-8}$ & $3.27346\,10^{-4}$ & $1.25266\,10^{-4}$ \\
|
|
& Q3 & $1.05\,10^{-31}$ & $2.49\,10^{-16}$ & $1.56\,10^{-15}$ \\
|
|
& Q4 & $1.25\,10^{-31}$ & $2.73\,10^{-16}$ & $1.60\,10^{-15}$ \\
|
|
$n=1.5$ root & Q2 & $2.24299\,10^{-5}$ & $.0149181$ & $3.67965\,10^{-4}$ \\
|
|
& Q3 & $9.33602\,10^{-6}$ & $.0104476$ & $1.12325\,10^{-4}$ \\
|
|
& Q4 & $3.18362\,10^{-6}$ & $.00683440$ & $4.80663\,10^{-5}$ \\
|
|
$n=3$ seed & Q2 & $2.92063\,10^{-5}$ & $.121064$ & $1.06409\,10^{-2}$ \\
|
|
& Q3 & $2.63486\,10^{-6}$ & $.0373200$ & $6.86223\,10^{-4}$ \\
|
|
& Q4 & $1.02066\,10^{-8}$ & $.0169628$ & $3.84980\,10^{-5}$ \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
The $n=1$ Q3/Q4 sign measures are unresolved roundoff, not measured physical
|
|
negative regions. Q3 contains the linear EOS image of Q3 enthalpy, explaining
|
|
its roundoff-level mismatch. For $n=3$, the generic target is Q9, and for
|
|
$n=1.5$ it is nonpolynomial. Q4 reduces the $n=3$ projected negative mass by
|
|
approximately 2862 times relative to Q2 but leaves measured negativity in about
|
|
1.70\% of the volume. Enrichment is useful approximation evidence, not a
|
|
positivity guarantee.
|
|
|
|
For $n=1.5$ Q4, q26/q30 EOS norms differ by about 0.18\%; the fixed-eight-point
|
|
root-sliced norm differs from the unsliced q30 norm by about 2.2\%. Stable
|
|
negative masses under tangential refinement do not establish normal-direction
|
|
integration accuracy for the fractional EOS error. This distinction motivated
|
|
reporting the unsliced q30 norm.
|
|
|
|
\subsection{Coupled controls and the stalled $n=3$ trajectories}
|
|
|
|
Twelve live cases retained the same default inverse, normalization, cold
|
|
initialization, restart 160, 200-iteration linear cap, $\eta=.03$, eight-update
|
|
budget and relative nonlinear tolerance $10^{-8}$. Only the $n=3$ cases used a
|
|
central condition. All nine $n=1$ and $n=1.5$ cases converged with full steps and
|
|
no rejected trials. All their $P(h)$ energy/force virials were below
|
|
$6.6\,10^{-7}$.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{45mm}p{20mm}p{22mm}p{27mm}p{25mm}@{}}
|
|
Case & Density & Updates & Krylov iterations & Newton s \\
|
|
\hline
|
|
\endfirsthead
|
|
Case & Density & Updates & Krylov iterations & Newton s \\
|
|
\hline
|
|
\endhead
|
|
$n=1,J=0$ & Q2 & 5 & 212 & 147.5 \\
|
|
& Q3 & 6 & 286 & 204.3 \\
|
|
& Q4 & 6 & 286 & 215.1 \\
|
|
$n=1,J=.01$ & Q2 & 6 & 296 & 196.1 \\
|
|
& Q3 & 6 & 305 & 217.8 \\
|
|
& Q4 & 6 & 304 & 229.1 \\
|
|
$n=1.5,J=0$ & Q2 & 6 & 335 & 222.0 \\
|
|
& Q3 & 6 & 329 & 241.7 \\
|
|
& Q4 & 7 & 397 & 303.7 \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
For $n=1$, Q3/Q4 removed resolved undershoot and reduced EOS mismatch to
|
|
roundoff. Nonrotating total costs were 39\%/46\% above Q2, but the enriched runs
|
|
needed one extra update because their fifth residuals narrowly missed their
|
|
own thresholds. The equal-six-update rotating case cost approximately
|
|
11\%/17\% more. Total costs therefore cannot be read as per-action order overhead.
|
|
|
|
For $n=1.5$, Q3 reduced negative mass and EOS error by factors 2.40 and 3.28 for
|
|
8.9\% more Newton time; Q4 reduced them by 7.01 and 7.66 for 36.8\% more time.
|
|
Negative volume fractions remained 1.493\%, 1.046\% and 0.685\%. The
|
|
hydrostatic-gradient RMS values were $.00727475$, $.00731970$ and $.00729901$;
|
|
density enrichment did not appreciably improve that local balance measure.
|
|
|
|
No $n=3$ case converged within eight updates:
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{16mm}p{25mm}p{19mm}p{22mm}p{28mm}p{28mm}@{}}
|
|
Density & $\lVert F\rVert/\lVert F_0\rVert$ & Min. $\alpha$ & Newton s & $\lvert v_E^h\rvert$ & $\lvert v_F^h\rvert$ \\
|
|
\hline
|
|
\endfirsthead
|
|
Density & $\lVert F\rVert/\lVert F_0\rVert$ & Min. $\alpha$ & Newton s & $\lvert v_E^h\rvert$ & $\lvert v_F^h\rvert$ \\
|
|
\hline
|
|
\endhead
|
|
Q2 & $.430062$ & $1/64$ & 301.6 & $1.77163\,10^{-4}$ & $1.34597\,10^{-4}$ \\
|
|
Q3 & $.985301$ & $1/256$ & 478.8 & $8.07504\,10^{-6}$ & $2.28169\,10^{-5}$ \\
|
|
Q4 & $.987949$ & $1/512$ & 508.2 & $1.37586\,10^{-5}$ & $2.84372\,10^{-5}$ \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
Krylov totals were 221, 452 and 458. All reported true linear gates passed.
|
|
Q2 had four pressure and four insufficient-decrease rejections; Q3/Q4 each had
|
|
five pressure and nine insufficient-decrease rejections. Density order does
|
|
not enter the pressure-force sampling rule, whose operands remain enthalpy and
|
|
displacement gradient. These differences reflect reached states/directions,
|
|
not changed pressure sampling. Q3's passing energy virial alone does not make
|
|
it successful: its force virial and nonlinear criterion fail.
|
|
|
|
Unbordered residuals were $1.33327\,10^{-3}$, $7.18640\,10^{-4}$ and
|
|
$7.26009\,10^{-4}$; normalized central forcing was $3.17039\,10^{-5}$,
|
|
$1.27669\,10^{-5}$ and $1.20966\,10^{-5}$. The unbordered diagnostic removes artificial central forcing but retains scalar
|
|
constraint rows. Neither a physical root nor vanishing artificial force was demonstrated. The existing central condition pins central
|
|
enthalpy to the EOS value at requested central density, not the independent DG
|
|
density point value.
|
|
|
|
The production seed is $I_p(\rho_{\rm LE,tabulated})$, whereas the frozen
|
|
controls are $I_p(\rho_*(h_h))$ and $\Pi_p(\rho_*(h_h))$. Nonlinear EOS evaluation
|
|
does not commute with tabulation or interpolation. For example, the production
|
|
Q4 $n=3$ seed had approximately $5.26\,10^{-4}$ EOS error at q18, versus
|
|
$3.85\,10^{-5}$ for the frozen Q4 projection at q30. These are different fields
|
|
and quadratures, not a controlled improvement ratio. A closure-consistent
|
|
initial guess remains a distinct hypothesis compatible with independent density.
|
|
|
|
Each order passed 48 focused contract tests (9766, 9822 and 9894 assertions),
|
|
and the frozen/coupled artifact audits passed. Across-order residual norms
|
|
belong to different discrete spaces and Riesz weights, so lower normalized
|
|
residual does not rank physical accuracy. The endpoints are finite-budget
|
|
outcomes, not proved floors or nonexistence results.
|
|
|
|
\subsection{What the logarithmic assessment established}
|
|
|
|
The separate log-density branch contained derivations and one-dimensional
|
|
controls only. No stellar log-density solve, production representation change,
|
|
speedup or virial improvement was established. Three constructions must remain
|
|
distinct:
|
|
\begin{enumerate}
|
|
\item Exponentiating density nodal coefficients gives
|
|
$\rho_h=\sum_j\rho_s e^{u_j}\varphi_j$. It changes coordinates on positive
|
|
coefficient vectors but can retain the same between-node negative polynomial.
|
|
\item A pointwise exponential $\rho=\rho_s e^{u_h(\xi)}$ is positive in exact
|
|
arithmetic for finite $u_h$, with $\delta\rho=\rho\,\delta u_h$. It changes the
|
|
approximation family and every density-dependent physical evaluation.
|
|
\item A factored representation $\rho=\rho_{\rm ref}(\xi,q)e^{u_h}$ can preserve
|
|
an exact vacuum trace if the reference is positive inside and vanishes at the
|
|
surface. Its variation includes $e^{u_h}\delta\rho_{\rm ref}$, in addition to
|
|
$\rho\delta u_h$.
|
|
\end{enumerate}
|
|
|
|
Raw logarithmic density for $\rho\sim A s^n$ behaves as
|
|
$\log(A/\rho_s)+n\log s$ and is singular at an exact vacuum boundary. Interior
|
|
nodes avoid evaluating $\log0$ but do not give a finite polynomial log field
|
|
the correct zero trace. A reference $\rho_{\rm ref}\sim B s^m$ makes the log
|
|
amplitude bounded only when $m=n$. Such an exponent is a polytropic boundary
|
|
assumption, not a general-EOS prescription; taking the reference from live
|
|
enthalpy would introduce an additional dependency that is not required by
|
|
independent density.
|
|
|
|
A Q2 pointwise exponential fitted to three exact moments of $t^n$ gave:
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{16mm}p{43mm}p{43mm}p{39mm}@{}}
|
|
$n$ & Fitted surface density & Relative $L^2$ error & Tiny Newton updates \\
|
|
\hline
|
|
\endfirsthead
|
|
$n$ & Fitted surface density & Relative $L^2$ error & Tiny Newton updates \\
|
|
\hline
|
|
\endhead
|
|
1 & $.0673707$ & $.0578060$ & 3 \\
|
|
1.5 & $.0229264$ & $.0517531$ & 4 \\
|
|
3 & $.00141091$ & $.0333959$ & 5 \\
|
|
\end{longtable}
|
|
\endgroup
|
|
Verified moment defects were at most $2.38\,10^{-14}$. Thus positivity, mass
|
|
conservation and weak closure can coexist with an incorrect positive vacuum
|
|
trace. Exact Q2 polynomial projection errors for the same profiles were 0,
|
|
$.00952381$ and $.05$, so the exponential family was not uniformly more accurate
|
|
at the same degree. A matched factor $t^n e^0$ reproduces the toy target by
|
|
construction, not by demonstrating a general reference-selection method.
|
|
|
|
With equal test/log bases the local closure derivative is the weighted mass
|
|
matrix $\int\varphi_i\rho\varphi_j\,dV$. For
|
|
$\rho=A\Delta^n t^n$ it scales as $A\Delta^{n+1}H_n$, against $\Delta I$ for an
|
|
orthonormal polynomial density mass matrix. Cell-matrix condition numbers in
|
|
the Q2 one-dimensional exact-profile controls were approximately 7.873, 16.852
|
|
and 94.561. These are not stellar Jacobian condition numbers. Small density
|
|
reduces the response scale and can increase disparities across cells/blocks;
|
|
logarithms do not automatically improve conditioning or enthalpy admissibility.
|
|
|
|
A future implementation would require a typed physical-density evaluator and
|
|
exact directional action, consistent support in every operator, normalization,
|
|
quadrature and cache. Zero inactive exterior coefficients must not be
|
|
exponentiated into positive exterior density. Underflow/overflow needs an
|
|
explicit policy rather than silent clipping. MESA's zonewise use of
|
|
$\exp(\log\rho)$ supports investigating independent density coordinates, but
|
|
its atmosphere boundary and zone representation do not establish correctness
|
|
for this high-order exact-vacuum FEM problem. Following user direction,
|
|
positivity work was deferred in favor of coupled convergence.
|
|
|
|
\section{Detailed coupled-convergence campaign}
|
|
\label{sec:recent-coupled}
|
|
|
|
The final campaign retained Q2 independent density, Q3 enthalpy/displacement,
|
|
RT2/Q2 gravity, Q4 geometry, the same mesh/normalization and all-$m$ $L=4$
|
|
surface. No clipping, logarithmic field, derived density or positivity gate was
|
|
introduced. Three kinds of evidence were deliberately separated: evolving
|
|
nonlinear trajectories, same-state linear inverse comparisons, and unchanged
|
|
saved-state visualization. Cost comparisons include the stated setup and
|
|
verification work; a passed artifact audit is not equivalent to convergence.
|
|
|
|
\subsection{Initial nonlinear screen}
|
|
|
|
Five cases used 12 updates, restart 160 and a 300-iteration linear cap. Only
|
|
$n=3$ included the existing central phase condition. The two $n=3$ cases differed
|
|
in forcing tolerance. Every case exhausted its update budget.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{36mm}p{27mm}p{17mm}p{19mm}p{48mm}@{}}
|
|
Case & Final $\lVert F\rVert$ & Newton s & Krylov total & $\lvert v_E^h\rvert/\lvert v_F^h\rvert$ \\
|
|
\hline
|
|
\endfirsthead
|
|
Case & Final $\lVert F\rVert$ & Newton s & Krylov total & $\lvert v_E^h\rvert/\lvert v_F^h\rvert$ \\
|
|
\hline
|
|
\endhead
|
|
$n=2,J=0,\eta=.03$ & $8.85263\,10^{-6}$ & 742.74 & 1009 & $3.25447\,10^{-7}$ / $2.24560\,10^{-6}$ \\
|
|
$n=3,J=0,\eta=.03$ & $8.24392\,10^{-4}$ & 499.89 & 429 & $9.46671\,10^{-5}$ / $6.20929\,10^{-5}$ \\
|
|
$n=3,J=0,\eta=.003$ & $5.50731\,10^{-4}$ & 734.09 & 821 & $2.23846\,10^{-4}$ / $1.98912\,10^{-4}$ \\
|
|
$n=1,J=.1,\eta=.03$ & $5.83293\,10^{-3}$ & 310.43 & 226 & $3.23282\,10^{-4}$ / $3.36216\,10^{-4}$ \\
|
|
$n=1.5,J=.1,\eta=.03$ & $7.22567\,10^{-5}$ & 550.70 & 717 & $5.10711\,10^{-5}$ / $5.20697\,10^{-5}$ \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
The actual nonlinear thresholds were $3.81795\,10^{-12}$ for $n=2$,
|
|
$3.09931\,10^{-11}$ for $n=3$, $8.57344\,10^{-10}$ for rotating $n=1$ and
|
|
$1.39488\,10^{-9}$ for rotating $n=1.5$. q14/q18 enthalpy virial differences in
|
|
all nonrotating cases were below $8\,10^{-14}$ absolute; this is a quadrature
|
|
check, not mesh convergence or proof of equilibrium.
|
|
|
|
After $n=2$'s second update, ten more updates reduced its residual by only
|
|
2.112\%. Its final step was $1/256$ and all rejections were insufficient
|
|
decrease. Poisson and gravity-gradient blocks contributed 94.770\% and 4.076\%
|
|
of the final squared normalized norm. Minimum q18 density was positive,
|
|
$2.93907\,10^{-4}$, and density-pressure energy/force virials also passed:
|
|
$2.49026\,10^{-6}$ / $5.70105\,10^{-7}$. This supplies a stalled control without an
|
|
observed negative-density obstruction, although it is not a global positivity
|
|
certificate.
|
|
|
|
Tenfold tighter $n=3$ linear tolerance reduced its equal-update endpoint
|
|
residual by 33.20\%, but required 46.85\% more Newton time and 91.38\% more
|
|
Krylov iterations, and worsened both virials. The final step decreased from
|
|
$1/4$ to $1/32$. The ordinary run's squared residual was 79.927\% Poisson,
|
|
13.854\% gravity gradient and 6.144\% closure; the tight run was 71.329\%
|
|
closure and 25.876\% Poisson. These are different nonlinear trajectories, not
|
|
same-state inverse comparisons. Both progressed beyond the earlier eight-step
|
|
endpoints, showing why those endpoints must not be called demonstrated floors.
|
|
|
|
The rotating $n=1$ case ended at $\alpha=1/65536$, with 26 pressure rejections
|
|
and no metric rejection. Rotating $n=1.5$ had seven of each and ended at
|
|
$1/64$; four updates after its eighth reduced the residual only 4.97\%. Both
|
|
had negative sampled density, making density-pressure virials undefined.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{45mm}p{33mm}p{33mm}p{34mm}@{}}
|
|
Case & Scaled EOS RMS & Scaled Bernoulli RMS & Hydrostatic-gradient RMS \\
|
|
\hline
|
|
\endfirsthead
|
|
Case & Scaled EOS RMS & Scaled Bernoulli RMS & Hydrostatic-gradient RMS \\
|
|
\hline
|
|
\endhead
|
|
$n=2,J=0$ & $1.87717\,10^{-4}$ & $2.80766\,10^{-4}$ & $.0264341$ \\
|
|
$n=3,\eta=.03$ & $3.52140\,10^{-4}$ & $.00230017$ & $.398054$ \\
|
|
$n=3,\eta=.003$ & $3.69501\,10^{-4}$ & $.00265289$ & $.479759$ \\
|
|
$n=1,J=.1$ & $.00126849$ & $.00221774$ & $.104394$ \\
|
|
$n=1.5,J=.1$ & $1.69365\,10^{-4}$ & $6.32866\,10^{-4}$ & $.0366157$ \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
Scaled EOS and Bernoulli RMS use sampled density and enthalpy scales;
|
|
hydrostatic-gradient RMS is unscaled in model acceleration units. These local
|
|
observations remain distinct from weak residuals and virials. A source-derived
|
|
row map placed 84.437\% of saved Poisson norm squared inside the star for the
|
|
$n=2$ update-seven capture, 99.9768\%/99.9995\% for ordinary/tight $n=3$, and over
|
|
99\% for both rotating captures. The exterior rows alone therefore do not
|
|
account for the stalled norm. Row shares are not pointwise PDE errors or proof
|
|
that the exterior has no indirect influence on interior fields.
|
|
|
|
\subsection{Matched gravity-curvature trial-path control}
|
|
|
|
Raw and gravity-curvature Newton restarted from the identical $n=2$ update-three
|
|
capture, with initial $\lVert F\rVert=9.0134584624\,10^{-6}$, six updates, $\eta=.03$ and
|
|
common absolute target $10^{-12}$. Every reported full linear gate passed.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{49mm}p{43mm}p{27mm}p{25mm}@{}}
|
|
Trial path & Final $\lVert F\rVert$ & Newton s & Final $\alpha$ \\
|
|
\hline
|
|
\endfirsthead
|
|
Trial path & Final $\lVert F\rVert$ & Newton s & Final $\alpha$ \\
|
|
\hline
|
|
\endhead
|
|
Raw Newton & $8.8762959137\,10^{-6}$ & 449.196 & $1/256$ \\
|
|
Gravity curvature & $8.6749533568\,10^{-6}$ & 887.543 & $1/2048$ \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
The corrected endpoint was only 2.2683\% lower at 1.97585 times cost. Its first
|
|
step accepted $1/16$, against raw $1/128$, but supplied 90.1683\% of its eventual
|
|
six-step gain; no durable recovery followed. Preparation time rose 3.72673-fold,
|
|
with 22 auxiliary gravity solves and 866 auxiliary iterations. Their verified
|
|
prepared defects passed, so the full stall was not a failed auxiliary solve.
|
|
All rejections were residual-metric failures, not pressure failures. Both
|
|
endpoints met the enthalpy virial target, but neither met the nonlinear target.
|
|
This pair did not justify a default trial-path change.
|
|
|
|
\subsection{Frozen inverse comparisons: rate, attained accuracy and total cost}
|
|
|
|
Each case below compares a freshly constructed baseline and candidate on the
|
|
identical saved physical state, Jacobian and right-hand side. The fresh full
|
|
endpoint defect is $\lVert Ap+F\rVert/\lVert F\rVert$. Ordinary tolerance is $.003$; the marked tight
|
|
case requests $10^{-7}$. Every case had a 300-iteration cap.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{30mm}p{34mm}p{24mm}p{34mm}p{25mm}@{}}
|
|
State & Candidate & Iterations B/C & Total seconds B/C & Gate B/C \\
|
|
\hline
|
|
\endfirsthead
|
|
State & Candidate & Iterations B/C & Total seconds B/C & Gate B/C \\
|
|
\hline
|
|
\endhead
|
|
$n=2$ late & gravity & 105/83 & 51.1251/50.2194 & pass/pass \\
|
|
$n=2$ late & surface/scalars & 105/300 & 51.6185/244.6878 & pass/fail \\
|
|
$n=2$ late & combined & 105/109 & 51.4773/117.3489 & pass/pass \\
|
|
$n=2$ tight & combined & 300/300 & 145.5541/283.3130 & fail/fail \\
|
|
$n=3$ late & combined & 99/41 & 53.1688/65.6294 & pass/pass \\
|
|
$n=1,J=.1$ late & combined & 63/28 & 29.9344/44.3827 & pass/pass \\
|
|
$n=1.5,J=.1$ late & combined & 246/95 & 117.9250/101.7603 & pass/pass \\
|
|
$n=2$ late & LDU+gravity & 105/78 & 51.4910/60.0450 & pass/pass \\
|
|
$n=3$ late & LDU+gravity & 99/41 & 53.1904/35.2005 & pass/pass \\
|
|
$n=3$ late & gravity & 99/46 & 53.3147/31.1652 & pass/pass \\
|
|
$n=1.5,J=.1$ late & gravity & 246/137 & 118.6171/82.3113 & pass/pass \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
``Gravity'' uses the gravity-Schur refinement with independent subsystem
|
|
structure. ``Surface/scalars'' wraps the independent base in the new approximate
|
|
coarse Schur inverse. ``Combined'' wraps the gravity-refined base. LDU adds
|
|
existing two-way material/gravity feedback. The total cost includes inverse
|
|
construction, normalization binding, Krylov setup/solve and one fresh full Jacobian
|
|
check. It excludes initial model/context setup, separate diagnostic action
|
|
checks, trial-grid observations and output. Internal Schur Jacobian work is
|
|
already included in application time; it must not be counted twice.
|
|
|
|
The strongest frozen improvements were gravity-only: 41.54\% lower total cost
|
|
for $n=3$ and 30.61\% for rotating $n=1.5$. Their endpoint defects changed from
|
|
$.00282583089$ to $.00259308753$ and from $.00299226031$ to $.00199325392$,
|
|
respectively. The $n=2$ reduction was only 1.77\%, too small for a robust timing
|
|
claim from one pair. There were no repeated timing samples or confidence
|
|
intervals, and these are cold one-right-hand-side comparisons, not measured
|
|
benefits from amortized setup reuse.
|
|
|
|
The surface-only $n=2$ candidate ended at $.00567029124$ and failed its gate.
|
|
The tight $n=2$ pair attained $1.87757546\,10^{-4}$ and $1.21976551\,10^{-4}$,
|
|
both failing $10^{-7}$. Those are attained accuracies within a finite budget,
|
|
not arithmetic or discretization floors. All $n=2$ directions with raw-trial
|
|
observations retained the same largest sampled acceptable step $1/256$;
|
|
approximately 90.18\% of their small-step squared Taylor remainder was Poisson.
|
|
Quadratic scaling over the sampled range supports a finite-curvature mechanism,
|
|
without proving its global behavior.
|
|
|
|
The new coarse wrapper handles all 25 surface parameters and every generated
|
|
scalar, with 27 or 28 coarse coordinates. It uses an explicitly unbordered
|
|
field inverse, since restricting an already scalar-bordered inverse could
|
|
spuriously constrain the field response. Typed maps and stationary-application
|
|
contracts are checked at compile time; generation, dimensions and rank are
|
|
checked after preparation. The wrapper is frozen-state only and must be
|
|
reconstructed when the Jacobian changes. Coarse construction uses $2k$ full Jacobian
|
|
actions and $k$ base-inverse actions; each application adds a full Jacobian action and base-inverse application.
|
|
For the combined candidates, total preconditioner construction ranged from
|
|
22.311 to 27.717 seconds; the surface/scalar wrapper alone accounted for
|
|
20.515 to 25.578 seconds. These are distinct timing scopes. Reduced outer iterations
|
|
therefore did not necessarily reduce total time, and the wrapper was not
|
|
promoted to a live default.
|
|
|
|
\subsection{Weak coupled radial response}
|
|
|
|
For an exact derivative and a passing linear gate,
|
|
\[
|
|
\lVert Ap+F\rVert\le\eta\lVert F\rVert
|
|
\quad\Longrightarrow\quad
|
|
F^T Ap\le-(1-\eta)\lVert F\rVert^2.
|
|
\]
|
|
Hence $\eta=.03$ and $.003$ already guarantee infinitesimal descent in the stated
|
|
norm. Tiny accepted steps motivate finite-step and inverse-response diagnostics,
|
|
not the assumption that the direction fails to be a linear descent direction.
|
|
|
|
At the common centrally constrained, nonrotating $n=3$ capture, baseline,
|
|
combined and LDU directions all passed $.003$ and had merit slopes within
|
|
$8\,10^{-6}$ relative of $-\lVert F\rVert^2$. Nevertheless:
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{30mm}p{26mm}p{29mm}p{28mm}p{32mm}@{}}
|
|
Inverse & Normalized surface norm & Normalized signed monopole & Largest sampled $\alpha$ & Full-step $\lVert F_t\rVert/\lVert F\rVert$ \\
|
|
\hline
|
|
\endfirsthead
|
|
Inverse & Normalized surface norm & Normalized signed monopole & Largest sampled $\alpha$ & Full-step $\lVert F_t\rVert/\lVert F\rVert$ \\
|
|
\hline
|
|
\endhead
|
|
Baseline & $.0681146$ & $-.057083$ & $1/4$ & 7.42157 \\
|
|
Combined & $.113440$ & $-.104359$ & $1/16$ & 14.7443 \\
|
|
LDU+gravity & $.0287899$ & $-.00681011$ & $1/4$ & 2.77979 \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
The surface norm and signed monopole in this table use normalized solver
|
|
coordinates, not physical displacement units. The baseline and LDU quarter-step
|
|
residual ratios were $.702686$ and $.674223$.
|
|
The complete combined-minus-baseline and LDU-minus-baseline directions had
|
|
normalized norms 58.44\% and 61.89\% of baseline, but their $A$ actions were only .3197\%
|
|
and .3364\% of $\lVert F\rVert$. Response per unit difference norm was approximately
|
|
183--184 times smaller than for the baseline direction. This measures two weak
|
|
directions, not a condition number, singular vector certificate or exact nullspace.
|
|
|
|
Approximately 43\% of each squared normalized direction-difference norm was
|
|
surface, 34\% potential and 14\% density. Within the squared normalized surface
|
|
difference norm alone, 97.67\% and 96.77\% were monopole. These percentages are
|
|
coordinate-metric contributions, not physical displacement or energy fractions.
|
|
The effect is a coupled radial-size/field response, not primarily translation or
|
|
high-$m$ roughness. Freezing the monopole is unjustified: radius is physical,
|
|
and this control already had a central phase condition. The combined inverse
|
|
reduced the final surface/scalar defect from $4.64933\,10^{-4}$ to
|
|
$1.07519\,10^{-6}$ relative to $\lVert F\rVert$, yet worsened finite trials. LDU permitted
|
|
$9.45535\,10^{-4}$ there while improving the quarter-step trial. Coarse-row
|
|
recovery alone is therefore not a reliable quality measure for a finite Krylov
|
|
direction. The reported coarse reciprocal condition $1.31320\,10^{-9}$ belongs
|
|
to the small approximate matrix, not full $A$.
|
|
|
|
If $e_i=Ap_i+F$, the common gate bounds
|
|
$\lVert A(p_c-p_b)\rVert\le\lVert e_c\rVert+\lVert e_b\rVert$, but does not bound $\lVert p_c-p_b\rVert$ without
|
|
inverse information. This supplies a mathematical reason why preconditioners
|
|
can produce comparable linear defects and different nonlinear behavior. The
|
|
weak-mode magnitude and composition must still be remeasured in the unbordered
|
|
rotating family; they were not demonstrated there by this frozen control.
|
|
|
|
\section{A physically compatible rotating $n=3$ family}
|
|
\label{sec:recent-n3-family}
|
|
|
|
The driver originally calibrated $K$ from a nonrotating Lane--Emden star with
|
|
$M=R=1$ and then retained $M=1$ as $J$ changed. At $n=3$, nonrotating mass is
|
|
independent of central density. This physical compatibility question is separate
|
|
from the measured $n=2$ numerical stall.
|
|
|
|
For nonnegative finite-energy density obeying the exact EOS
|
|
$P=K\rho^{4/3}$, the sharp gravitational-energy inequality implies
|
|
\[
|
|
\lvert W\rvert\le3\Pi\left(\frac{M}{M_{\rm LE}(K)}\right)^{2/3},
|
|
\qquad \Pi=\int P\,dV.
|
|
\]
|
|
Together with isolated steady virial balance $2T+W+3\Pi=0$, this gives the
|
|
necessary condition
|
|
\[
|
|
\beta=\frac{T}{\lvert W\rvert}\le
|
|
\frac12\left[1-\left(\frac{M_{\rm LE}(K)}M\right)^{2/3}\right].
|
|
\]
|
|
In particular, exact $M=M_{\rm LE}(K)$ cannot support nonzero $T$. Nonzero fixed
|
|
$J$ at finite inertia requires $T\ge J^2/(2I)>0$. An extra central-density
|
|
condition cannot repair incompatible mass/EOS inputs; artificial forcing could
|
|
instead conceal the mismatch. The energy inequality and its Lane--Emden mass
|
|
relation are documented in equations (1.14)--(1.15) and Theorem 3.1 of Cheng,
|
|
Cheng and Lin, \emph{Expanding solutions near unstable Lane--Emden stars}; the
|
|
rotation bound above is our consequence of that inequality and the virial
|
|
identity.
|
|
|
|
The numerical calibration is only approximately critical. Independent DOP853
|
|
Lane--Emden integrations using five tolerance/start/step controls found
|
|
$M_{\rm LE}=.9999999918534539$ for recorded $K=.36393905995216302$, permitting
|
|
only $\beta\lesssim2.71552\,10^{-9}$. The control spread in mass was
|
|
$1.95\,10^{-14}$, a numerical sensitivity observation rather than a rigorous
|
|
interval enclosure. This near-critical input cannot represent the intended
|
|
moderate rotational support under the continuum assumptions.
|
|
|
|
The discrete equations need not satisfy every assumption: independent
|
|
$\rho/P(h)$, weak EOS closure, negative density, approximate gravity and central
|
|
forcing all require separate scrutiny. The argument chooses a sensible target;
|
|
it is not a density limiter or a proof that a discrete residual cannot vanish.
|
|
|
|
A separate experiment reduced $K$ by 1\%, kept target $M=1$, prescribed
|
|
$J=.035$ and omitted the central condition. Its necessary bound became
|
|
$\beta\le.00500000269$. The seed's central density was multiplied by
|
|
$.99^{3/2}$ to retain its reference radius, making its seed mass approximately
|
|
$.99^{3/2}$ while target mass remained one. This is an explicitly off-constraint
|
|
initial guess, not density rescaling during Newton. The seed Bernoulli scalar
|
|
still used target mass; that mismatch remained in the initial residual.
|
|
|
|
Nonzero prescribed $J$ already breaks the nonrotating homology, so an additional
|
|
central condition was not added. At fixed $M,K$ an $n=3$ homology can change size
|
|
and $J$ without specifying a new dimensionless shape/rotation fraction. Neither
|
|
input $J$ nor an uncalibrated angular velocity should be called a fraction of
|
|
critical rotation.
|
|
|
|
\subsection{Matched live field-feedback result}
|
|
|
|
Two cases shared $n=3$, $J=.035$, $K$ factor $.99$, no central condition,
|
|
all-$m$ L4/Q2, the gravity-curvature trial path, $\eta=.03$, ten updates and
|
|
absolute target $10^{-12}$. Their initial completed norm was $.101333855231$.
|
|
Only the inverse differed. Both exhausted the budget.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{73mm}p{35mm}p{37mm}@{}}
|
|
Quantity & Gravity-Schur & Stellar LDU + gravity-Schur \\
|
|
\hline
|
|
\endfirsthead
|
|
Quantity & Gravity-Schur & Stellar LDU + gravity-Schur \\
|
|
\hline
|
|
\endhead
|
|
Final normalized residual & $1.64730591\,10^{-4}$ & $1.29842469\,10^{-5}$ \\
|
|
Newton seconds & 918.881 & 1052.972 \\
|
|
Linear seconds & 348.441 & 335.399 \\
|
|
Krylov iterations & 534 & 410 \\
|
|
Trial preparation seconds & 477.771 & 621.957 \\
|
|
Final accepted $\alpha$ & $1/16$ & $1/64$ \\
|
|
Energy virial, $P(h)$ & $7.18429\,10^{-5}$ & $1.81141\,10^{-5}$ \\
|
|
Force virial, $P(h)$ & $5.23757\,10^{-5}$ & $2.90028\,10^{-6}$ \\
|
|
Energy virial, $P(\rho)$ & $6.96335\,10^{-5}$ & $3.51558\,10^{-5}$ \\
|
|
Force virial, $P(\rho)$ & $5.01663\,10^{-5}$ & $1.41415\,10^{-5}$ \\
|
|
Absolute mass error & $5.45536\,10^{-5}$ & $3.37148\,10^{-6}$ \\
|
|
EOS RMS / density scale & $3.99773\,10^{-4}$ & $4.00529\,10^{-4}$ \\
|
|
Bernoulli RMS / enthalpy scale & $.00408345$ & $.00372207$ \\
|
|
Hydrostatic-gradient RMS & $.656446$ & $.588702$ \\
|
|
$T/\lvert W\rvert$ & $.00497575$ & $.00497421$ \\
|
|
Angular velocity, model units & $.401764$ & $.401388$ \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
LDU reached a 12.687-times lower residual after the same update count, at
|
|
14.593\% more Newton time. Linear time fell 3.743\%, while preparation rose
|
|
30.179\%. These are evolving trajectories, not a speedup to the same converged
|
|
solution. All full linear gates passed, and every rejected trial failed
|
|
sufficient decrease; neither trajectory had pressure or geometry rejection.
|
|
q18 density samples were positive without repair, not a global positivity
|
|
certificate. Thus forcing positivity is not supported as the immediate remedy
|
|
for this measured live obstruction.
|
|
|
|
The LDU trajectory reached $1.30261014\,10^{-5}$ after update seven with a full
|
|
step; three subsequent $1/64$ steps improved it only .3213\%. Its final squared
|
|
residual was 36.500\% Poisson, 34.432\% hydrostatic, 20.234\% surface and 6.742\%
|
|
mass. Gravity-only ended 80.254\% hydrostatic and 10.967\% mass. Field feedback
|
|
is a substantive improvement on this trial path but does not remove small-step
|
|
stagnation. Its merit over raw-Newton policies has not been established by this
|
|
pair, since both shared the gravity-curvature strategy.
|
|
|
|
\section{Virial consistency: pressure and gravity must be distinguished}
|
|
\label{sec:recent-virial}
|
|
|
|
\begin{figure}[htbp]
|
|
\centering
|
|
\includegraphics[width=.95\linewidth]{figures/n3_ldu_meridional.png}
|
|
\caption{Physical meridional density and enthalpy slices of the final rotating
|
|
$n=3$, $J=.035$, $K$-factor $.99$ LDU plus gravity-Schur endpoint. The image
|
|
shows the actual surface deformation without magnification. The model remains
|
|
unconverged and fails the overall virial milestone; only four display
|
|
subdivisions were used for this image.}
|
|
\label{fig:recent-n3-slice}
|
|
\end{figure}
|
|
|
|
The final rotating LDU model does not meet the overall $10^{-5}$ milestone.
|
|
Only force virial formed with $P(h)$ passes. Its signed enthalpy virials are
|
|
approximately
|
|
\[
|
|
v_E^h=+1.811408\,10^{-5},\qquad v_F^h=-2.900278\,10^{-6},
|
|
\]
|
|
where both use $\lvert W_E\rvert$ as denominator. Their difference, approximately
|
|
$2.10144\,10^{-5}$, agrees with the separately measured gravity-energy
|
|
consistency discrepancy. Replacing $P(h)$ by $P(\rho)$ shifts both signed
|
|
virials by approximately $+1.70418\,10^{-5}$, yielding
|
|
$+3.515584\,10^{-5}$ and $+1.414148\,10^{-5}$.
|
|
|
|
At one fixed state, pressure changes both signed virials equally:
|
|
\[
|
|
v_E^\rho-v_E^h=v_F^\rho-v_F^h
|
|
=\frac{3(\Pi_\rho-\Pi_h)}{\lvert W_E\rvert},\qquad
|
|
v_E-v_F=\frac{W_E-W_F}{\lvert W_E\rvert}.
|
|
\]
|
|
Consequently, even an arbitrary common pressure-only shift leaves at least one
|
|
absolute virial at or above half their separation, approximately
|
|
$1.05072\,10^{-5}$. Pressure adjustment alone cannot make both pass in this
|
|
frozen state. This is a fixed-state arithmetic observation, not a bound on a
|
|
newly solved or refined model.
|
|
|
|
q14/q18 energy virials agreed to below $8\,10^{-14}$ in both rotating runs.
|
|
Quadrature stability must not be mistaken for mesh accuracy. The gravity gap
|
|
remained about $2\,10^{-5}$, while EOS RMS stayed near $4\,10^{-4}$ despite the
|
|
large algebraic gain. Since neither state solves the discrete equations and
|
|
neither mesh nor order was varied, these observations do not establish a
|
|
spatial error floor or identify an exterior-only cause.
|
|
|
|
\subsection{Pressure-moment identity and the density test space}
|
|
|
|
For nonnegative $h,\rho$, set $\rho_*=[h/((n+1)K)]^n$ and
|
|
$\delta\rho=\rho-\rho_*$. Convexity of $P(\rho)=K\rho^{1+1/n}$ gives
|
|
\[
|
|
P(\rho)-P(h)=\frac hn\delta\rho+D_P(\rho,\rho_*),\qquad D_P\ge0,
|
|
\]
|
|
because $P'(\rho_*)=h/n$. For a represented density test
|
|
$v=\sum_i c_i\varphi_i$ and the same mapped quadrature $Q$ used in closure,
|
|
\[
|
|
Q\left[\frac hn\delta\rho\right]
|
|
=\frac1nQ[(h-v)\delta\rho]+\frac1n\sum_i c_iR_i.
|
|
\]
|
|
Current DGQ2 tests do not generally contain Q3 enthalpy. The first term can
|
|
therefore remain even at zero weak closure. Compatible DGQ3 tests would permit
|
|
$v=h$ elementwise, canceling the linear moment at exact closure under that same
|
|
quadrature. Density would remain an independent field. At finite residual the
|
|
remaining term is $c_h^TR/n$, which is not directly measured by a normalized
|
|
Newton norm without undoing residual scaling.
|
|
|
|
The convex remainder persists, and is not uniformly quadratic near vacuum:
|
|
for $n>1$, $P''(\rho)$ diverges as density approaches zero; at $\rho_*=0$,
|
|
$D_P=K\rho^{1+1/n}$, with exponent $4/3$ for $n=3$. Separate diagnostic quadrature
|
|
can also retain a difference after assembled moment cancellation. The identity
|
|
is conditional on nonnegative fields where evaluated and is specific to a
|
|
constant-$K$ polytrope; a general EOS uses its own thermodynamic derivatives.
|
|
The contribution of each term has not yet been measured in the final models.
|
|
This is a consistency hypothesis and a diagnostic to implement, not proof that
|
|
raising order, clipping density or changing pressure will solve convergence.
|
|
|
|
\section{Physical two-dimensional model slices}
|
|
\label{sec:recent-slices}
|
|
|
|
The added optional diagnostic exports physical $xz$ and $xy$ cuts, with $yz$ and
|
|
offsets available, showing independent density and enthalpy and the actual
|
|
material boundary. It changes no equations or field representation. The
|
|
important geometric contract is a cut by a physical plane, not a reference
|
|
plane deformed afterward.
|
|
|
|
Each stellar hexahedron is subdivided in reference coordinates into a lattice
|
|
and tetrahedra. Crossed edges solve the actual mapped plane equation using a
|
|
safeguarded bracketed root calculation. Fields are evaluated at those reference
|
|
coordinates on the owning element. Density traces are not averaged between DG
|
|
elements; supplied connectivity prevents triangulation across vacuum. A plane
|
|
coincident with an internal face uses the positive-normal-side trace. Boundary
|
|
curves are separately evaluated from stellar/nonstellar faces, and the
|
|
undeformed outline is independently cut by the same physical plane.
|
|
|
|
The plotter uses equal physical axis scales, no deformation magnification, and
|
|
signed field values without clipping, logarithms or EOS replacement. Scalar
|
|
values are rasterized on a 512-by-512 grid before color mapping, avoiding
|
|
color-interpolation artifacts under triangle refinement. Exterior pixels stay
|
|
masked. Images distinguish solid deformed and optional dashed reference
|
|
outlines and mark known unconverged endpoints.
|
|
|
|
Straight triangles and boundary chords approximate the curved cut. Neighboring
|
|
parent elements may choose different face diagonals; small gaps/overlaps can
|
|
therefore occur on curved interfaces. A covered raster pixel uses the first
|
|
supplied triangle, without cross-element averaging. Tangencies or multiple
|
|
crossings between subdivision vertices can be missed. These limits are
|
|
explicitly documented and prevent using the image as a pointwise positivity
|
|
certificate or interpreting every seam as a physical feature.
|
|
|
|
\subsection{Display-refinement measurements}
|
|
|
|
Four unchanged-state replays compared four/eight subdivisions for final $n=2$
|
|
and rotating $n=1.5,J=.1$ states, in both planes. Source buffers remained
|
|
bitwise unchanged, and both resolutions used common axes and color ranges.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{40mm}p{24mm}p{28mm}p{28mm}p{25mm}@{}}
|
|
Model/plane & Area change & $\int\rho\,dA$ change & $\int h\,dA$ change & Perimeter change \\
|
|
\hline
|
|
\endfirsthead
|
|
Model/plane & Area change & $\int\rho\,dA$ change & $\int h\,dA$ change & Perimeter change \\
|
|
\hline
|
|
\endhead
|
|
$n=2$, $xz$ & $.12333\%$ & $.07667\%$ & $.07036\%$ & $.03065\%$ \\
|
|
$n=2$, $xy$ & $.12333\%$ & $.07667\%$ & $.07036\%$ & $.03065\%$ \\
|
|
$n=1.5,J=.1$, $xz$ & $.12495\%$ & $.00319\%$ & $.08797\%$ & $.03165\%$ \\
|
|
$n=1.5,J=.1$, $xy$ & $.12395\%$ & $.01249\%$ & $.07838\%$ & $.03088\%$ \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
These are relative absolute changes of displayed straight-triangle measures,
|
|
including overlaps; they are not curved-FEM integrals, three-dimensional mass,
|
|
virial errors or a mesh convergence study. Sampled chord errors decreased about
|
|
fourfold and axial extents agreed. The rotating meridional model was smoothly
|
|
oblate, with equatorial extent approximately $\pm1.12084$ and polar extents
|
|
$-.988807,+.988480$; the equatorial cut was approximately circular. Its sampled
|
|
negative density minimum $-8.59\,10^{-4}$ was retained. The $n=2$ outline was
|
|
nearly spherical at radius 1.0049. Only the latter met its recorded virial
|
|
milestone, and both remained unconverged algebraically.
|
|
|
|
\begin{figure}[htbp]
|
|
\centering
|
|
\includegraphics[width=.98\linewidth]{figures/n1p5_rotating_refinement.png}
|
|
\caption{Same-state physical slice comparison for the unconverged rotating
|
|
$n=1.5$ endpoint at four and eight display subdivisions. Axes and color ranges
|
|
are shared. This checks the displayed geometry and fields; it is not a change
|
|
of the FEM mesh, a three-dimensional integral check or evidence of equilibrium.}
|
|
\label{fig:recent-display-refinement}
|
|
\end{figure}
|
|
|
|
Final $n=3$ meridional/equatorial plots show strong central concentration and
|
|
modest oblateness. Those exports used four subdivisions only. The separate
|
|
$n=2/n=1.5$ display study must not be described as refinement verification of
|
|
the $n=3$ images. Visual plausibility supplies an additional diagnostic, not
|
|
physical validation.
|
|
|
|
\section{What to carry forward and what remains unresolved}
|
|
\label{sec:recent-next}
|
|
|
|
The recent work establishes a usable native harmonic prescription, diagnoses a
|
|
specific independent-density projection defect, measures order effects without
|
|
changing density's physical status, adds reproducible physical slices, and
|
|
shows real frozen-linear and live-nonlinear gains. It does not establish a
|
|
converged moderately rotating $n=3$ model, a calibrated 50\%-critical sequence,
|
|
or the ultimate 99\%-critical ambition. No ESTER comparison was performed.
|
|
Global virial balance at $10^{-5}$ remains a primary acceptance milestone,
|
|
accompanied by internal EOS/hydrostatic checks; an attractive image or a small
|
|
subset of residuals cannot replace it.
|
|
|
|
The evidence supports the following staged continuation.
|
|
\begin{enumerate}
|
|
\item Retain gravity-Schur as the strongest measured frozen linear-cost
|
|
comparator and stellar LDU plus gravity as the better live candidate in the
|
|
tested rotating $n=3$ configuration. The latter is conditional on the shared
|
|
gravity-curvature trial path. Compare complete time to a common convergence
|
|
and physical target before selecting a production default. Do not promote the
|
|
new coarse surface/scalar wrapper merely because it lowers iterations.
|
|
\item Remeasure coupled direction differences in the unbordered compatible
|
|
rotating family, including true defects, field/modal composition and finite
|
|
trial remainders. The centrally constrained nonrotating weak-monopole evidence
|
|
is a motivated hypothesis, not a transferred diagnosis. A coupled trust-region
|
|
or regularized step with a physical displacement scale is a reasonable swappable
|
|
experiment. Radius must remain free, and surface/interior remain simultaneous.
|
|
\item Strengthen the material response in controlled stages if its frozen block
|
|
defects warrant it. Existing material preconditioning already contains the
|
|
exact prepared enthalpy-to-density derivative; it is incorrect to claim that
|
|
cross derivative is missing. Exact local mapped DG density mass inversion is a
|
|
narrow candidate (27 Q2 coefficients per hexahedron). A stronger stationary
|
|
enthalpy mass inverse must respect H1 connectivity and replaced boundary rows.
|
|
Only then consider a more costly EOS-aware material/gravity Schur approximation.
|
|
Such algebraic eliminations belong inside the inverse and need not make density
|
|
a derived nonlinear field.
|
|
\item Measure pressure-moment and gravity-energy consistency separately. Export
|
|
the linear pressure moment, convex remainder, quadrature differences and both
|
|
signed virials on identical states. Resolve the gravity relation/source and
|
|
energy/force discrepancy with interior accuracy as the goal; the exterior need
|
|
only be accurate insofar as it supports correct interior fields. The current
|
|
observations do not justify allocating effort solely to exterior resolution.
|
|
\item Define a physically compatible $n=3$ sequence in mass/EOS/rotation and
|
|
calibrate a dimensionless rotation measure and critical reference. Input $J$
|
|
alone is not that calibration. Keep central homology handling optional and
|
|
separate from incompatible physical specifications.
|
|
\item After useful convergence is obtained, perform mesh and harmonic-degree
|
|
studies, measure excluded surface force in a meaningful norm, and compare local
|
|
profiles with analytic/nonrotating controls and eventually ESTER. Density-order
|
|
results remain available as consistency controls; positivity intervention and
|
|
logarithmic refactoring are deferred per the user's direction.
|
|
\end{enumerate}
|
|
|
|
A closure-consistent seed and an affine-target closure correction are additional
|
|
untested hypotheses, not completed remedies. At fixed admissible enthalpy and
|
|
geometry, exact local density mass solves can populate independent density or
|
|
correct its weak moments. Any trial correction must preserve the original
|
|
Newton tangent and be freshly verified. If combined with gravity correction,
|
|
density must be corrected first and gravity rebuilt against its original affine
|
|
target afterward. That operation can change mass, inertia and mechanical
|
|
balance, cannot repair unchanged inadmissible enthalpy, and must pass the full
|
|
residual acceptance test. For fractional $1<n<2$, a uniform quadratic correction
|
|
claim near vacuum would be unsound because the EOS derivative is only H\"older
|
|
continuous there. No such closure trial policy was implemented in this phase.
|
|
|
|
A projected surface-equipotential equation and lower harmonic degree were also
|
|
reviewed as future operator studies but not implemented or tested. They change
|
|
the discrete problem. Any surface-potential derivative must respect the actual
|
|
ALE pullback and field transport; substituting an effective-gravity derivative
|
|
without that derivation would not be justified.
|
|
|
|
\subsection{Recent implementation verification and provenance}
|
|
|
|
Release builds and selected targets passed. The new coarse inverse passed 70
|
|
assertions in nine tests. The transactional diagnostic initializer passed 71
|
|
assertions in three real-FEM tests; it validates snapshot coordinates, prepares
|
|
and refreshes before committing, clears stale warm starts and rolls back on
|
|
failure. Snapshot compatibility checks include names, sizes, mesh and metadata,
|
|
and unconverged captures require an explicit experimental override. Read-only
|
|
observation and state installation remain separate operations.
|
|
|
|
Pure slice geometry controls passed, as did 14 plotting/comparison tests, 11
|
|
artifact-auditor controls and 11 tests for each convergence plotter including
|
|
actual rendering. No unrelated full-suite claim is made. All 24 final-campaign
|
|
cases passed retained-artifact audits: five nonlinear screens, two matched
|
|
trial-path restarts, eleven frozen comparisons, four slice replays and two live
|
|
$n=3$ cases. All nine nonlinear runs in that final campaign were unconverged
|
|
within their declared budgets. A passing audit can accurately certify records
|
|
of a failed linear gate or unconverged model; it does not certify scientific
|
|
success.
|
|
|
|
The Sept. 19 integration branch ended at
|
|
\nolinkurl{d7acb0d399aac5ac4c36d834a954c1c959042b81}. Producer revisions differ across
|
|
adaptive experiments because hypotheses were declared and committed before
|
|
execution. Campaigns retain private copied executables, source/mesh/input
|
|
hashes, build settings, exact arguments, logs, states and output hashes. The
|
|
study index binds six audit files and final report/figure hashes. Later report
|
|
and plotting edits do not replace numerical producer provenance. Expensive
|
|
builds, FEM runs, vector audits and rendering were serialized. Timing comparisons
|
|
are workstation observations with the cost scopes stated above, not portable
|
|
hardware benchmarks.
|
|
|
|
\section{Consolidated source, architecture, and handoff}
|
|
\label{sec:consolidated-source}
|
|
|
|
\subsection{What the consolidation changes}
|
|
|
|
The consolidation uses the cumulative research revision
|
|
\nolinkurl{d7acb0d399aac5ac4c36d834a954c1c959042b81} as its numerical
|
|
source baseline. This revision descends from the former local main,
|
|
\texttt{75cc638}, through the baseline snapshot \texttt{80cc3d8} and the
|
|
successive controlled investigations. Most topic branches were incorporated
|
|
by cherry-pick during those investigations. Their tips therefore need not
|
|
appear as ancestors of the cumulative branch for their changes to be
|
|
present. The consolidation checks both ancestry and final source content;
|
|
it does not indiscriminately merge every experimental tip.
|
|
|
|
The integration branch is
|
|
\nolinkurl{integration/research-consolidation-20260920}.
|
|
At the source checkpoint \texttt{b1fe359}, the additions after the numerical
|
|
baseline are the preserved user formatting change, \texttt{6950dc6}, and
|
|
six commits importing the historical log-density assessment. The latter
|
|
begin at \texttt{549b1a7} and end at \texttt{b1fe359}; they add only
|
|
\nolinkurl{experiments/LOG_DENSITY_ASSESSMENT_2026-09-19.md} and
|
|
\nolinkurl{experiments/log_density_reference_model.py}. They do not implement
|
|
log-density coordinates in the FEM solver. The consolidation itself adds
|
|
no new numerical behavior. Its other changes organize evidence, document
|
|
results, and retain useful source and tests. Local main is advanced to the
|
|
validated consolidation descendant; there is no remote push and no deletion
|
|
of historical research branches. The final integration commit and validation
|
|
record identify the exact published local checkpoint. The final delivery is
|
|
identified by the local Git tag \nolinkurl{research-handoff-2026-09-20}; the tag
|
|
records the complete report and validation as well as the integrated source.
|
|
|
|
The original programming checkout was initially on
|
|
\nolinkurl{research/numerical-strategies-20260917} at \texttt{10adf7e}, rather
|
|
than on main. Its only tracked modification was declaration formatting in
|
|
\nolinkurl{libmeanfield/interface/quadrature/mfem.cppm}; that modification is
|
|
preserved in \texttt{6950dc6}. This distinction matters because replacing
|
|
the original checkout with a research tree without first preserving the
|
|
edit would lose user work. Research reports and raw evidence are also
|
|
preserved, including unsuccessful experiments. Moving an artifact is not a
|
|
revision of its original producer, parameters, or hash.
|
|
|
|
\subsection{Architectural boundary between physics and numerics}
|
|
|
|
The intended public construction remains physics forward: an EOS, a surface
|
|
condition, and explicit integral specifications describe the stellar model.
|
|
A separately owned discretization describes the finite elements,
|
|
normalization, surface coordinates, and displacement extensions. An owning
|
|
preconditioner prescription and an owning linear-backend configuration are
|
|
prepared only after the physical problem exists. The solve context then owns
|
|
the accepted state, prepared operators, prepared inverse, and nonlinear
|
|
transaction machinery. This separation is valuable in the rewrite: changing
|
|
a numerical approximation must not silently add a central-density
|
|
constraint, change an EOS relation, or select a different physical family.
|
|
|
|
The current implementation uses C++23 modules, concepts, generated block
|
|
manifests, and typed prescriptions. Compile-time checks cover structural
|
|
facts: supported EOS relations, derivative availability, field and block
|
|
roles, admissible prescription combinations, and backend application
|
|
contracts. Mesh-dependent facts remain runtime checks: dimensions,
|
|
rank of a sampled harmonic basis, actual topology, preparation generations,
|
|
finite parameters, support layout, and distributed agreement. A type cannot
|
|
prove that a sampled geometry is admissible or that a numerical inverse
|
|
is accurate, so those checks remain explicit and measurable.
|
|
|
|
There are three distinct levels of composition:
|
|
\begin{enumerate}
|
|
\item A physical model compiles its field equations and specifications
|
|
into value and residual blocks, including generated scalar coordinates,
|
|
appended integral equations, and explicitly replaced carrier rows.
|
|
\item A discretization supplies coordinates and maps for these blocks.
|
|
Physical operators are prepared on the accepted geometry and state;
|
|
their actions and cross derivatives remain the source of truth.
|
|
\item A numerical recipe approximates the inverse or modifies a trial
|
|
path, while the complete residual and physical diagnostics judge the
|
|
resulting state. An exact coarse row in an approximate inverse is not
|
|
an exact solution of the full problem.
|
|
\end{enumerate}
|
|
|
|
Important source boundaries are
|
|
\nolinkurl{libmeanfield/interface/models/},
|
|
\nolinkurl{libmeanfield/interface/equilibrium/stellar_discretization.cppm},
|
|
\nolinkurl{libmeanfield/interface/operators/root_manifest.cppm},
|
|
\nolinkurl{libmeanfield/interface/operators/stellar_equilibrium_compiler.cppm},
|
|
\nolinkurl{libmeanfield/interface/preconditioning/stellar_recipe.cppm}, and
|
|
\nolinkurl{libmeanfield/interface/solver/stellar_context.cppm}.
|
|
The experiments directory owns case selection, historical studies, optional
|
|
probe recipes, artifact verification, and visualization. It should not
|
|
be mistaken for a minimal production API.
|
|
|
|
\subsection{Fields, geometry, and the preferred surface representation}
|
|
|
|
The retained baseline has independent discontinuous Q2 density and
|
|
independent continuous Q3 enthalpy. Gravity uses the existing RT2/Q2 mixed
|
|
pair; displacement is Q3, while the reference mesh geometry is Q4.
|
|
The density order is now independently configurable at compile time through
|
|
\nolinkurl{MEAN_FIELD_DENSITY_POLYNOMIAL_ORDER}; its default is two. A uniform
|
|
order increment remains a separate existing option. The closure quadrature
|
|
query now covers both density-mass and EOS-source contributions when density
|
|
order changes. Neither this configuration mechanism nor the completed order
|
|
study establishes that a higher density order cures the nonlinear stall.
|
|
|
|
The preferred research surface is the native real spherical-harmonic
|
|
prescription with maximum degree four and every azimuthal order:
|
|
\begin{equation}
|
|
q_i = \sum_{\ell=0}^{4}\sum_{m=-\ell}^{\ell}
|
|
a_{\ell m}Y_{\ell m}(\widehat{\boldsymbol r}_i),
|
|
\qquad N_a=25.
|
|
\end{equation}
|
|
The coefficients have dimensions of length. Negative real orders encode
|
|
sine modes and positive orders encode cosine modes; neither odd degree nor
|
|
nonzero $m$ is silently removed. A maximum absolute azimuthal order can be
|
|
specified explicitly. For example, restricting the shape to $m=0$ leaves
|
|
five coefficients at degree four, but does not by itself make the interior
|
|
three-dimensional fields axisymmetric.
|
|
|
|
The harmonic prescription supplies values at reference trace nodes. The
|
|
existing Q3 trace and volume extension then realize the displacement in
|
|
finite-element space. The resulting surface is therefore not an exact
|
|
analytic harmonic graph between nodes. Q4 reference geometry and Q3
|
|
incremental displacement coexist deliberately; changing their orders is a
|
|
separate approximation study. The higher displacement-order trial remains
|
|
a recorded negative result, not the active default.
|
|
|
|
Surface coefficients and interior fields participate in the same Newton
|
|
system with their cross derivatives. The reference trace metric provides
|
|
compatible primal and dual coefficient scaling. It does not approximate
|
|
the complete physical response of the interior to a surface change. The
|
|
current native harmonic implementation requires one MPI rank, consistent
|
|
with the retained radial volume extension. Tests of collective rejection
|
|
on two ranks do not demonstrate distributed harmonic solving.
|
|
|
|
The sandbox selects the harmonic prescription explicitly. Existing
|
|
\emph{two-argument} calls to \nolinkurl{makeStellarDiscretization} still select
|
|
\nolinkurl{NodalRadialSurface}; their behavior is preserved for compatibility.
|
|
This is an intentional distinction between the preferred example and the
|
|
backward-compatible factory default.
|
|
|
|
\subsection{Defaults, explicit controls, and experimental candidates}
|
|
|
|
The following table records the source checkpoint rather than proposing
|
|
new settings. A capability entering main is not automatically promoted to
|
|
a default.
|
|
|
|
\begin{longtable}{p{0.24\linewidth}p{0.68\linewidth}}
|
|
\hline
|
|
Layer & Retained behavior and interpretation \\
|
|
\hline
|
|
\endfirsthead
|
|
\hline
|
|
Layer & Retained behavior and interpretation \\
|
|
\hline
|
|
\endhead
|
|
\hline
|
|
\endfoot
|
|
Model example & The sandbox is $n=1$, $J=0$, with fixed total mass and
|
|
angular momentum. Central density initializes the Lane--Emden seed; it is
|
|
not an additional $n=1$ equation. Central-density constraints remain
|
|
explicit model specifications for studies that require them. \\
|
|
Surface & Sandbox: all-$m$, degree-four harmonics. Two-argument library
|
|
factory: nodal radial surface. Both compose with the existing interior
|
|
radial and fixed-infinity vacuum extensions. \\
|
|
Normalization & The sandbox selects \nolinkurl{PhysicalRieszDiagonal} on
|
|
reference geometry with a fixed branch mass/radius scale. Modal surface
|
|
coordinates use their pulled-back reference trace metric. \\
|
|
Library linear options & \nolinkurl{FGMRESOptions} has restart length 50.
|
|
This default was not globally changed to 160. \\
|
|
Sandbox solve & Explicit restart 160; at most 30 Newton updates; relative
|
|
nonlinear tolerance $10^{-8}$, absolute tolerance zero; linear relative
|
|
tolerance $0.03$ and cap 200. Geometry validation/backtracking remain. \\
|
|
Diagnostic controls & Bare driver defaults retain nodal surface, restart
|
|
40, independent structure inverse, and baseline trial strategy. Campaign
|
|
manifests explicitly override these. Reproduction requires the recorded
|
|
manifest, not assumptions about the bare driver defaults. \\
|
|
Linear reuse & A nonzero incoming correction is checked with the current
|
|
operator and RHS. It is reset if its true defect is nonfinite or larger
|
|
than the cold-start RHS norm. Final convergence is checked against the
|
|
fresh full-system true residual. \\
|
|
Default structure inverse & \nolinkurl{IndependentStellarSubsystems} applies
|
|
material/surface and gravity approximations independently at that level.
|
|
Generated scalar-border completion is still present. \\
|
|
Default material inverse & \nolinkurl{SurfaceThenMaterialTriangular} uses
|
|
diagonal surface, enthalpy, and density inverses. The prepared EOS
|
|
$h\rightarrow\rho$ derivative and surface-to-material cross actions are
|
|
already included; the approximation is not fully field diagonal. \\
|
|
Default gravity inverse & \nolinkurl{GravityApproximateLDU} uses a matrix-free
|
|
Chebyshev mass inverse of order five with 20 power iterations, and three
|
|
fixed AMG cycles for the potential surrogate. \\
|
|
Gravity refinement & \nolinkurl{GravityConsistentSchurLDU} is an available typed
|
|
policy. Its library default is one correction sweep with relaxation one;
|
|
the diagnostic option defaults to relaxation $0.5$. Exact run settings
|
|
must come from the manifest. \\
|
|
Live research recipes & \nolinkurl{gravity-schur}, \nolinkurl{stellar-ldu}, and
|
|
\nolinkurl{stellar-ldu-gravity-schur} are explicit experiment recipes. The last
|
|
is the stronger measured live candidate for the tested compatible rotating
|
|
$n=3$ family with a gravity-curvature trial path. It is not a demonstrated
|
|
universal replacement for the default. \\
|
|
Default Newton path & \nolinkurl{SampledEnthalpy}, \nolinkurl{MonolithicGravity},
|
|
and \nolinkurl{UncorrectedTrial}. No polynomial positivity repair, gravity
|
|
elimination, or second-order correction is enabled implicitly. \\
|
|
Optional Newton paths & Polynomial admissibility/repair, gravity-curvature
|
|
correction, reduced gravity, and coupled/damped trial correction remain
|
|
explicit typed research choices with their checked contracts. Their
|
|
presence does not imply successful high-rotation convergence. \\
|
|
Coarse surface/scalar inverse & Frozen experiment only. Its base inverse
|
|
is explicitly unbordered and its state/generation binding is checked.
|
|
Changed Jacobians require reconstruction. Setup and application expense
|
|
prevent promotion on present evidence. \\
|
|
Continuation & Explicit diagnostic initialization validates coordinates,
|
|
layout, mesh, and finite data; prepares and refreshes before commit; clears
|
|
stale linear guesses; and rolls back on failure. Unconverged snapshots need
|
|
an explicit experimental override. \\
|
|
Slices & Optional physical-plane output evaluates the independent fields
|
|
inside their owning elements on the deformed stellar geometry. Signed
|
|
values are retained. Display refinement is not mesh convergence. \\
|
|
\end{longtable}
|
|
|
|
The default material response can be written schematically, in physical
|
|
block notation, as
|
|
\begin{align}
|
|
\delta a &= D_a^{-1} b_a,\\
|
|
\delta h &= D_h^{-1}(b_h-A_{ha}\delta a),\\
|
|
\delta\rho &= D_\rho^{-1}
|
|
(b_\rho-A_{\rho a}\delta a-A_{\rho h}\delta h).
|
|
\end{align}
|
|
Here the diagonal inverses are approximate mass/trace inverses, whereas
|
|
$A_{\rho h}$ is the actual prepared EOS cross action. At the next level the
|
|
default structure inverse omits direct material--gravity feedback. The
|
|
optional stellar LDU first obtains a material response, sends its source
|
|
and geometry effects into gravity, and recovers gravity feedback into
|
|
material. Gravity-only Schur refinement improves the gravity block; it
|
|
does not itself add this EOS/material feedback. These distinctions explain
|
|
why the later ablations compare multiple policies rather than treating all
|
|
coupling changes as a single intervention.
|
|
|
|
\subsection{Branch disposition and retained provenance}
|
|
|
|
The table below refers to the research tips retained from the investigation.
|
|
``Included'' means ancestry or inspected patch/content equivalence, not
|
|
necessarily a merge commit with that branch tip as a parent. The six
|
|
log-assessment commits were imported during consolidation. All named
|
|
historical branches are retained; no branch deletion is part of this work.
|
|
|
|
\begin{longtable}{p{0.43\linewidth}p{0.10\linewidth}p{0.37\linewidth}}
|
|
\hline
|
|
Branch & Tip & Disposition \\
|
|
\hline
|
|
\endfirsthead
|
|
\hline
|
|
Branch & Tip & Disposition \\
|
|
\hline
|
|
\endhead
|
|
\hline
|
|
\endfoot
|
|
\nolinkurl{main} & \texttt{75cc638} & Former main checkpoint; ancestor of the consolidation baseline. \\
|
|
\nolinkurl{research/baseline-20260916} & \texttt{80cc3d8} & Included baseline snapshot of user optimizations and initial diagnostics. \\
|
|
\nolinkurl{research/central-constraint-20260916} & \texttt{2e19c2c} & Included equivalent commits: central density as seed data in the n1 example. \\
|
|
\nolinkurl{research/combined-20260916} & \texttt{95d9fba} & Included cumulative first controlled campaign. \\
|
|
\nolinkurl{research/experiment-harness-20260916} & \texttt{899cb18} & Included diagnostic and physical acceptance reporting. \\
|
|
\nolinkurl{research/krylov-20260916} & \texttt{7127383} & Included warm-start true-residual safeguard and controls. \\
|
|
\nolinkurl{research/krylov-window-20260916} & \texttt{1f9184b} & Included restart160 sandbox setting; report identical. \\
|
|
\nolinkurl{research/gravity-coupling-20260916} & \texttt{db0ddd3} & Failed one-way completion remains historical; no old driver/default promotion. \\
|
|
\nolinkurl{research/diagnostic-campaign-20260917} & \texttt{7a07cae} & Included pressure/shape attribution campaign. \\
|
|
\nolinkurl{research/pressure-obstruction-20260917} & \texttt{c6572d3} & Included pressure, trace, and nodal diagnostic exports. \\
|
|
\nolinkurl{research/shape-curvature-20260917} & \texttt{b24e6e0} & Included frozen shape/field curvature separation. \\
|
|
\nolinkurl{research/numerical-strategies-20260917} & \texttt{10adf7e} & Included typed optional strategy integration and validation. \\
|
|
\nolinkurl{research/polynomial-positive-newton-20260917} & \texttt{9aefb36} & Included explicit experimental certificate/repair; disabled by default. \\
|
|
\nolinkurl{research/polynomial-endpoint-certification-20260917} & \texttt{cc6f4b0} & Included read-only polynomial endpoint certification. \\
|
|
\nolinkurl{research/gravity-curvature-correction-20260917} & \texttt{3762c74} & Included checked auxiliary gravity correction; opt-in. \\
|
|
\nolinkurl{research/gravity-reduced-newton-20260917} & \texttt{d25d141} & Included reduced formulation and full-system checks; opt-in. \\
|
|
\nolinkurl{research/gravity-compact-application-20260917} & \texttt{ff1b889} & Included compact canonical gravity action and guarded fallback. \\
|
|
\nolinkurl{research/gravity-prepared-roundoff-20260917} & \texttt{782827c} & Included prepared consistency arithmetic scale. \\
|
|
\nolinkurl{research/gravity-trial-diagnostics-20260917} & \texttt{7f4b068} & Included current-attempt diagnostics and verified records. \\
|
|
\nolinkurl{research/gravity-direction-diagnostics-20260917} & \texttt{47775a9} & Included relift accounting before descent rejection. \\
|
|
\nolinkurl{research/preconditioner-benchmarks-20260918} & \texttt{dc1da62} & Included benchmark methodology, implementation, and results. \\
|
|
\nolinkurl{research/gravity-consistent-schur-20260918} & \texttt{c10d019} & Included fixed-work mass-consistent gravity Schur policy/tests. \\
|
|
\nolinkurl{research/preconditioner-cached-cross-actions-20260918} & \texttt{07769e7} & Included reuse of prepared gravity force in cross preconditioning. \\
|
|
\nolinkurl{research/coupled-shape-coarse-20260918} & \texttt{4a6c1b5} & Included optional frozen coarse experiment and tests; not default. \\
|
|
\nolinkurl{research/nonlinear-step-obstruction-20260918} & \texttt{2944dd5} & Included nonlinear path, direction, and remainder diagnostics. \\
|
|
\nolinkurl{research/coupled-trial-correction-20260918} & \texttt{46249d0} & Included bounded coupled correction and measured limitations. \\
|
|
\nolinkurl{research/damped-coupled-trial-20260918} & \texttt{db854c0} & Included bounded damping/eligibility controls; no default promotion. \\
|
|
\nolinkurl{research/shape-field-weak-response-20260918} & \texttt{6ceda61} & Included weak-response study, preserving Q3 baseline. \\
|
|
\nolinkurl{research/shape-field-displacement-q4-20260918} & \texttt{785a7ae} & Q4 source change excluded; final negative report/comparison tools included. \\
|
|
\nolinkurl{research/reduced-smooth-surface-20260918} & \texttt{2171b8b} & Included frozen reduced-space study and provenance audit. \\
|
|
\nolinkurl{research/spherical-harmonic-surface-20260919} & \texttt{1148c09} & Included native coupled harmonic prescription and metrics. \\
|
|
\nolinkurl{research/negative-density-diagnosis-20260919} & \texttt{7ed4d23} & Included localization, independent projection, and interval evidence. \\
|
|
\nolinkurl{research/density-order-study-20260919} & \texttt{ef76e0c} & Included independent order configuration/closure quadrature and study. \\
|
|
\nolinkurl{research/log-density-assessment-20260919} & \texttt{90580b2} & Imported as deferred assessment/reference script through b1fe359; no FEM change. \\
|
|
\nolinkurl{research/linear-coupling-study-20260919} & \texttt{0e6688f} & Included frozen surface/scalar Schur and unbordered adapter tests. \\
|
|
\nolinkurl{research/model-slices-20260919} & \texttt{5da3f42} & Included physical slice exporter, plots, bounds fixes, and tests. \\
|
|
\nolinkurl{research/n3-compatible-family-20260919} & \texttt{1d746b0} & Included explicit mass-compatible physical-family control. \\
|
|
\nolinkurl{research/n3-linear-ablation-20260919} & \texttt{e78af98} & Included predeclared matched gravity-only n3 comparison. \\
|
|
\nolinkurl{research/gravity-coupling-ablation-20260919} & \texttt{38c7184} & Included gravity-only attribution for rotating higher-index state. \\
|
|
\nolinkurl{research/n3-live-field-feedback-20260919} & \texttt{1ed03f5} & Included matched live field-feedback control. \\
|
|
\nolinkurl{research/coupled-convergence-study-20260919} & \texttt{d7acb0d} & Cumulative numerical baseline for consolidation. \\
|
|
\nolinkurl{integration/research-consolidation-20260920} & \texttt{b1fe359} & Consolidation source checkpoint: preserved formatting and imported assessment; reports follow. \\
|
|
\end{longtable}
|
|
|
|
Several apparently unmerged commits are only isolated-branch registration
|
|
changes. Commits \texttt{4a6c1b5}, \texttt{e599900}, \texttt{2c64a92},
|
|
\texttt{5952691}, and \texttt{a773c9a} add test or module registrations
|
|
already present in the cumulative CMake and module exports. Reapplying them
|
|
would add no capability. Similarly, the surface/scalar Schur implementation
|
|
from \texttt{1d95602} is included as \texttt{2398118}, and the initial slice
|
|
implementation from \texttt{966a4d4} is included as \texttt{9bac57a}.
|
|
Final topic and integration source were compared directly where patch IDs
|
|
differed. These are documented equivalences, not assumed equivalences from
|
|
similar commit titles.
|
|
|
|
\subsection{Adoption, retention, and exclusion rationale}
|
|
|
|
\paragraph{Adopted infrastructure.}
|
|
The consolidation retains the optimized prepared-operator baseline,
|
|
reference-table and mapping caches, linear true-residual safeguards,
|
|
checked operator/strategy interfaces, cache-aware preconditioner cross
|
|
actions, consistent gravity Schur option, native harmonic surface,
|
|
independent density-order configuration and corrected closure quadrature,
|
|
transactional continuation, physical slice output, and artifact auditors.
|
|
These are reusable capabilities with explicit contracts. In particular,
|
|
the pre-existing performance work in \texttt{80cc3d8} predates many of the
|
|
numerical experiments; the large diff from former main must not be
|
|
attributed entirely to the later investigations.
|
|
|
|
\paragraph{Retained as experiments.}
|
|
Polynomial admissibility/repair, gravity elimination, auxiliary curvature
|
|
paths, coupled/damped trial corrections, and coarse surface inverses remain
|
|
available for controlled comparison. Their type-level integration and tests
|
|
are useful even when a particular campaign did not justify default
|
|
promotion. The current user preference is to improve broad convergence
|
|
without forcing density positivity. The baseline path therefore remains
|
|
unchanged, and the newly imported log-density document is historical
|
|
analysis, not an active implementation direction.
|
|
|
|
\paragraph{Not adopted as active numerical behavior.}
|
|
The Q4 displacement change is excluded because the controlled trial did not
|
|
supply a convergence improvement warranting the changed approximation and
|
|
cost. Its report and analysis tools are retained with Q3 active. The early
|
|
one-way material-to-gravity completion is also excluded from the current
|
|
driver. At the matched $n=3$, $J=0$ seed with restart160 and cap200, it changed
|
|
the true relative defect from $0.0402590$ to $0.0381781$, while both solves
|
|
failed their $0.03$ gate and solve time rose from $98.915$ to $117.712$ s.
|
|
The correction norm grew from $0.757644$ to $1.540825$ and the sampled
|
|
thermodynamic step limit decreased from $0.152435$ to $0.0913461$.
|
|
That counterexample concerns one particular triangular composition; it does
|
|
not invalidate later two-way LDU with a stronger gravity approximation.
|
|
|
|
\paragraph{Not implemented.}
|
|
A coupled trust region or regularized step, exact local DG density-mass
|
|
inverse, stronger H1 enthalpy-mass inverse, EOS-aware field Schur inverse,
|
|
and projected surface-equipotential equation are proposals, not completed
|
|
solver features. Changing the physical $n=3$ family or calibrating a
|
|
critical-rotation fraction is likewise distinct from improving an inverse.
|
|
No consolidation wording should turn these recommendations into results.
|
|
|
|
\subsection{A practical contract map for the rewrite}
|
|
\label{sec:rewrite-contracts}
|
|
|
|
The rewrite need not reproduce every experimental wrapper. It should
|
|
reproduce the boundaries that made comparisons meaningful: explicit
|
|
physical requirements, coordinates whose transformations are known,
|
|
prepared operators whose validity is checkable, and a solver that reports
|
|
what actually happened. The following contracts separate implementation
|
|
responsibility from current algorithm choices. Source paths identify useful
|
|
reference implementations, not a requirement to preserve every class name.
|
|
|
|
\begin{longtable}{p{0.20\linewidth}p{0.72\linewidth}}
|
|
\hline
|
|
System & Contract to preserve and initial verification \\
|
|
\hline
|
|
\endfirsthead
|
|
\hline
|
|
System & Contract to preserve and initial verification \\
|
|
\hline
|
|
\endhead
|
|
\hline
|
|
\endfoot
|
|
EOS & Declare relations by input/output quantities and derivative support.
|
|
An operator asks for the relation it needs rather than assuming every EOS
|
|
has density-from-enthalpy. Type checks cover relation availability and
|
|
units; evaluation checks cover finite inputs and the actual physical domain.
|
|
Keep EOS variable choice separate from whether a field is independent.
|
|
Verify derivatives on their valid domain and relation consistency for the
|
|
polytrope. References: \nolinkurl{interface/eos/} and
|
|
\nolinkurl{interface/material/thermodynamic_equations.cppm}. \\
|
|
Domain/support & Identify stellar, vacuum, interface, and outer-boundary
|
|
support independently of coordinate storage. Density exists on stellar
|
|
support; its zero exterior is not a vacuum density unknown. Generate
|
|
restrictions/embeddings from support ownership, including shared trace DOFs.
|
|
Verify coverage, no duplicated ownership, and interface consistency.
|
|
References: \nolinkurl{interface/utils/domain.cppm},
|
|
\nolinkurl{interface/field/field_mfem.cppm}, and the deformation ownership layer. \\
|
|
Fields and blocks & Let typed field quantities carry approximation family,
|
|
order, support, and units; let blocks distinguish value coordinates from
|
|
residual duals. Generate layouts and equation contributions from these
|
|
roles. Do not identify blocks only by historical numeric offsets or assume
|
|
every field pair has equal dimensions. Verify rectangular coupling,
|
|
restriction/injection identities, and generated specification borders.
|
|
References: \nolinkurl{interface/field/}, \nolinkurl{interface/utils/blocks.cppm},
|
|
and \nolinkurl{interface/operators/root_manifest.cppm}. \\
|
|
Quadrature & A form query declares the term, role, trial/test/coefficient
|
|
orders, support, and mapping context. Runtime policy resolves actual
|
|
rules and records them. A nonlinear EOS or curved map cannot be made
|
|
polynomial merely by an order formula. Keep production, preconditioner,
|
|
projection, and diagnostic roles distinct. Verify closure mass/source
|
|
coverage and compare diagnostic rules independently. References:
|
|
\nolinkurl{interface/quadrature/} and field form descriptors. \\
|
|
Mapping & Consume mesh geometry, displacement data, and exterior-map
|
|
policy; return physical coordinates, full map Jacobian/inverse/determinant,
|
|
measures, normals, and coherent directional variations. Implement scalar
|
|
pullback and H(div) Piola transformations consistently with the same map.
|
|
Mapping must not depend on spherical harmonics. Verify identity/affine
|
|
maps, transformation round trips, face orientation, flux/divergence
|
|
identities, and finite-difference variations before caching. References:
|
|
\nolinkurl{interface/mapping/} and \nolinkurl{impl/mapping/}. \\
|
|
Deformation & Compose a surface prescription with independent interior
|
|
and vacuum extensions. Supply displacement, tangent, transpose pullback,
|
|
and derivative of the pullback. A harmonic parameter basis and a nodal
|
|
basis should produce equal physical residual/Jacobian actions when they
|
|
represent the same displacement. Check trace continuity, adjoint identities,
|
|
mode rank, ownership, and stale mesh generations. References:
|
|
\nolinkurl{interface/deformation/} and
|
|
\nolinkurl{interface/equilibrium/stellar_discretization.cppm}. \\
|
|
Physical operator & Separate mathematical residual/Jacobian actions from
|
|
preparation and caching. Cache by the complete set of dependencies,
|
|
including geometry, density, enthalpy, gravity, rotation, and relevant
|
|
specifications. Use the same discrete equations and rules for residual and
|
|
linearization. Verify isolated blocks, cross derivatives, and the full
|
|
coupled directional derivative; include physical boundary row replacement.
|
|
References: \nolinkurl{interface/operators/} and \nolinkurl{impl/operators/}. \\
|
|
Normalization & Keep explicit maps for state coordinates and residual
|
|
duals. Derive physical scales from declared reference quantities and
|
|
Gram factors from a documented geometry/basis. Every normalized Jacobian,
|
|
inverse, restriction, and diagnostic must use the corresponding maps.
|
|
Verify round trips, physical/normalized action equivalence, and pullback
|
|
metric consistency, including harmonic coefficients. References:
|
|
\nolinkurl{interface/normalization/}. \\
|
|
Preconditioner & Separate an owning unbound recipe from its prepared,
|
|
problem-bound inverse. State linear/stationary application guarantees in
|
|
the type contract where possible; check dimensions and generations at
|
|
runtime. Distinguish unbordered field approximation from generated scalar
|
|
completion. Measure setup, refresh, actions, fresh true defect, and complete
|
|
nonlinear cost. References: \nolinkurl{interface/preconditioning/} and the
|
|
experiment recipe \nolinkurl{experiments/plateau_newton_preconditioner.hpp}. \\
|
|
Solver & Keep accepted state authoritative. Trial preparation, evaluation,
|
|
optional correction, acceptance, commit, and rollback form a transaction.
|
|
Invalidate stale caches/guesses explicitly. A backend recurrence residual
|
|
is not the full-system true residual; a reduced solve report must retain
|
|
its coordinate-space identity. Report failure stages, update budgets,
|
|
step lengths, all attempted work, and actual stopping thresholds.
|
|
References: \nolinkurl{interface/solver/}. \\
|
|
Validation and output & Preserve input/source/mesh hashes and actual
|
|
commands; separate numerical convergence, artifact integrity, and physical
|
|
acceptance. Evaluate both pressure routes, both virial forms, mass/angular
|
|
momentum, EOS, hydrostatic/Bernoulli observations, and resolution trends.
|
|
Slices show the actual deformed star with signed fields and explicitly
|
|
label unconverged states. References: \nolinkurl{experiments/} auditors,
|
|
physical diagnostics, and slice exporter. \\
|
|
\end{longtable}
|
|
|
|
In the source references inside this table, \nolinkurl{interface/} and
|
|
\nolinkurl{impl/} are relative to \nolinkurl{libmeanfield/}. The table describes
|
|
contracts to retain; a proposed verification is not a statement that every
|
|
possible backend, EOS, geometry, or MPI configuration has already passed it.
|
|
|
|
\subsubsection{Mapping before deformation-specific optimization}
|
|
|
|
Given the systems already implemented in the rewrite---EOS, domains,
|
|
fields/blocks, and quadrature configuration---mapping is a natural next
|
|
foundation. Write it in terms of the complete element-to-physical map
|
|
$\boldsymbol x=\mathcal T(\boldsymbol\xi;\boldsymbol a)$, with
|
|
$J=\partial\mathcal T/\partial\boldsymbol\xi$ and determinant $j$.
|
|
The ownership of each map factor must be explicit: reference element,
|
|
computational mesh, displacement, and exterior compactification must each
|
|
be applied exactly once. The current slice exporter specifically avoids
|
|
applying displacement a second time when evaluating the physical model.
|
|
For the orientation convention under which the map is admissible, the
|
|
standard transformations include
|
|
\begin{equation}
|
|
\nabla_x u = J^{-T}\nabla_\xi\widehat u,
|
|
\qquad
|
|
\boldsymbol v_x = j^{-1}J\widehat{\boldsymbol v},
|
|
\qquad
|
|
\nabla_x\!\cdot\boldsymbol v_x
|
|
= j^{-1}\nabla_\xi\!\cdot\widehat{\boldsymbol v}.
|
|
\end{equation}
|
|
Measures and oriented face transforms must use the same determinant and
|
|
orientation convention. The rewrite should make this convention explicit
|
|
rather than mix absolute integration weights with signed Piola factors.
|
|
Useful derivative identities are
|
|
\begin{equation}
|
|
\delta J^{-1}=-J^{-1}(\delta J)J^{-1},
|
|
\qquad
|
|
\delta j=j\,\operatorname{tr}(J^{-1}\delta J).
|
|
\end{equation}
|
|
These identities are small, independently testable building blocks for the
|
|
shape derivatives of mass, gravity, pressure, and surface force. They are
|
|
not a replacement for checking the derivative of the fully composed map.
|
|
|
|
The surface prescription should sit above this layer and supply a
|
|
consistent displacement and its variations. It is then possible to change
|
|
nodal parameters to harmonics, or change an extension, without rebuilding
|
|
the meaning of every physical operator. A reference metric for harmonic
|
|
normalization likewise belongs to the parameter-to-trace map, not to an
|
|
arbitrary interior displacement norm.
|
|
|
|
Cache only after these contracts are established. The present mapper caches
|
|
computational-mesh geometry separately from current displacement and
|
|
compactification state. Mesh/node sequence changes invalidate cached mesh
|
|
data; raw coordinate edits require the appropriate mesh-update signal or
|
|
explicit clearing. Mesh lifetimes and thread ownership are part of this
|
|
contract. Reusing a pointer or a quadrature index is not enough to prove
|
|
that a prepared value is current.
|
|
|
|
\subsubsection{Normalization and inverse composition}
|
|
|
|
Let $D_x$ map physical state coordinates to normalized coordinates and
|
|
$D_F$ map physical residual duals to normalized residuals. With these maps
|
|
fixed during a linearization,
|
|
\begin{equation}
|
|
\widehat x=D_x x,\qquad
|
|
\widehat F(\widehat x)=D_F F(D_x^{-1}\widehat x),\qquad
|
|
\widehat J=D_F J D_x^{-1}.
|
|
\end{equation}
|
|
A physical inverse approximation $B$ correspondingly acts as
|
|
\begin{equation}
|
|
\widehat B=D_x B D_F^{-1}.
|
|
\end{equation}
|
|
This explicit distinction prevents using the state scaling on residuals or
|
|
accidentally applying a scalar-border completion twice inside a coarse
|
|
Schur construction. If a future normalization changes with state, its
|
|
lifecycle and any derivative interpretation need separate definition; the
|
|
current fixed reference normalization should not be silently replaced by
|
|
such a scheme.
|
|
|
|
For a nonlinear surface map $\boldsymbol u=E(\boldsymbol a)$ and physical
|
|
force dual $\boldsymbol f$, the parameter residual contains
|
|
$E'(\boldsymbol a)^T\boldsymbol f$. Its directional derivative contains
|
|
both the pullback of $\delta\boldsymbol f$ and
|
|
$\delta[E'(\boldsymbol a)^T]\boldsymbol f$. The latter vanishes for a
|
|
fixed linear parameterization but cannot be omitted from the general
|
|
prescription contract. This is one reason the existing deformation
|
|
interface exposes a pullback derivative separately from a forward
|
|
Jacobian action.
|
|
|
|
\subsubsection{Acceptance and evidence should remain separate}
|
|
|
|
The rewrite should report at least three distinct outcomes: whether a
|
|
linear equation met its true-residual target, whether the nonlinear
|
|
iteration met its stated stopping criterion, and whether the model met
|
|
physical validation requirements. A campaign artifact can be internally
|
|
consistent while recording failure of any of these. A single passing
|
|
virial number is not sufficient when the energy and force forms, or the
|
|
enthalpy- and density-based pressure routes, disagree. The current target
|
|
remains a well-resolved, physically credible, rotating $n=3$ model with
|
|
virial balance within $10^{-5}$; the consolidated code does not yet claim
|
|
that milestone or a calibrated 50-percent-critical rotation rate.
|
|
|
|
\section{Evidence organization and reproducibility after consolidation}
|
|
|
|
The consolidation preserved rather than deleted the accumulated working
|
|
results. Seventy-one explicitly inventoried moves relocated 6,228 regular
|
|
files containing 12,468,217,917 bytes. Every regular file was hashed before
|
|
and after its move; symbolic links and directory structure were also compared.
|
|
The complete inventory is \nolinkurl{reports/archive/move_manifest.json}, with
|
|
the original plan and organizing script preserved beside it. The verifier
|
|
\nolinkurl{reports/verify_archive.py} can recheck the archived contents on this
|
|
machine or against a supplied repository location after transfer.
|
|
|
|
The principal directory layout is:
|
|
\begin{verbatim}
|
|
reports/
|
|
MeanField_research_handoff_2026-09-20.tex
|
|
MeanField_research_handoff_2026-09-20.md
|
|
MeanField_research_handoff_2026-09-20.pdf
|
|
branch_consolidation.md
|
|
figures/ selected versioned scientific figures
|
|
sources/ original audits copied without modification
|
|
prior/ earlier optimization report and README
|
|
archive/ inventories, provenance, historical experiments
|
|
working/
|
|
research/diagnostics/ complete September research campaigns
|
|
legacy_results/ earlier result directories and loose tables
|
|
legacy_misc/ ZIPs, patches, scripts, old test output
|
|
legacy_documents/ originals of earlier report files
|
|
report_builds/ LaTeX intermediates and rendering checks
|
|
consolidation_2026-09-20/ current validation records
|
|
\end{verbatim}
|
|
|
|
The raw working tree is ignored by Git, except its directory guide. This is a
|
|
storage policy, not evidence deletion: the complete raw files remain local,
|
|
including old binaries and unsuccessful trials. The smaller source, reports,
|
|
selected figures, case manifests, audit code and relocation inventory are
|
|
versioned. A recipient needs an explicit copy of \nolinkurl{working/} to rerun
|
|
saved-state analyses from this archive; a Git clone alone is insufficient.
|
|
|
|
The original project-workspace \nolinkurl{diagnostics} directory is now a symbolic
|
|
link to \nolinkurl{working/research/diagnostics/} in the main repository. Thus the
|
|
absolute paths already recorded in case manifests and provenance continue to
|
|
resolve on this machine. Original provenance was not rewritten. When moving
|
|
the archive to another machine, produce a new execution manifest with rebased
|
|
paths and retain the original manifest as provenance.
|
|
|
|
Existing CMake build trees were intentionally left at their original paths:
|
|
their caches and C++ module artifacts contain absolute source/build identities.
|
|
They are now ignored by Git and documented as local caches. Validation used
|
|
the isolated research worktree's rebuilt binaries; retained binaries in the
|
|
original checkout can be stale and must be rebuilt before use. Moving them would
|
|
create an avoidable rebuild or stale-cache ambiguity. Research worktrees and
|
|
branch references are retained. Local IDE and tool configuration remains in
|
|
place. No synced file under the ChatGPT project's \nolinkurl{sources/} directory
|
|
was modified or relocated.
|
|
|
|
The only originally uncommitted tracked source change was quadrature
|
|
declaration formatting. Its exact patch is archived and its content is in
|
|
commit \texttt{6950dc6}. The original checkout's edit is also retained in a
|
|
named Git stash when that checkout is switched to main. The consolidated
|
|
source already contains the edit, so replaying the stash on main is neither
|
|
necessary nor advised.
|
|
|
|
\subsection{Rebuilding and reproducing results}
|
|
|
|
The compiled implementation requires a C++23 compiler with module support,
|
|
CMake, Ninja, MPI, MFEM and the other dependencies identified by
|
|
\nolinkurl{CMakeLists.txt}. The checked local build uses Homebrew LLVM rather than
|
|
Apple's default compiler, Release mode, interprocedural optimization, density
|
|
order two and zero uniform order increment. Exact compiler/dependency paths
|
|
remain in campaign provenance and the consolidation build record. A fresh
|
|
build must be configured for its own source checkout; reusing a different
|
|
checkout's CMake cache is not a valid shortcut.
|
|
|
|
The experiment entry point is \nolinkurl{experiments/run_plateau_campaign.py}.
|
|
Its arguments specify source, build, mesh, case manifest and a new output
|
|
directory. It requires committed tracked source and refuses to overwrite an
|
|
existing campaign directory. It copies the executable, records exact
|
|
commands and input hashes, and runs cases serially. Case manifests state
|
|
surface choice, constraint selection, tolerances, iteration budgets and
|
|
preconditioner/trial policy. Starting the bare diagnostic executable without
|
|
those options does not reproduce the preferred harmonic configuration.
|
|
|
|
The reference recipes include
|
|
\nolinkurl{experiments/spherical_harmonic_surface_cases_2026-09-19.json},
|
|
\nolinkurl{experiments/convergence_linear_cases_2026-09-19.json},
|
|
\nolinkurl{experiments/convergence_linear_followup_cases_2026-09-19.json},
|
|
\nolinkurl{experiments/convergence_screen_cases_2026-09-19.json}, and
|
|
\nolinkurl{experiments/n3_compatible_family_cases_2026-09-19.json}.
|
|
The last file specifies a compatible physical control, not an interchangeable
|
|
numerical tuning of the original $n=3$ model. Follow the saved-state chains
|
|
and their exact coordinate metadata rather than manually transplanting a
|
|
vector between discretizations.
|
|
|
|
Saved campaign artifacts can be checked with the study-specific auditors
|
|
before any new solve. The final combined study uses
|
|
\nolinkurl{experiments/summarize_coupled_convergence.py}; earlier studies have
|
|
separate pressure, coupled-trial, density-order and harmonic auditors with
|
|
their own schemas. A checker should not be used on another schema merely
|
|
because the files have similar names.
|
|
|
|
For visual output, use \nolinkurl{experiments/MODEL_SLICES.md}. Export physical
|
|
planes at the same saved state with two subdivision counts before interpreting
|
|
small surface features. The existing comparison and convergence plot helpers
|
|
require a fresh output path outside their active source checkout; render in
|
|
external staging and then archive the outputs under \nolinkurl{working/} with
|
|
their sidecars. This consolidation preserves that output guard. The report
|
|
builder is separate and deliberately writes its intermediates under
|
|
\nolinkurl{working/report_builds/research_handoff/}.
|
|
|
|
To regenerate the delivered report, run
|
|
\begin{verbatim}
|
|
python3 reports/build_report.py
|
|
\end{verbatim}
|
|
The script invokes Pandoc directly on the authoritative LaTeX source to
|
|
produce GitHub-flavored Markdown, then compiles the PDF with \texttt{latexmk}.
|
|
It records tool commands, exit status, source/output hashes and build time.
|
|
\texttt{--markdown-only} does not require a TeX installation. The Markdown
|
|
is generated, not separately edited. A narrowly scoped Pandoc filter removes
|
|
only a repeated first table-body row identical to the heading; explicit norm
|
|
and absolute-value delimiters avoid collision with Markdown table separators. Figure copies are bound to their
|
|
original archived sources through \nolinkurl{reports/archive/figure_sources.json}.
|
|
|
|
\section{Consolidation validation on 20 September}
|
|
|
|
The integration was validated in the existing isolated research worktree,
|
|
using the numerical source checkpoint \texttt{b1fe359}. Its active numerical
|
|
implementation differs from \texttt{d7acb0d} only by the preserved user
|
|
quadrature declaration formatting; the additional log-density files are
|
|
offline reference work. Documentation and archival changes are recorded in
|
|
the final delivery tag. A 474-file source/fixture SHA-256 inventory binds the
|
|
checks to their actual inputs and is verified against the original checkout
|
|
after integration. This section describes new consolidation checks, separately
|
|
from the earlier study validations reported above.
|
|
|
|
The Release build completed successfully for the main regression executable,
|
|
sandbox, plateau diagnostic, density-order contracts, continuation contracts,
|
|
surface/scalar Schur contracts and MPI test executable. Building the MPI test
|
|
executable is not an execution of the distributed test suite. The checks below
|
|
ran serially with the recorded local MPI shared-memory configuration; no new
|
|
distributed harmonic-solver claim is made.
|
|
|
|
\begingroup
|
|
\small
|
|
\setlength{\tabcolsep}{3pt}
|
|
\begin{longtable}{@{}p{62mm}p{60mm}p{22mm}@{}}
|
|
Check & Recorded result & Seconds \\
|
|
\hline
|
|
\endfirsthead
|
|
Check & Recorded result & Seconds \\
|
|
\hline
|
|
\endhead
|
|
\nolinkurl{mapping_surface_normalization} & 150 cases; 7,224,720 assertions & 794.18 \\
|
|
\nolinkurl{coupled_solver_preconditioner} & 118 cases; 1,369,031 assertions & 1432.04 \\
|
|
\nolinkurl{density_order_contract_tests} & 52 cases; 722,405 assertions & 199.70 \\
|
|
\nolinkurl{continuation_contract_tests} & 8 cases; 515 assertions & 610.43 \\
|
|
\nolinkurl{surface_border_schur_contract_tests} & 9 cases; 70 assertions & 0.44 \\
|
|
\nolinkurl{python_regressions} & 146 tests; 2 initially skipped & 12.32 \\
|
|
\nolinkurl{coupled_artifact_auditor_selftests} & 11 tests & 0.09 \\
|
|
\nolinkurl{slice_geometry_build} & completed & 0.88 \\
|
|
\nolinkurl{slice_geometry} & completed & 0.25 \\
|
|
\nolinkurl{n3_mass_compatibility} & completed & 0.93 \\
|
|
\nolinkurl{n1_harmonic_smoke} & completed & 210.08 \\
|
|
\nolinkurl{plot_render_contracts} & 2 tests & 11.04 \\
|
|
\end{longtable}
|
|
\endgroup
|
|
|
|
The selected C++ checks account for 337 test-case executions and 9,316,741 assertions; the Python checks account for 157 tests. The 2 plot-render checks initially skipped by their environment gate were subsequently enabled and passed in the separate serial rendering check. The Python total counts executed tests, excluding the initial skips. These are executions, not a count of distinct cases across overlapping tag selections. Large assertion counts include array-element comparisons and do not indicate an equivalent number of independent scientific tests. The full unrelated regression suite was not run.
|
|
|
|
\subsection{Fresh physical smoke model}
|
|
|
|
The smoke case repeated the native all-$m$, $L=4$, $n=1,J=0$ control with no
|
|
central-density constraint, restart 160, linear cap 200, true linear target
|
|
0.03, and a six-update budget. The nonlinear relative target was $10^{-8}$
|
|
with zero absolute tolerance. It also exported physical model slices at four
|
|
display subdivisions. This is a baseline regression check, not another
|
|
high-index investigation or a claim about the unresolved rotating target.
|
|
|
|
The model converged in 5 accepted updates. Its final normalized residual was $1.5271452\times10^{-12}$. The four q18 absolute virials, in order energy/force from enthalpy pressure and energy/force from density pressure, were $3.8703561\times10^{-7}$, $2.6593819\times10^{-7}$, $4.2699365\times10^{-7}$, $3.0589623\times10^{-7}$. All four also passed $10^{-5}$ at q14. The result reproduces the modest baseline capability; it does not resolve the rotating $n=3$ deficit.
|
|
|
|
\subsection{Artifact and document checks}
|
|
|
|
All 6,228 relocated files were independently rechecked against their original
|
|
content hashes with no mismatch. The report compiled to PDF and was converted
|
|
from its authoritative LaTeX source with Pandoc. Conversion checks compared
|
|
table cells, mathematical expressions, paths and figure captions, and verified
|
|
the contents links. Repeated PDF table headings are removed from Markdown
|
|
without removing data rows. PDF pages were rendered and inspected for table
|
|
width, equation clipping, figure labels and page layout.
|
|
|
|
The full validation commands, durations, logs, source/fixture inventory and
|
|
smoke artifacts are preserved under
|
|
\nolinkurl{working/consolidation_2026-09-20/validation/}.
|
|
Compact versioned copies of the build record, validation results and source
|
|
inventory are in \nolinkurl{reports/validation/}. This provides both a readable
|
|
handoff and a record that can be checked independently. Successful build,
|
|
regression and artifact checks do not upgrade any unconverged historical model
|
|
to a physical success.
|
|
|
|
\appendix
|
|
\section{Versioned study-report catalog}
|
|
|
|
The following reports preserve the detailed methods and original interpretation. Their source filenames are repository-relative; raw campaign locations are recorded within the reports and in the archive index.
|
|
|
|
\begin{longtable}{@{}p{156mm}@{}}
|
|
|
|
\nolinkurl{experiments/CENTRAL_CONSTRAINT_HYPOTHESIS_2026-09-16.md} \\
|
|
|
|
\nolinkurl{experiments/COUPLED_CONVERGENCE_STUDY_2026-09-19.md} \\
|
|
|
|
\nolinkurl{experiments/COUPLED_TRIAL_CORRECTION_2026-09-18.md} \\
|
|
|
|
\nolinkurl{experiments/DAMPED_COUPLED_TRIAL_2026-09-18.md} \\
|
|
|
|
\nolinkurl{experiments/DENSITY_ORDER_STUDY_2026-09-19.md} \\
|
|
|
|
\nolinkurl{experiments/FIELD_COUPLING_REVIEW_2026-09-19.md} \\
|
|
|
|
\nolinkurl{experiments/GEOMETRY_QUALITY_EXPERIMENT.md} \\
|
|
|
|
\nolinkurl{experiments/GEOMETRY_QUALITY_FINDINGS_2026-09-08.md} \\
|
|
|
|
\nolinkurl{experiments/GRAVITY_COMPACT_APPLICATIONS_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/GRAVITY_CONSISTENT_SCHUR_2026-09-18.md} \\
|
|
|
|
\nolinkurl{experiments/GRAVITY_DIRECTION_DIAGNOSTICS_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/GRAVITY_PREPARED_ROUNDOFF_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/GRAVITY_REDUCTION_IMPLEMENTATION_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/GRAVITY_SUBSYSTEM_IMPLEMENTATION_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/KRYLOV_HYPOTHESIS_2026-09-16.md} \\
|
|
|
|
\nolinkurl{experiments/KRYLOV_WINDOW_HYPOTHESIS_2026-09-16.md} \\
|
|
|
|
\nolinkurl{experiments/LOG_DENSITY_ASSESSMENT_2026-09-19.md} \\
|
|
|
|
\nolinkurl{experiments/MODEL_SLICES.md} \\
|
|
|
|
\nolinkurl{experiments/N3_COMPATIBLE_FAMILY_2026-09-19.md} \\
|
|
|
|
\nolinkurl{experiments/NEGATIVE_DENSITY_INVESTIGATION_2026-09-19.md} \\
|
|
|
|
\nolinkurl{experiments/NONLINEAR_STEP_INVESTIGATION_2026-09-18.md} \\
|
|
|
|
\nolinkurl{experiments/NUMERICAL_CAMPAIGN_2026-09-16.md} \\
|
|
|
|
\nolinkurl{experiments/NUMERICAL_STRATEGIES_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/POLYNOMIAL_ENTHALPY_ADMISSIBILITY_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/POLYTROPE_H_CONVERGENCE_2026-09-09.md} \\
|
|
|
|
\nolinkurl{experiments/POLYTROPE_VALIDATION.md} \\
|
|
|
|
\nolinkurl{experiments/POLYTROPE_VALIDATION_FINDINGS_2026-09-09.md} \\
|
|
|
|
\nolinkurl{experiments/PRECONDITIONER_CACHED_CROSS_ACTION_2026-09-18.md} \\
|
|
|
|
\nolinkurl{experiments/PRECONDITIONER_IMPROVEMENT_2026-09-18.md} \\
|
|
|
|
\nolinkurl{experiments/PRESSURE_AND_SHAPE_CAMPAIGN_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/PRESSURE_OBSTRUCTION_METHODOLOGY_2026-09-17.md} \\
|
|
|
|
\nolinkurl{experiments/README.md} \\
|
|
|
|
\nolinkurl{experiments/REDUCED_SURFACE_STUDY_2026-09-18.md} \\
|
|
|
|
\nolinkurl{experiments/SHAPE_FIELD_WEAK_RESPONSE_2026-09-18.md} \\
|
|
|
|
\nolinkurl{experiments/SPHERICAL_HARMONIC_SURFACE_2026-09-19.md} \\
|
|
|
|
\nolinkurl{experiments/SYSTEM_ISOLATION_PROFILE_HARNESS.md} \\
|
|
|
|
\nolinkurl{experiments/check_numerical_strategies_README.md} \\
|
|
|
|
\nolinkurl{experiments/check_plateau_physics_README.md} \\
|
|
|
|
\nolinkurl{experiments/plateau_diagnostic_README.md} \\
|
|
|
|
\nolinkurl{experiments/plateau_shape_curvature_README.md} \\
|
|
|
|
\end{longtable}
|
|
\end{document}
|