Unlisted pages¶
This is the landing page for documentation that lives in the repository and builds with the site, but is intentionally absent from the public navigation. These pages are preview, internal, or experimental material: they are reachable by direct URL (and from the links below) but do not appear in the top-of-page nav, so the public table of contents stays focused on the released, supported package.
Optimal experimental design (detail pages)¶
The science-demos section keeps a single
public OED overview. The longer
worked-example detail pages are hidden: true in the toc (built and
URL-reachable, kept out of the public navigation). The OED tooling itself is
planned for a separate package and is not part of v0.1.0; these pages document
the prototyped worked designs:
The OED formalism — Fisher information, the additive backbone, and sky projection — the shared OED formalism: Fisher information, the additive design-linear backbone, the c/D/A optimality criteria, and the sky-projection geometry, built once for the worked examples.
OED for anisotropy — where to spend telescope time on r_a (B14) — Stage 1: allocating a star budget across (radius × {RV, PM}) to pin the Osipkov–Merritt anisotropy radius ; proper motions go to the outskirts ( fewer stars at equal precision).
OED for dynamical mass — how deep to survey (Stage 2) — Stage 2: promoting survey depth (limiting magnitude) to a design variable for the dynamical mass ; the Fisher peaks at an interior optimal depth.
OED for concentration — where to spend telescope time on W₀ (Stage 3) — Stage 1 redux: the same channel-allocation machinery targeting the concentration ; proper motions go to the core (the mirror image of anisotropy).
OED for robustness — when binaries lie to your mass estimate (Stage 4) — Stage 4: a robustness design where a binary-blind survey biases the mass by with false confidence, and a binary-aware design removes it.
Gravoturbulence (experimental, repo-only)¶
The gravoturbulent / fractal-density-field theory documents the experimental
gravoturb subsystem, which is repo-only and not part of the released
wheel (src/experimental/). The section was consolidated 10 → 5 pages; all
five are hidden: true in the toc (built and URL-reachable, kept out of the
public navigation):
Gravoturbulence — section landing: the PDF → FDF → ζ → BM19 → inference chain, reading order, and the experimental banner.
Density PDFs and the freefall-density factor — the Federrath & Klessen (2012) lognormal+power-law density PDF, the freefall-density kernel, the cloud-integrated SFR, and the canonical α↔p mapping.
The magnification factor ζ — three ways to compute it — the magnification factor ζ three ways (analytic Parmentier & Pasquali (2020) ζ(p), cored, direct-3D).
BM19 dense-gas SFR framework — the Burkhart (2018)Burkhart & Mocz (2019) dense-gas SFR forward model.
Differentiable inference — natal cloud parameters from cluster substructure — the differentiable physics-direct inference layer (3-D α recovery + projected β estimator).
Gravoturbulent + PP20 validation — the validation-side companion: the PP20 ζ(p) regression suite + BM19 unit coverage (now backed by the experimental
gravoturbAC suite), and the historical record of the 2026-04-28 transcription-bug fix. Hidden to match the gravoturb theory subsection.
Development log¶
The development log is progenax’s internal development history — dated design
specs, full-package code-review audits, and validation recovery/scaling notes.
The pages are point-in-time snapshots (several reference since-renamed APIs and
carry pointers to the current entry point). The whole section is hidden: true
in the toc (built and URL-reachable, kept out of the public navigation):
Development log — section landing: the curated map of every surviving entry, grouped by code-review audit / design spec / milestone, with pointers to the current package state.
Code reviews — landing record for the 2026-06 post-hardening (A−) and expert-audit (B+) reviews + resolution tables.
Progenax: Comprehensive Code, Architecture & Science Review — the original 2025-12-07 comprehensive review (A, 95/100).
IC redesign spec (2026-02-12) — the protocol-based, composable, differentiable IC architecture design spec.
progenax Phase 1 - COMPLETE — the 2025-12-06 Phase 1 completion snapshot.
IMF Stack Fix Implementation Plan — the IMF-stack correction plan (Chabrier log₁₀, gradient + domain fixes).
IMF HMC Recovery — Proposal Figure — the IMF-only NUTS α₃ slope-recovery proposal figure.
Binary-Aware IMF Recovery via NUTS — the binary-aware IMF recovery spec (Moe+17 mixture likelihood).
Binary-Aware IMF Recovery — Implementation Plan — the matching task-by-task implementation plan.
Precision Scaling Panel (d) Implementation Plan — the σ(α)-vs-N precision-scaling panel.
PP20 ζ(p) transcription fix — the PP20 ζ(p) transcription-bug fix (superseded by the
gravoturbrewrite).
- Federrath, C., & Klessen, R. S. (2012). The star formation rate of turbulent magnetized clouds. The Astrophysical Journal, 761, 156. 10.1088/0004-637X/761/2/156
- Parmentier, G., & Pasquali, A. (2020). A new parameterization of the star formation rate–dense gas mass relation: Embracing gas density gradients. The Astrophysical Journal, 903, 56. 10.3847/1538-4357/abb8d3
- Burkhart, B. (2018). The Star Formation Rate in the Gravoturbulent Interstellar Medium. The Astrophysical Journal, 863, 118. 10.3847/1538-4357/aad002
- Burkhart, B., & Mocz, P. (2019). The self-gravitating gas fraction and the critical density for star formation. The Astrophysical Journal, 879, 129. 10.3847/1538-4357/ab25ed