Equation To Code Map¶
This page maps the main model terms in the documentation to the modules that implement and test them. It is intended as a developer and reviewer index: use physics_models.md for the derivation-level description, code_structure.md for package organization, and the pages listed here for validation artifacts.
Core Drift-Reduced Operators¶
| Model term | Implementation | Validation or tests |
|---|---|---|
| Parallel gradient, divergence, and structured metric factors | native/mesh.py, native/metrics.py |
tests/test_native_mesh.py, tests/test_native_metrics.py |
| Density, pressure, and vorticity transport on compact native decks | native/fluid_1d.py, native/transport.py, native/vorticity.py |
Fluid 1D MMS Convergence, tests/test_native_fluid_1d.py, tests/test_native_transport.py, tests/test_native_vorticity.py |
| Elliptic potential/vorticity solve, including the FCI perpendicular polarization inversion | solvax.elliptic (Fourier--Helmholtz operator), native/vorticity.py, native/fci_vorticity.py |
tests/test_native_vorticity.py, Stellarator FCI Validation |
Non-Axisymmetric And 3D Geometry¶
| Model term | Implementation | Validation or tests |
|---|---|---|
| Field-line-following interpolation, metric-weighted operators, and 3D selected-field surfaces | native/fci.py, native/fci_drb_rhs.py |
Stellarator FCI Validation |
| FCI sheath/recycling, neutral, and vorticity closure gates | native/fci_sheath_recycling.py, native/fci_neutral.py, native/fci_vorticity.py |
Stellarator FCI Validation, tests/test_validation_stellarator_fci_campaigns.py |
| Imported field-line and surface geometry adapters | geometry/essos_import.py, geometry/vmec_extender_import.py, validation/essos_imported_fci_campaign.py, validation/vmec_extender_edge_field_campaign.py |
ESSOS Field-Line Import, ESSOS Imported FCI Validation, VMEC Extender Edge Fields |
| 3D movies, posters, profile analysis, and validation-gallery plots | validation/stellarator_sol_showcase.py, validation/essos_imported_drb_movie_campaign.py, validation/diverted_tokamak_movie.py, validation/publication_plotting.py |
ESSOS Imported FCI Validation, Validation Gallery |
Runtime, I/O, And Artifacts¶
| Surface | Implementation | Validation or tests |
|---|---|---|
| TOML/input parsing, precision defaults, output manifests, restart metadata, and live progress estimates | config, runtime, native/deck_runner.py |
Inputs And Outputs, Native Runtime CLI, Restartable Diffusion Tutorial, tests/test_cli_run.py, tests/test_restartable_diffusion_tutorial.py |
| Portable run summaries and array payloads | native/deck_runner.py |
Native Runtime CLI, tests/test_cli_run.py |
| Self-contained examples, release-backed media, and artifact restoration | examples, scripts/fetch_example_artifacts.py |
Examples And Artifacts, tests/docs/examples/test_self_contained_example_smoke.py |
Current Gaps¶
The most important open implementation gaps remain deliberately separated from the validated equations above:
- Multi-device GPU speedup is not a release claim until the device-level identity check, the real-kernel agreement gate, and a committed timing summary all pass.