pyphi.macro.criteria.judge_candidate

pyphi.macro.criteria.judge_candidate(phi, competitors, *, num_gated=0)

Eqs. 16-17 given φₛ(v^J) and the evaluated competitor set.

All inequalities are strict at config.numerics.precision; a candidate that ties its strongest competitor is invalid with reason TIED.

Parameters:

• phi (float) – The candidate’s φₛ(v^J).

• competitors (Iterable[tuple[MacroSystem, float]]) – (system, φₛ) pairs for f(U^J, W^J, τ_J).

• num_gated (int) – Competitors certified — by an intrinsic-information ceiling strictly below phi — unable to beat or tie the candidate; counted in num_competitors but never evaluated.

Return type:

UnitVerdict