zoomy_core.numerics.depth_law_study

zoomy_core.numerics.depth_law_study#

One-call NumericalSystemModel construction over the depth-law axes (regularization path, eps, eigenvalue treatment, wet/dry guard) for parameter sweeps. It measures nothing and asserts no physics; every regularization path uses the Kurganov-Petrova reciprocal kp_hinv.

References

  • Kurganov, Petrova 2007, https://doi.org/10.4310/CMS.2007.v5.n1.a6

Module Contents#

Functions#

iter_axes

Yield one {axis: value} kwargs dict per point of the cartesian product of axes (default AXES), ready for build_nsm.

axis_id

Short stable label of an axis point for test ids and filenames, e.g. "aux-noguard-evexclude".

build_nsm

Build a derived NumericalSystemModel at one point of the depth-law axes.

Data#

PATHS

GUARDS

EIGENVALUE_TREATMENTS

DEFAULT_EPS

AXES

API#

zoomy_core.numerics.depth_law_study.PATHS#

(‘direct’, ‘aux’, ‘legacy’, ‘none’)

zoomy_core.numerics.depth_law_study.GUARDS#

(None, ‘power’, ‘gate’, ‘both’)

zoomy_core.numerics.depth_law_study.EIGENVALUE_TREATMENTS#

(‘regularize’, ‘exclude’)

zoomy_core.numerics.depth_law_study.DEFAULT_EPS#

None

zoomy_core.numerics.depth_law_study.AXES#

None

zoomy_core.numerics.depth_law_study.iter_axes(axes: Optional[dict] = None) → Iterator[dict]#

Yield one {axis: value} kwargs dict per point of the cartesian product of axes (default AXES), ready for build_nsm.

zoomy_core.numerics.depth_law_study.axis_id(combo: dict) → str#

Short stable label of an axis point for test ids and filenames, e.g. "aux-noguard-evexclude".

zoomy_core.numerics.depth_law_study.build_nsm(model: Union[Any, Callable[[], Any]], *, path: str = 'aux', eps: float = DEFAULT_EPS, guard: Optional[str] = None, eigenvalues: str = 'regularize', normalize_normal: bool = True, riemann=None, **nsm_kwargs) → zoomy_core.numerics.numerical_system_model.NumericalSystemModel#

Build a derived NumericalSystemModel at one point of the depth-law axes.

Args

  • model: a Model, a SystemModel or a zero-argument callable returning either; prefer a callable, since the NSM promotes a SystemModel in place.

  • path: "direct" | "aux" | "legacy" | "none" (see PATHS).

  • eps: regularization scale for "direct"/"aux", not wet_dry_eps.

  • guard: None | "power" | "gate" | "both".

  • eigenvalues: "regularize" | "exclude"; ignored by "legacy" and "none".

  • riemann: Riemann class, forwarded verbatim (None keeps the NSM default).

  • **nsm_kwargs: forwarded to NumericalSystemModel.from_system_model.

Returns

The NSM with its operators, spectrum and aux rows final.

Contents