tboudreaux/MeanField
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document stellar support contract for log density

Browse Source
This commit is contained in:
Emily Boudreaux
2026-09-19 13:05:53 -04:00
parent 9dc752068e
commit b1fe359760
1 changed files with 12 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
experiments/LOG_DENSITY_ASSESSMENT_2026-09-19.md
View File

@@ -288,6 +288,15 @@ The same representation must feed gravity source/force, centrifugal force,
mass, angular momentum, diagnostics and exported profiles. Their dependency mass, angular momentum, diagnostics and exported profiles. Their dependency
generation, quadrature, cache invalidation and normalization must agree. generation, quadrature, cache invalidation and normalization must agree.
The implementation must preserve density's stellar-only support. Physical
density and its directional action must remain identically zero in exterior
and vacuum domains; the positive reconstruction applies only in the material
domain. An inactive log coefficient stored as zero must not be exponentiated
into `rho_scale` outside the star. Domain support must therefore be part of the
representation contract shared by operators, diagnostics and exports. This
intentional exterior vacuum is distinct from underflow inside the material and
from the intended zero trace of a vanishing reference factor at its boundary.
The current registry represents density as an independent scalar L2 field, and The current registry represents density as an independent scalar L2 field, and
the prepared source and force operators read it as a polynomial grid function. the prepared source and force operators read it as a polynomial grid function.
The current field relationship catalog supports independent and differential The current field relationship catalog supports independent and differential
@@ -299,9 +308,9 @@ contracts are in `field_registry.cppm`, `field_base.cppm`,
`normalization/stellar_equilibrium.cppm`, and `normalization/stellar_equilibrium.cppm`, and
`preconditioning/material_surface.cppm`. `preconditioning/material_surface.cppm`.
For the currently intended exact-vacuum polytrope, continue the separately For the currently intended exact-vacuum polytrope, the companion density-only
authorized density-only order study first. Its cost and pointwise-error results order study supplies the polynomial baseline, including cost and pointwise
provide the right baseline. If log density remains attractive, the next bounded error. If log density remains attractive, the next bounded
question is whether a physically justified vanishing reference can provide a question is whether a physically justified vanishing reference can provide a
regular independent coordinate without importing a restrictive EOS assumption. regular independent coordinate without importing a restrictive EOS assumption.
For a genuinely finite-density outer boundary, raw pointwise log density is a For a genuinely finite-density outer boundary, raw pointwise log density is a