pyphi.visualize.projection.project_ces#

pyphi.visualize.projection.project_ces(ces, node_labels=None, max_relations=None)[source]#

Project a CauseEffectStructure into plot-ready data.

Parameters:

  • ces (CauseEffectStructure) – The cause-effect structure to project. Must be relation-closed.

  • node_labels (NodeLabels, optional) – Labels for substrate units. Defaults to the labels carried by the first distinction.

  • max_relations (int, optional) – Render only the max_relations strongest relations (and their faces), in descending φ_r order. If None, render every relation when the set is enumerable; when it is not (the analytical backend), render the strongest DEFAULT_MAX_ANALYTICAL_RELATIONS. Node marker sizes and the degree spectrum are always computed over the full structure, independent of this cap.

Returns:

CESProjection

Raises:

  • TypeError – If ces is not relation-closed (e.g. a PhiFold, whose relations may reference distinctions outside it).

  • ValueError – If the structure has no distinctions (an empty, reducible-system structure).

Return type:

CESProjection