resilience-core — P40

Domänenübergreifende Systemresilienzgröße Ρ
GenesisAeon Package 40 · MOR Research Collective · Johann Römer

What is Ρ?

resilience-core implements the domain-overarching system resilience metric Ρ derived from UTAC (Universal Tipping Attractor Cascade) fixpoint analysis:

Ρ(t) = |λ*(t)| · (1 - Γ(t)/Γ_max) · (1 - Σ_j |C_ij(t)|/C_critical)

Three multiplicative factors:

Ρ → 0 when a system is simultaneously near its tipping point (Γ → Γ_max) AND receiving strong destabilising coupling (C_ij → C_critical). This formally captures cascade collapse.

Installation

pip install resilience-core
# or
uv add resilience-core

Quick Start

from resilience_core import ResilienceCore, compute_rho

# Single domain -- these are the real numbers with the r=1.0 default
# (see "Uncalibrated defaults" below; this is not yet AMOC's real target)
core = ResilienceCore(domain="amoc")
core.run_cycle(gamma=0.251)
print(core.get_resilience_state())
# {'rho': 0.18337286132702, 'lambda_star': 0.2521719468174266,
#  'recovery_time': 3.965548161167997, 'near_collapse': False, ...}

# Convenience function
rho_arctic = compute_rho(gamma=0.920, domain="arctic")  # = 0.0 (near_collapse=True)

# With inter-domain coupling
core_amoc = ResilienceCore(domain="amoc")
core_amoc.run_cycle(
    gamma=0.251,
    coupling_updates={("arctic_ice", "amoc"): 0.15, ("amazon", "amoc"): 0.08}
)
print(core_amoc.get_resilience_state()["rho"])  # ≈ 0.099 (reduced from 0.183 by coupling)

Uncalibrated defaults — read this before trusting a Ρ number

The table below shows what compute_rho/ResilienceCore actually return with the default r=1.0 for every domain. r (the intrinsic return rate) has not been fitted to each domain's real dynamics yet -- see benchmarks/amoc_calibration.py, which documents this openly for AMOC: reaching the literature-motivated target Ρ≈0.65 needs r≈3.54 (calibration_status: "OPEN — pending amoc-utac (P18) timeseries"), not the default r=1.0, which gives Ρ≈0.18. The same caveat applies to every row below -- these are real, reproducible outputs of this code, not yet domain-calibrated targets.

near_collapse is rho < COLLAPSE_THRESHOLD, computed by the code itself -- e.g. Quantum's low Γ does not mean high Ρ once actually computed; with the default r it flags as near-collapse, the opposite of an earlier version of this table which described it as "Very resilient."

Diamond Interface

ResilienceCore implements all 6 GenesisAeon Diamond methods:

core.run_cycle(gamma)         # Method 1: execute one step
core.get_crep_state()         # Method 2: CREP snapshot {C, R, E, P, Gamma}
core.get_utac_state()         # Method 3: UTAC snapshot {H, H_star, K_eff}
core.get_phase_events()       # Method 4: near-collapse & cascade events
core.to_zenodo_record()       # Method 5: Zenodo deposition metadata
core.get_resilience_state()   # Method 6 (NEW): full Ρ breakdown

get_resilience_state() is the 6th Diamond method — a standard interface for all GenesisAeon packages to optionally expose via resilience-core.

Frame-Principle Boundary

σ_Φ ≈ 1/16 = 0.0625 defines the collapse threshold:

from resilience_core import frame_principle_report
report = frame_principle_report(gamma=0.9, rho=0.03)
# {'status': 'critical', 'frame_principle_warning': True, ...}

Structure

resilience_core/
├── constants.py         # σ, σ_Φ, Γ_max, C_critical
├── eigenrate.py         # λ*(t) = -r·tanh²(σΓ)
├── coupling.py          # CouplingMatrix: C_ij inter-domain effects
├── cascade.py           # CascadeDetector: multi-domain collapse warning
├── rho_calculator.py    # RhoCalculator: Ρ = |λ*|·margin·coupling_factor
├── frame_principle.py   # σ_Φ boundary analysis
├── system.py            # ResilienceCore — Diamond Interface main class
└── benchmarks/          # Calibration scripts (AMOC, Arctic, Sandpile)

Citation

@software{romer2026resiliencecore,
  author       = {Römer, Johann},
  title        = {resilience-core: UTAC-derived system resilience (Ρ)},
  year         = 2026,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.21398177},
  url          = {https://github.com/GenesisAeon/resilience-core}
}

Part of the GenesisAeon ecosystem · related: diamond-setup (P-INFRA-1), scope-resilience (P41)