pyphi.resolve_ties.cascade#

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

Walk a cascade of postulate-level reductions.

At each level, apply level.op with level.key to identify surviving candidates. If a single candidate remains, the cascade resolves. If multiple remain and the next level is within budget, recurse on that level. Otherwise:

  • on_unresolved='defer' (default): return UNRESOLVED_WITHIN_BUDGET carrying the tied set for downstream surfacing.

  • on_unresolved='fail': raise NotAComplex.

  • on_unresolved='warn': emit a warning and return as ‘defer’.

Parameters:
Return type:

CascadeOutcome