r/LLMPhysics • u/Visual_Reply7980 • 2h ago
Personal Theory We built a single-probe damping caliper — validated on 2,867 days of polar vortex data. The CFD edition ships today UNvalidated. Come break it. (AI-assisted, all code/data open, CC BY 4.0)
Disclosure first, so you can skip if it's a dealbreaker: independent researcher (Ma Ka Po) with AI research assistants. The researcher led the physics framing and research direction; agents did structural synthesis, writing and code. We welcome criticism aimed at the method and the measurements — judge the artifact, not the author. Everything below is reproducible from open code (CC BY 4.0).
What it is: DampMeter, a "damping caliper" — from a single scalar time series, measure a system's effective relaxation time τ (γ = 1/τ) near a stable state. One core question: how fast do perturbations die?
How it refuses to guess:
- Four independent estimators — ACF e-fold, distance-correlation e-fold (Székely), impulse-conditioned ring-down R(k) = E[x(t)·x(t+k) | impulse] / E[x(t)² | impulse], post-drop recovery. ≥3 must land within ±30% of the median or τ is not established. Convergence here is an identity check ("the constant is really there"), not a goodness-of-fit score.
- Shuffle-null: after shuffling the series, τ must collapse. If it survives, you caught a monotone trend, not dynamical relaxation.
- Hard sample floor: below 20 points it refuses to output. (2,800-bootstrap characterization: 610 samples → 81.5% hit rate.)
Validated domains: atmospheric polar vortex (2,867 days NCEP reanalysis, τ ≈ 12.3 d, multi-estimator agreement); ECG; bearing vibration.
Why this CFD guide exists — and what is NOT validated: today we shipped a CFD branch hooking OpenFOAM's native probes/forceCoeffs output (zero C++ compilation, no solver changes). Three use-cases: (1) pseudo-convergence fuse — residuals at 1e-5 but sliding-window τ still jumping (CV > 50%) → the flow has not reached a physical steady state, do not stop the run; (2) vortex-shedding envelope decay; (3) grid/scheme dissipation comparison — the mesh whose τ_eff runs abnormally short is drowning your physics in artificial numerical viscosity. We have not run this on a single real CFD case yet — the interface is an engineering extrapolation from atmosphere/physiology validation. That is why the guide opens with applicability limits and failure modes instead of success stories.
The weakest claim, stated plainly: everything CFD-flavored in there is untested in anger.
The ask — run it, break it, tell us where: (1) does the hookup work smoothly on your case? (2) does τ_eff correctly rank numerical dissipation across meshes/schemes? (3) which flow regimes make it fail or produce useless numbers?
Zenodo (ZH + EN + code): https://doi.org/10.5281/zenodo.24440047 — GitHub (cfd branch): https://github.com/MMDR10/dampmeter/tree/cfd — pip install dampmeter (example script + guide live in the repo/Zenodo).
Happy to go deep on the math — Székely distance correlation, Hilbert transform + normalized-MAD envelope extraction, conditional decay R(k) — every formula maps line-by-line to ~300 lines of pure Python.