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