Edition README
Physics: energy and backreaction
README.md
1 # Komorebi Physics: Energy-Conserving Production
2
3 A finite-depth backreaction study. Research record dated 21 October 2026.
4
5 ## Read first
6
7 **The original cosmological production benchmark is NOT repaired by this package.**
8 The finite dynamical model has an exact energy-conservation theorem and a tested implementation.
9 A separate, conditional Gaussian parameter family preserves a target density without a common
10 occupation rescaling. The finite model fails the attempted depth-independence test, and the
11 parameter family does not remove the residual background reservoir or radiative sensitivity.
12
13 Read `Energy_Conserving_Production.pdf`. It contains the assumptions, ordinary mathematical
14 proofs, worked parameter family, numerical tests, counterexamples, and references. The previous
15 570-page physics book has not been overwritten. This package contains no new Lean certificate.
16
17 ## Main results
18
19 - Original arithmetic reconstructed: raw energy / available crossing energy = 2.6272875374e20.
20 - Inherited audit: 19 checks passed within their original scope.
21 - Finite quantum system: conserved mechanical-plus-mode energy; nonnegative occupations;
22 energy bound and global existence at a fixed finite positive regulator.
23 - Independent complex-oscillator implementation agrees with the real kinetic system.
24 - Principal run: relative sampled energy residual 7.33950678011297e-11.
25 - Study: 17 configurations, including two deliberately incorrect closed-system controls.
26 Eleven gates pass; the attempted physical depth-independence gate fails.
27 - The abundance-preserving parameter family has lambda = eta0 * epsilon^2 and
28 A/mu = (A0/mu0)/sqrt(epsilon). Its nominal Gaussian efficiency epsilon is NOT
29 the measured efficiency of the coupled solver.
30 - A fourth-mass-moment curvature diagnostic remains invariant along that family.
31 It is a power-counting diagnostic, not a scheme-independent lower bound.
32
33 ## Reproduce
34
35 Tested environment: Python 3.13.5, NumPy 2.3.5, SciPy 1.17.0, SymPy 1.14.0.
36 The Python dependencies are external and are not included. `requirements.txt` records
37 versions actually present in the reference runtime. Source runs are otherwise offline.
38
39 From this folder, in PowerShell:
40
41 ```powershell
42 $env:OPENBLAS_NUM_THREADS="1"; $env:OMP_NUM_THREADS="1"; $env:MPLBACKEND="Agg"
43 python code/check_saved_results.py
44 python code/check_saved_results.py --require-physics
45 ```
46
47 The first command should pass. The second deliberately returns **exit code 3**, because
48 the recorded physical-depth test fails. This distinguishes computational reproduction from
49 physical acceptance.
50
51 To recompute the study into its standard output folder:
52
53 ```powershell
54 python code/energy_study.py --full
55 python code/make_outputs.py
56 ```
57
58 `energy_study.py` without `--full` executes only the principal model, symbolic calculations,
59 and independent oscillator comparison. Do not mistake it for the 17-run study. Full runs may
60 take several minutes and are CPU dependent. If execution is interrupted, resume with:
61
62 ```powershell
63 python code/energy_study.py --full --resume
64 ```
65
66 Resume reuses a completed run only when the saved configuration matches and its array exists.
67 The supplied manifest should be checked before trusting existing results. A normal process exit
68 from `energy_study.py` means that the calculation finished, not that all scientific tests passed.
69 Inspect `results/final/verification.json`, or use `check_saved_results.py --require-physics`.
70
71 To rerun the inherited benchmark:
72
73 ```powershell
74 python code/inherited_verification.py --parent-json inputs/frozen_benchmark.json --output results/baseline_rerun --figures results/baseline_rerun/figures
75 ```
76
77 To rebuild the PDF, install an external TeX distribution providing the packages named in
78 `Energy_Conserving_Production.tex`, then run:
79
80 ```powershell
81 pdflatex -interaction=nonstopmode -halt-on-error Energy_Conserving_Production.tex
82 pdflatex -interaction=nonstopmode -halt-on-error Energy_Conserving_Production.tex
83 ```
84
85 No font files are bundled. The package includes final PDF figures, so TeX need not regenerate them.
86
87 ## Files
88
89 `code/energy_study.py`: coupled finite model, independent representation, parameter analysis,
90 symbolic identities, and validation gates.
91
92 `code/inherited_verification.py`: unchanged inherited bridge audit, included for provenance and
93 its discrete momentum integral. Its plots are historical audit outputs, not the new study's figures.
94
95 `code/make_outputs.py`: four research figures and CSV tables generated from the recorded outputs.
96
97 `code/check_saved_results.py`: fast independent inspection of saved energy arrays and acceptance status.
98
99 `results/final/`: JSON records, CSV tables, and all 17 sampled trajectories. The `.npz` files contain
100 sampled background and aggregate energy histories plus final mode variables. They do not claim to
101 store every solver-internal stage or complete intermediate mode covariance matrices.
102
103 `results/baseline_rerun/`: inherited audit rerun. `results/*log`: execution and build records.
104
105 `PROGRESS_LEDGER_v0.1.0.md`: completed work, failed checks, assumptions, and exact restart point.
106
107 `MANIFEST.sha256`: SHA-256 hashes of the distributable files, excluding the manifest itself.
108
109 ## Limitations that travel with the results
110
111 The dynamical runs use modified parameters, not the original lambda = 1 benchmark. They use a
112 local Minkowski approximation, finite tower depth, finite positive momentum quadrature,
113 instantaneous incoming vacuum, and a specified q-dependent zero-point subtraction. The derivative
114 of that subtraction is included in the reaction force. This is a well-defined finite Hamiltonian,
115 not a completed covariant renormalization of the cosmological theory.
116
117 Instantaneous mode energy includes coherent vacuum response. It is not an asymptotic dark-particle
118 yield. Configurations compared at the same final time need not have reached the same field position
119 or completed the same crossing. Depth changes the physical regulated Hamiltonian. A physically
120 specified finite tower need not have depth-independent dynamics, but a regulator-removal claim does.
121 Neither a physical depth nor such a regulator-removal result is derived here.
122
123 ## Licensing
124
125 Original prose, figures, and data: CC BY 4.0. Original software: MIT.
126 See `LICENSE` and `LICENSES/`. External libraries and cited literature retain their own terms.
127
128 The numerical reference A sets the incoming speed; the actual speed at q = 0 is solved, not imposed. Thus the nominal Gaussian depletion parameter is not a measured dynamical efficiency.