empyrean.DiagnosticsConfig

class DiagnosticsConfig(sensitivity=False, nonlinearity=False, lyapunov=False, keyholes=False, bifurcations=False, sample_stride=0, sensitivity_threshold=None, lyapunov_threshold=None, nonlinearity_threshold=None)[source]

Bases: object

Per-trajectory diagnostic outputs (sensitivity, nonlinearity, Lyapunov, keyhole, bifurcation). All metrics off by default.

Methods

__init__([sensitivity, nonlinearity, ...])

Attributes

bifurcations

keyholes

lyapunov

lyapunov_threshold

Emit a ChaoticRegion event when the Lyapunov exponent exceeds this.

nonlinearity

nonlinearity_threshold

Emit a HighNonlinearity event when the metric exceeds this (requires second-order uncertainty propagation).

sample_stride

every Nth integration step.

sensitivity

sensitivity_threshold

Emit a HighSensitivity event when the metric exceeds this.
Parameters:

  • sensitivity (bool)

  • nonlinearity (bool)

  • lyapunov (bool)

  • keyholes (bool)

  • bifurcations (bool)

  • sample_stride (int)

  • sensitivity_threshold (float | None)

  • lyapunov_threshold (float | None)

  • nonlinearity_threshold (float | None)

sensitivity: bool = False
nonlinearity: bool = False
lyapunov: bool = False
keyholes: bool = False
bifurcations: bool = False
sample_stride: int = 0

every Nth integration step. 0 → engine default (1).

Type:

Timeseries sampling stride

sensitivity_threshold: float | None = None

Emit a HighSensitivity event when the metric exceeds this.

lyapunov_threshold: float | None = None

Emit a ChaoticRegion event when the Lyapunov exponent exceeds this.

nonlinearity_threshold: float | None = None

Emit a HighNonlinearity event when the metric exceeds this (requires second-order uncertainty propagation).