ph? SrSSKrSSKJrJr SSKJrJrJrJ r J r SSK J r /SQr "S S \R5rSS jr"S S \R5r"SS\5r"SS\5r/SQr"SS\R5rg)zMechanism-level objects.N)cmpfmt) Directionconfig connectivity distributionutils)WrongDirectionError)phi direction mechanismpurview partition repertoirepartitioned_repertoirec\rSrSrSrSSjr\S5r\S5r\S5r \S5r \S 5r \S 5r \S 5r \S 5rS /rSrSrSrSrSrSrSrSrg) RepertoireIrreducibilityAnalysisaAn analysis of the irreducibility (|small_phi|) of a mechanism over a purview, for a given partition, in one temporal direction. These can be compared with the built-in Python comparison operators (``<``, ``>``, etc.). First, |small_phi| values are compared. Then, if these are equal up to |PRECISION|, the size of the mechanism is compared (see the |PICK_SMALLEST_PURVIEW| option in |config|.) Nc XlX lX0lX@lXPlSn U "U5UlU "U5UlXlg)Nc6Ucg[R"U5$N)nparray)rs P/home/james-whalen/.local/lib/python3.13/site-packages/pyphi/models/mechanism.py _repertoire>RepertoireIrreducibilityAnalysis.__init__.._repertoire$s!88J' ')_phi _direction _mechanism_purview _partitionr_partitioned_repertoire _node_labels) selfr rrrrrr node_labelsrs r__init__)RepertoireIrreducibilityAnalysis.__init__sG ## # ( 'z2'23I'J$(rcUR$)zafloat: This is the difference between the mechanism's unpartitioned and partitioned repertoires. )r r's rr $RepertoireIrreducibilityAnalysis.phi/ yyrcUR$zDirection: |CAUSE| or |EFFECT|.)r!r,s rr*RepertoireIrreducibilityAnalysis.direction6rcUR$)z,tuple[int]: The mechanism that was analyzed.)r"r,s rr*RepertoireIrreducibilityAnalysis.mechanism;r2rcUR$)zCtuple[int]: The purview over which the the mechanism was analyzed. )r#r,s rr(RepertoireIrreducibilityAnalysis.purview@s }}rcUR$)zKKPartition: The partition of the mechanism-purview pair that was analyzed. )r$r,s rr*RepertoireIrreducibilityAnalysis.partitionGs rcUR$)z=np.ndarray: The repertoire of the mechanism over the purview.)rr,s rr+RepertoireIrreducibilityAnalysis.repertoireNsrcUR$)znp.ndarray: The partitioned repertoire of the mechanism over the purview. This is the product of the repertoires of each part of the partition. )r%r,s rr7RepertoireIrreducibilityAnalysis.partitioned_repertoireSs +++rcUR$)z|NodeLabels| for this system.)r&r,s rr(,RepertoireIrreducibilityAnalysis.node_labels[s   rrc[R(a6UR[UR5[UR 5*/$UR[UR5[UR 5/$r)rPICK_SMALLEST_PURVIEWr lenrrr,s rorder_by)RepertoireIrreducibilityAnalysis.order_bybsT  ' 'HHc$..1C 4E3EF F#dnn-s4< 0|. rr eqr r,s r__bool__)RepertoireIrreducibilityAnalysis.__bool__os88DHHa(((rc [URURURUR[ R "UR545$r)hashr rrrr np_hashrr,s r__hash__)RepertoireIrreducibilityAnalysis.__hash__us?TXX^^^^\\]]4??3 56 6rc8[R"U[5$r)r make_repr_ria_attributesr,s r__repr__)RepertoireIrreducibilityAnalysis.__repr__|s}}T?33rc\S[R"[R"U55-$)Nz#Repertoire irreducibility analysis )rindentfmt_riar,s r__str__(RepertoireIrreducibilityAnalysis.__str__s$6 3;;t,-. /rcL[Vs0sHo[X5_M sn$s snfr)rVgetattrr'attrs rto_json(RepertoireIrreducibilityAnalysis.to_jsons"6EFodgd))oFFFs!)r!r"r&r$r%r r#rr)__name__ __module__ __qualname____firstlineno____doc__r)propertyr rrrrrrr(unorderable_unless_eqrBrHrMrRrWr\rb__static_attributes__rrrrs"((     ,,!!)MB 2) 64/Grrc  [UUUSUSUS9$)z6The irreducibility analysis for a reducible mechanism.N)rrrrrrr )r)rrrrr s r _null_riarns& ,#  rc\rSrSrSrSr\S5r\S5r\S5r \S5r \S5r \S 5r \S 5r \S 5rS rS r\R$rSrSrSrSrSrSrSrg)!MaximallyIrreducibleCauseOrEffecta;A maximally irreducible cause or effect (MICE). These can be compared with the built-in Python comparison operators (``<``, ``>``, etc.). First, |small_phi| values are compared. Then, if these are equal up to |PRECISION|, the size of the mechanism is compared (see the |PICK_SMALLEST_PURVIEW| option in |config|.) cXlgr_ria)r'rias rr)*MaximallyIrreducibleCauseOrEffect.__init__s rc.URR$)zYfloat: The difference between the mechanism's unpartitioned and partitioned repertoires. )rtr r,s rr %MaximallyIrreducibleCauseOrEffect.phis yy}}rc.URR$r0rtrr,s rr+MaximallyIrreducibleCauseOrEffect.directionyy"""rc.URR$)z9list[int]: The mechanism for which the MICE is evaluated.)rtrr,s rr+MaximallyIrreducibleCauseOrEffect.mechanismr|rc.URR$)zKlist[int]: The purview over which this mechanism's |small_phi| is maximal. )rtrr,s rr)MaximallyIrreducibleCauseOrEffect.purviews yy   rc.URR$)zYKPartition: The partition that makes the least difference to the mechanism's repertoire. )rtrr,s rmip%MaximallyIrreducibleCauseOrEffect.mips yy"""rc.URR$)zLnp.ndarray: The unpartitioned repertoire of the mechanism over the purview. )rtrr,s rr,MaximallyIrreducibleCauseOrEffect.repertoires yy###rc.URR$)zJnp.ndarray: The partitioned repertoire of the mechanism over the purview. )rtrr,s rr8MaximallyIrreducibleCauseOrEffect.partitioned_repertoires yy///rcUR$)zRRepertoireIrreducibilityAnalysis: The irreducibility analysis for this mechanism. rsr,s rru%MaximallyIrreducibleCauseOrEffect.riar.rc2[R"US/5$Nru)rrUr,s rrW*MaximallyIrreducibleCauseOrEffect.__repr__s}}TE7++rcSR[UR5R55[R "[R "URSS95-$)NzMaximally-irreducible {} T)r)formatstrrlowerrrZr[rur,s rr\)MaximallyIrreducibleCauseOrEffect.__str__sG ( / /DNN0C0I0I0K L JJs{{4886 7 8 rc6URR5$r)rurBr,s rrB*MaximallyIrreducibleCauseOrEffect.order_bysxx  ""rc4URUR:H$rrur'rFs rrH(MaximallyIrreducibleCauseOrEffect.__eq__sxx599$$rc,[UR5$r)rPrtr,s rrR*MaximallyIrreducibleCauseOrEffect.__hash__sDIIrcSUR0$rrr,s rrb)MaximallyIrreducibleCauseOrEffect.to_jsonstxx  rcURRURUR5up#[R "UR RX#5$)uIdentify connections that “matter” to this concept. For a |MIC|, the important connections are those which connect the purview to the mechanism; for a |MIE| they are the connections from the mechanism to the purview. Returns an |N x N| matrix, where `N` is the number of nodes in this corresponding subsystem, that identifies connections that “matter” to this MICE: ``direction == Direction.CAUSE``: ``relevant_connections[i,j]`` is ``1`` if node ``i`` is in the cause purview and node ``j`` is in the mechanism (and ``0`` otherwise). ``direction == Direction.EFFECT``: ``relevant_connections[i,j]`` is ``1`` if node ``i`` is in the mechanism and node ``j`` is in the effect purview (and ``0`` otherwise). Args: subsystem (Subsystem): The |Subsystem| of this MICE. Returns: np.ndarray: A |N x N| matrix of connections, where |N| is the size of the network. Raises: ValueError: If ``direction`` is invalid. )rorderrrr relevant_connectionsnetworksize)r' subsystem_fromtos r_relevant_connections7MaximallyIrreducibleCauseOrEffect._relevant_connectionssH>NN((F 001B1B1G1G16< Nt11)< }}// 0A0A0F0FGHKLMN OrrsN)rdrerfrgrhr)rir rrrrrrrurWr\rrjrBrHrRrbrrrkrlrrrprps ####!! ## $$ 00  ,  )>>#%!!``, etc.). First, |small_phi| values are compared. Then, if these are equal up to |PRECISION|, the size of the mechanism is compared (see the |PICK_SMALLEST_PURVIEW| option in |config|.) cv>UR[R:wa [S5e[TU]U5 g)Nz``, etc.). First, |small_phi| values are compared. Then, if these are equal up to |PRECISION|, the size of the mechanism is compared (see the |PICK_SMALLEST_PURVIEW| option in |config|.) cv>UR[R:wa [S5e[TU]U5 g)Nz=A MIE must be initialized with a RIA in the effect direction.)rrEFFECTr rr)rs rr)#MaximallyIrreducibleEffect.__init__>s7 ==I,, ,%'AB B rc.URR$)zDirection: |EFFECT|.rzr,s rr$MaximallyIrreducibleEffect.directionDr|rrlrrs@rrr5rrr)r rcauseeffectrc\rSrSrSrSSjrSrSr\S5r \S5r \S 5r \S 5r \S 5r \S 5rS /rSrSrSrSrSrSrSSjrSSjrSrSrSr\S5rSrg)ConceptiQaThe maximally irreducible cause and effect specified by a mechanism. These can be compared with the built-in Python comparison operators (``<``, ``>``, etc.). First, |small_phi| values are compared. Then, if these are equal up to |PRECISION|, the size of the mechanism is compared. Attributes: mechanism (tuple[int]): The mechanism that the concept consists of. cause (MaximallyIrreducibleCause): The |MIC| representing the maximally-irreducible cause of this concept. effect (MaximallyIrreducibleEffect): The |MIE| representing the maximally-irreducible effect of this concept. subsystem (Subsystem): This concept's parent subsystem. time (float): The number of seconds it took to calculate. NcbXlX lX0lXPlX@lUR Ulgr)rrrtimerr()r'rrrrrs rr)Concept.__init__bs)"   "$00rc8[R"U[5$r)rrU_concept_attributesr,s rrWConcept.__repr__ks}}T#677rc.[R"U5$r)r fmt_conceptr,s rr\Concept.__str__nst$$rcj[URRURR5$)zqfloat: The size of the concept. This is the minimum of the |small_phi| values of the concept's |MIC| and |MIE|. )minrr rr,s rr Concept.phiqs!4::>>4;;??33rc0[URSS5$)ztuple[int]: The cause purview.rNr_rr,s r cause_purviewConcept.cause_purviewzstzz9d33rc0[URSS5$)ztuple[int]: The effect purview.rNr_rr,s reffect_purviewConcept.effect_purviewst{{It44rc0[URSS5$)z!np.ndarray: The cause repertoire.rNrr,s rcause_repertoireConcept.cause_repertoirestzz<66rc0[URSS5$)z"np.ndarray: The effect repertoire.rNrr,s reffect_repertoireConcept.effect_repertoirest{{L$77rcl[R"URURR5$)z(tuple(int): The state of this mechanism.)r state_ofrrstater,s rmechanism_stateConcept.mechanism_states#~~dnndnn.B.BCCrrcDUR[UR5/$r)r rArr,s rrBConcept.order_bys#dnn-..rcURUR:H=(a URUR:H=(a URUR:H=(a URUR:H=(ae URUR:H=(aE UR U5=(a- UR RUR R:H$r)r rrrreq_repertoiresrrrs rrHConcept.__eq__sEII%B%//1B$$(=(==B""e&9&99B##u';';; B ##E* B &&%//*A*AA  Crc ,[URURURURUR [ R"UR5[ R"UR5URR45$r) rPr rrrrr rQrrrrr,s rrRConcept.__hash__smTXX^^))''((]]4#8#89]]4#9#9:^^++-. .rcN[R"URS5(+$)z)A concept is ``True`` if |small_phi > 0|.rrKr,s rrMConcept.__bool__s88DHHa(((rc[R"URUR5=(a+ [R"URUR5$)aReturn whether this concept has the same repertoires as another. .. warning:: This only checks if the cause and effect repertoires are equal as arrays; mechanisms, purviews, or even the nodes that the mechanism and purview indices refer to, might be different. )r array_equalrrrs rrConcept.eq_repertoiressD NN400%2H2H I L NN41153J3J K MrcURUR:H=(a1 URUR:H=(a URU5$)zVReturn whether this concept is equal to another in the context of an EMD calculation. )r rrrs remd_eqConcept.emd_eqsAEII%+%//1+##E* ,rcbURRURRU5$z$See |Subsystem.expand_repertoire()|.)rexpand_cause_repertoirerrr' new_purviews rrConcept.expand_cause_repertoires(~~55 JJ ! !;0 0rcbURRURRU5$r)rexpand_effect_repertoirerrrs rr Concept.expand_effect_repertoires(~~66 KK " "K1 1rctURRURRR5$r)rrrrurr,s r#expand_partitioned_cause_repertoire+Concept.expand_partitioned_cause_repertoires*~~55 JJNN 1 13 3rctURRURRR5$r)rrrrurr,s r$expand_partitioned_effect_repertoire,Concept.expand_partitioned_effect_repertoires*~~66 KKOO 2 24 4rcV[S/-Vs0sHnU[X5_M sn$s snf)z*Return a JSON-serializable representation.r)rr_r`s rrbConcept.to_jsons:,vh6 6 '$% %6   s&cUS U"S0UD6$)Nr rlrl)clsdcts r from_jsonConcept.from_jsons JzSzr)rrrr(rr)NNNNNr)rdrerfrgrhr)rWr\rir rrrrrrjrBrHrRrMrrrrrrrb classmethodrrkrlrrrrQs ;?&*18%4444557788DD)M/C.) M,0 1 3 4  rr)Ng)rhnumpyrrrrrr r r exceptionsr rV Orderablerrnrprrrrrlrrrs CC,;sGs}}sGl "EO EOP# A#*#!B#.K RcmmRr