pyphi.resolve_ties.resolve_complex_tie#

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

Resolve a substrate-exclusion tie via the Composition cascade.

Per Albantakis et al. 2023 S1 Text: when overlapping substrates tie at maximum φ_s, the exclusion postulate is resolved by escalating to Φ (Composition). The substrate with maximum Φ qualifies as the complex; overlapping losers are excluded. If multiple substrates also tie at Φ, the exclusion postulate fails for that group and they do not qualify as complexes — under on_unresolved='fail' this raises NotAComplex; under 'defer' the outcome is UNRESOLVED_WITHIN_BUDGET carrying the tied set so the caller can proceed to the next-best by φ_s.

Callers are expected to pre-filter candidates to a single φ_s-tied overlap-clique; this function only walks the Composition step.

Parameters:
Return type:

CascadeOutcome