pyphi.matching.perception.Perception#
- class pyphi.matching.perception.Perception(ces, triggered_tpm, stimulus)[source]#
Bases:
objectThe triggering coefficients and perception values for one stimulus.
A view over a cause-effect structure that computes how much of the structure’s cause-effect power was triggered by
stimulus, without modifying the structure.cesmust be the structure triggered bystimulus: its system state must equal the state the stimulus triggers, which__post_init__checks againsttriggered_tpm.- Variables:
ces (CauseEffectStructure) – The Φ-structure unfolded from the triggered system state. An analytical relation summary is materialized on first use of any per-relation quantity.
triggered_tpm (TriggeredTPM) – The fixed-lag response distribution supplying triggering coefficients.
stimulus (tuple of int) – The sensory-interface state that triggered
ces.
- Parameters:
ces (CauseEffectStructure)
triggered_tpm (TriggeredTPM)
- property triggering_coefficients: dict[source]#
Mapping
{mechanism: TriggeringCoefficient}, one per distinction.Keyed by each distinction’s mechanism, evaluated at that distinction’s mechanism state for this stimulus.
- distinction_perception(distinction)[source]#
Perception value of a distinction, t(x, m) · φ_d (Eq. 8).
- Return type:
- relation_perception(relation)[source]#
Perception value of a relation, t(x, r(d)) · φ_r (Eqs. 9-10).
The relation’s triggering coefficient t(x, r(d)) is the unweighted mean of the triggering coefficients of the distinctions it binds (Eq. 9), so the perception value is the full relation φ_r times that mean (Eq. 10).
- Return type:
- fold_perception(fold)[source]#
Perception value of a single distinction’s Φ-fold (Eq. 11).
For the Φ-fold of a mechanism m — the distinction and every relation involving it — returns the seed’s triggering coefficient t(x, m) times the fold’s contribution to Φ (Eq. 3): the distinction’s φ plus each incident relation’s φ divided by its degree.
foldmust contain exactly one distinction (its seed).