pyphi.relations.maximal_faces#

pyphi.relations.maximal_faces(distinctions, atoms=None)[source]#

Return the relation faces maximal under set inclusion of their relata (causes/effects), across all relations.

The face at atom n is M(n), the causes and effects whose purview contains n; every face of every relation is contained in some M(n), and M(n) is itself a face of the relation Z(n) (the distinctions whose purview-union contains n [1]), so the maximal faces are the inclusion-maximal elements of {M(n)}. Each face carries the φ_r of the relation it is a face of. A maximal face’s parent relation need not be a maximal relation, so the maximal faces are not obtainable from maximal_relations().

Parameters:
  • distinctions (Iterable) – The distinctions generating the relation complex.

  • atoms (collection, optional) – If given, only faces whose overlap contains one of these atoms are considered. If None, all atoms count.

Returns:

frozenset[RelationFace] – The maximal faces.

References