DOI: 10.5281/zenodo.16941545
title: Phase Transitions of a Nonlinear Wave Field (Season 1) — Reproducibility Package v2.0.0

description:  

SEASON 1 — Nonlinear Wave Field (reproducibility package)

This dataset accompanies a study of a nonlinear wave field exhibiting two lineshape regimes within a single system:





a low-band regime with Fano-like asymmetry and high-Q characteristics, and




a high-band regime with Lorentz-like symmetrization and a lower Q.



We quantify the competition between Fano and Lorentz via the ΔBIC metric, trace the ΔBIC=0 transition, enforce Kramers–Kronig consistency (minimum-phase reconstruction), and use a censored −3 dB rule together with step↔FRF cross-validation to ensure physically consistent fits.



What’s new in this version (reproducibility update)

This version focuses on making reproduction straightforward and auditable. Core science and numeric results are unchanged; the update aligns packaging, documentation, and integrity checks.





Canonical mapping unified: docs/README_MANUSCRIPT.txt is the single, canonical figure/table map used by the pipeline.




README aligned with actual paths: commands and folders match the archive layout; no external repositories are required.




Minimal environment added: env/requirements.txt (small dependency set) for quick, no-heavy-simulation runs.




Licensing clarified: single LICENSE file covering MIT (code) and CC BY 4.0 (data).




Citation metadata updated: CITATION.cff now includes DOI 10.5281/zenodo.17022054 and the current release date.




Provenance consolidated: a single canonical checksum file provenance/FINAL_manifest_SHA256.txt (duplicates removed/retired).




Convenience bundle: SE1_quick_bundle_ALLINONE.zip is included for one-shot reproduction (paths remain unchanged).





Note: The computational pipeline and figure outputs are the same; the execution interface is clarified (explicit --map in preflight/save), and the archive structure is harmonized to avoid path ambiguity. No heavy simulations are required.




Contents





Inputs: consolidated, ready for the pipeline.




Code: lightweight scripts to reproduce all figures/tables without heavy simulation(BRIDGE_PROVIDED_CSVS.py → PREFLIGHT_CHECK.py → SAVE_WISHLIST_RUNNER.py) plus a one-cell harness.




Per-figure source data: CSVs for all main figures/tables.




Provenance & integrity: canonical SHA-256 manifest and run metadata.




Documentation: top-level README and the canonical figure/table map.





How to reproduce (three steps)





BRIDGE — organize provided CSVs into standard locations.




PREFLIGHT — validate structure and mapping (--map docs/README_MANUSCRIPT.txt).




SAVE — export per-figure sources to outputs/core (or a specified output folder).



The same flow is wrapped by a single-cell harness for convenience. No external repositories are required.



Key findings (scientific highlights)





ΔBIC-based lineshape competition (Fano vs. Lorentz) and mapping of the transition where ΔBIC=0.




Kramers–Kronig consistency checks (minimum-phase amplitude→phase reconstruction).




Censored −3 dB rule for robust Q-reporting in windows lacking clear crossing.




Step↔FRF cross-validation and ablations on weighting, baselines, and windowing.





Integrity & versioning





Checksums: see provenance/FINAL_manifest_SHA256.txt for file-level SHA-256 digests.




Version policy: scientific results are stable; packaging/documentation may evolve to improve clarity and reproducibility.




Reproducibility target: quick, no-heavy-simulation runs on common Linux/Colab environments using the minimal requirements file.





Licensing and citation





Code: MIT License.




Data: CC BY 4.0.




Citation (CFF included): please cite this record: 10.5281/zenodo.17022054.