pyphi.resolve_ties.resolve_state_tie#

pyphi.resolve_ties.resolve_state_tie(per_state_mips, *, context, on_unresolved='defer')[source]#

Resolve a state tie via the per-state max-min cascade.

Per Albantakis et al. 2023 S1 Text + Eq 20 parenthetical: among states tied at maximal intrinsic specification, the canonical winner is the state whose per-state φ_s (the value of integrated information at that state’s MIP) is greatest. If φ_s ties too, the cascade escalates to per-state Φ (the cause-effect structure’s integrated information at Composition). If Φ ties as well, the substrate fails the information postulate — NotAComplex is raised under on_unresolved='fail'.

per_state_mips maps each candidate state spec to a per-state MIP result object (typically a SystemIrreducibilityAnalysis or similar). The object must expose .phi; .big_phi is consulted only when Composition escalation fires.

Returns a CascadeOutcome whose resolved field is the winning key from per_state_mips (or None when budget caps escalation short of resolution).

Parameters:
Return type:

CascadeOutcome