sh"_>SrSSKJrJrJrJr SSKrSSKJr SSK J r SSK J r /SQr \RrSr\R""S S S 9SS j5rS r\R""S SS0S S9SSS.Sjj5r\r\R""S SS0S S9SSS.Sjj5rg)z3Provides functions for computing minors of a graph.)chain combinations permutationsproductN)density)NetworkXException)arbitrary_element)contracted_edgecontracted_nodesequivalence_classesidentified_nodesquotient_graphc/nUHJnUH/n[U5nU"XS5(dMURU5 M6 URU/5 ML UVs1sHn[U5iM sn$s snf)akReturns equivalence classes of `relation` when applied to `iterable`. The equivalence classes, or blocks, consist of objects from `iterable` which are all equivalent. They are defined to be equivalent if the `relation` function returns `True` when passed any two objects from that class, and `False` otherwise. To define an equivalence relation the function must be reflexive, symmetric and transitive. Parameters ---------- iterable : list, tuple, or set An iterable of elements/nodes. relation : function A Boolean-valued function that implements an equivalence relation (reflexive, symmetric, transitive binary relation) on the elements of `iterable` - it must take two elements and return `True` if they are related, or `False` if not. Returns ------- set of frozensets A set of frozensets representing the partition induced by the equivalence relation function `relation` on the elements of `iterable`. Each member set in the return set represents an equivalence class, or block, of the partition. Duplicate elements will be ignored so it makes the most sense for `iterable` to be a :class:`set`. Notes ----- This function does not check that `relation` represents an equivalence relation. You can check that your equivalence classes provide a partition using `is_partition`. Examples -------- Let `X` be the set of integers from `0` to `9`, and consider an equivalence relation `R` on `X` of congruence modulo `3`: this means that two integers `x` and `y` in `X` are equivalent under `R` if they leave the same remainder when divided by `3`, i.e. `(x - y) mod 3 = 0`. The equivalence classes of this relation are `{0, 3, 6, 9}`, `{1, 4, 7}`, `{2, 5, 8}`: `0`, `3`, `6`, `9` are all divisible by `3` and leave zero remainder; `1`, `4`, `7` leave remainder `1`; while `2`, `5` and `8` leave remainder `2`. We can see this by calling `equivalence_classes` with `X` and a function implementation of `R`. >>> X = set(range(10)) >>> def mod3(x, y): ... return (x - y) % 3 == 0 >>> equivalence_classes(X, mod3) # doctest: +SKIP {frozenset({1, 4, 7}), frozenset({8, 2, 5}), frozenset({0, 9, 3, 6})} )r append frozenset)iterablerelationblocksyblockxs z/Users/tiagomarins/Projetos/claudeai/copy_bank/venv/lib/python3.13/site-packages/networkx/algorithms/minors/contraction.pyr r spvF E!%(A~~ Q  MM1# +1 1&Ie & 11 1sA/weightT) edge_attrs returns_graphc .[U5(aW[X5n[RR X5(d[R "S5e[ UUUUUUUU5$[U[5(a[UR55n[5R"U6n[U5[U5:waURU5n[RR X5(d [ S5e[ UUUUUUUU5$)a!Returns the quotient graph of `G` under the specified equivalence relation on nodes. Parameters ---------- G : NetworkX graph The graph for which to return the quotient graph with the specified node relation. partition : function, or dict or list of lists, tuples or sets If a function, this function must represent an equivalence relation on the nodes of `G`. It must take two arguments *u* and *v* and return True exactly when *u* and *v* are in the same equivalence class. The equivalence classes form the nodes in the returned graph. If a dict of lists/tuples/sets, the keys can be any meaningful block labels, but the values must be the block lists/tuples/sets (one list/tuple/set per block), and the blocks must form a valid partition of the nodes of the graph. That is, each node must be in exactly one block of the partition. If a list of sets, the list must form a valid partition of the nodes of the graph. That is, each node must be in exactly one block of the partition. edge_relation : Boolean function with two arguments This function must represent an edge relation on the *blocks* of the `partition` of `G`. It must take two arguments, *B* and *C*, each one a set of nodes, and return True exactly when there should be an edge joining block *B* to block *C* in the returned graph. If `edge_relation` is not specified, it is assumed to be the following relation. Block *B* is related to block *C* if and only if some node in *B* is adjacent to some node in *C*, according to the edge set of `G`. node_data : function This function takes one argument, *B*, a set of nodes in `G`, and must return a dictionary representing the node data attributes to set on the node representing *B* in the quotient graph. If None, the following node attributes will be set: * 'graph', the subgraph of the graph `G` that this block represents, * 'nnodes', the number of nodes in this block, * 'nedges', the number of edges within this block, * 'density', the density of the subgraph of `G` that this block represents. edge_data : function This function takes two arguments, *B* and *C*, each one a set of nodes, and must return a dictionary representing the edge data attributes to set on the edge joining *B* and *C*, should there be an edge joining *B* and *C* in the quotient graph (if no such edge occurs in the quotient graph as determined by `edge_relation`, then the output of this function is ignored). If the quotient graph would be a multigraph, this function is not applied, since the edge data from each edge in the graph `G` appears in the edges of the quotient graph. weight : string or None, optional (default="weight") The name of an edge attribute that holds the numerical value used as a weight. If None then each edge has weight 1. relabel : bool If True, relabel the nodes of the quotient graph to be nonnegative integers. Otherwise, the nodes are identified with :class:`frozenset` instances representing the blocks given in `partition`. create_using : NetworkX graph constructor, optional (default=nx.Graph) Graph type to create. If graph instance, then cleared before populated. Returns ------- NetworkX graph The quotient graph of `G` under the equivalence relation specified by `partition`. If the partition were given as a list of :class:`set` instances and `relabel` is False, each node will be a :class:`frozenset` corresponding to the same :class:`set`. Raises ------ NetworkXException If the given partition is not a valid partition of the nodes of `G`. Examples -------- The quotient graph of the complete bipartite graph under the "same neighbors" equivalence relation is `K_2`. Under this relation, two nodes are equivalent if they are not adjacent but have the same neighbor set. >>> G = nx.complete_bipartite_graph(2, 3) >>> same_neighbors = lambda u, v: (u not in G[v] and v not in G[u] and G[u] == G[v]) >>> Q = nx.quotient_graph(G, same_neighbors) >>> K2 = nx.complete_graph(2) >>> nx.is_isomorphic(Q, K2) True The quotient graph of a directed graph under the "same strongly connected component" equivalence relation is the condensation of the graph (see :func:`condensation`). This example comes from the Wikipedia article *`Strongly connected component`_*. >>> G = nx.DiGraph() >>> edges = [ ... "ab", ... "be", ... "bf", ... "bc", ... "cg", ... "cd", ... "dc", ... "dh", ... "ea", ... "ef", ... "fg", ... "gf", ... "hd", ... "hf", ... ] >>> G.add_edges_from(tuple(x) for x in edges) >>> components = list(nx.strongly_connected_components(G)) >>> sorted(sorted(component) for component in components) [['a', 'b', 'e'], ['c', 'd', 'h'], ['f', 'g']] >>> >>> C = nx.condensation(G, components) >>> component_of = C.graph["mapping"] >>> same_component = lambda u, v: component_of[u] == component_of[v] >>> Q = nx.quotient_graph(G, same_component) >>> nx.is_isomorphic(C, Q) True Node identification can be represented as the quotient of a graph under the equivalence relation that places the two nodes in one block and each other node in its own singleton block. >>> K24 = nx.complete_bipartite_graph(2, 4) >>> K34 = nx.complete_bipartite_graph(3, 4) >>> C = nx.contracted_nodes(K34, 1, 2) >>> nodes = {1, 2} >>> is_contracted = lambda u, v: u in nodes and v in nodes >>> Q = nx.quotient_graph(K34, is_contracted) >>> nx.is_isomorphic(Q, C) True >>> nx.is_isomorphic(Q, K24) True The blockmodeling technique described in [1]_ can be implemented as a quotient graph. >>> G = nx.path_graph(6) >>> partition = [{0, 1}, {2, 3}, {4, 5}] >>> M = nx.quotient_graph(G, partition, relabel=True) >>> list(M.edges()) [(0, 1), (1, 2)] Here is the sample example but using partition as a dict of block sets. >>> G = nx.path_graph(6) >>> partition = {0: {0, 1}, 2: {2, 3}, 4: {4, 5}} >>> M = nx.quotient_graph(G, partition, relabel=True) >>> list(M.edges()) [(0, 1), (1, 2)] Partitions can be represented in various ways: 0. a list/tuple/set of block lists/tuples/sets 1. a dict with block labels as keys and blocks lists/tuples/sets as values 2. a dict with block lists/tuples/sets as keys and block labels as values 3. a function from nodes in the original iterable to block labels 4. an equivalence relation function on the target iterable As `quotient_graph` is designed to accept partitions represented as (0), (1) or (4) only, the `equivalence_classes` function can be used to get the partitions in the right form, in order to call `quotient_graph`. .. _Strongly connected component: https://en.wikipedia.org/wiki/Strongly_connected_component References ---------- .. [1] Patrick Doreian, Vladimir Batagelj, and Anuska Ferligoj. *Generalized Blockmodeling*. Cambridge University Press, 2004. z?Input `partition` is not an equivalence relation for nodes of Gz4each node must be in exactly one part of `partition`)callabler nx community is_partitionr_quotient_graph isinstancedictlistvaluessetunionlensubgraph) G partition edge_relation node_data edge_datarrelabel create_usingpartition_nodess rrrcsX '5 ||((66&&Q          )T""))+, ekk9-O ?s1v% JJ ' << $ $Q 2 2 VWW    c^^^^^UcTR5nO[R"SU5nTcU4SjmUV s/sHn [U 5PM nn UR U4SjU55 TcU4SjmTcUU4SjmUR 5(a [ US5O [US5n UR5(a[UU4SjU 55n O UU4SjU 5n URU 5 U(a5[U5V V s0sHupX_M n n n [R"X5nU$s sn fs sn n f) zTRU5nU[U5UR5[U5S.$)N)graphnnodesnedgesr)r)r(number_of_edgesr)bSr*s rr-"_quotient_graph..node_datags7 1 Aa&++-"1:  r2c36># UHoT"U54v M g7fN).0r9r-s r "_quotient_graph..rs: 11& sc@>[U4Sj[X555$)Nc38># UHupUTU;v M g7fr=r>)r?uvr*s rr@9_quotient_graph..edge_relation..}s;]TQqAaDy]s)anyr)r9cr*s rr,&_quotient_graph..edge_relation|s;WQ];; ;r2cr>^^UU4SjTRTT-SS95nS[U4SjU550$)Nc3f># UH&upnUT;aUT;dUT;dMUT;dM"Uv M( g7fr=r>)r?rDrEdr9rHs rr@5_quotient_graph..edge_data..s=8GA!FqAv16671f8s 11 1Tdatarc3F># UHoRTS5v M g7f)N)get)r?rLrs rr@rMs!EHq%%"2"2Hs!)edgessum)r9rHedgedatar*rs`` rr."_quotient_graph..edge_datas; wwq1u4w8H c!EH!EEF Fr2c3~>^^# UH0ummT"TT5(dMUUU4Sj[TT55v M2 g7f)c 3d># UH%upUTU;dMTTTRX0S94v M' g7f))defaultN) get_edge_data)r?rDrEr*r9rHs rr@,_quotient_graph...s; )DA!9:AqqR89)s00N)r)r?r9rHr*r,s @@rr@rAsB $1Q"   #AqM   $s==c3Z># UH upT"X5(dMXT"X54v M" g7fr=r>)r?r9rHr.r,s rr@rAs) 2=qAT #Q9Q? #+s++) __class__r empty_graphradd_nodes_from is_directedrr is_multigraphchainiadd_edges_from enumerate relabel_nodes)r*r+r,r-r.rr/r0Hr9 block_pairsrSilabelss` ```` rr!r![s+ KKM NN1l + (11y!1yI1: :: <  G)* ,q!$\!Q=OK  $    2= U$-Y#78#741!$#78   Q ' Hq2l9s D8D=znot copy)preserve_all_attrs mutates_inputr contraction)store_contraction_ascLU(aUR5OUnUR5(a)[URUSS9UR USS95nOUR USS9nU(d [ U5nURUnURU5 USL=n (aUn UHupn X:waU OUnX:waU OUnX1X1:Xa U(dM)URX5(aUR5(aUR"X40U D6 MiU (dMrW UR X4;aXR X4U X4'MX4U 0UR X4U 'M U (a<W URU;aXRUU U'U$X(0URUU 'U$)a Returns the graph that results from contracting `u` and `v`. Node contraction identifies the two nodes as a single node incident to any edge that was incident to the original two nodes. Parameters ---------- G : NetworkX graph The graph whose nodes will be contracted. u, v : nodes Must be nodes in `G`. self_loops : Boolean If this is True, any edges joining `u` and `v` in `G` become self-loops on the new node in the returned graph. copy : Boolean If this is True (default True), make a copy of `G` and return that instead of directly changing `G`. store_contraction_as : str or None, default="contraction" Name of the node/edge attribute where information about the contraction should be stored. By default information about the contracted node and any contracted edges is stored in a ``"contraction"`` attribute on the resulting node and edge. If `None`, information about the contracted nodes/edges and their data are not stored. Returns ------- Networkx graph If Copy is True, A new graph object of the same type as `G` (leaving `G` unmodified) with `u` and `v` identified in a single node. The right node `v` will be merged into the node `u`, so only `u` will appear in the returned graph. If copy is False, Modifies `G` with `u` and `v` identified in a single node. The right node `v` will be merged into the node `u`, so only `u` will appear in the returned graph. Notes ----- For multigraphs, the edge keys for the realigned edges may not be the same as the edge keys for the old edges. This is natural because edge keys are unique only within each pair of nodes. For non-multigraphs where `u` and `v` are adjacent to a third node `w`, the edge (`v`, `w`) will be contracted into the edge (`u`, `w`) with its attributes stored into a "contraction" attribute. This function is also available as `identified_nodes`. Examples -------- Contracting two nonadjacent nodes of the cycle graph on four nodes `C_4` yields the path graph (ignoring parallel edges): >>> G = nx.cycle_graph(4) >>> M = nx.contracted_nodes(G, 1, 3) >>> P3 = nx.path_graph(3) >>> nx.is_isomorphic(M, P3) True >>> G = nx.MultiGraph(P3) >>> M = nx.contracted_nodes(G, 0, 2) >>> M.edges MultiEdgeView([(0, 1, 0), (0, 1, 1)]) >>> G = nx.Graph([(1, 2), (2, 2)]) >>> H = nx.contracted_nodes(G, 1, 2, self_loops=False) >>> list(H.nodes()) [1] >>> list(H.edges()) [(1, 1)] In a ``MultiDiGraph`` with a self loop, the in and out edges will be treated separately as edges, so while contracting a node which has a self loop the contraction will add multiple edges: >>> G = nx.MultiDiGraph([(1, 2), (2, 2)]) >>> H = nx.contracted_nodes(G, 1, 2) >>> list(H.edges()) # edge 1->2, 2->2, 2<-2 from the original Graph G [(1, 1), (1, 1), (1, 1)] >>> H = nx.contracted_nodes(G, 1, 2, self_loops=False) >>> list(H.edges()) # edge 2->2, 2<-2 from the original Graph G [(1, 1), (1, 1)] See Also -------- contracted_edge quotient_graph TrNN) copyrarin_edges out_edgesrSr$nodes remove_nodehas_edgerbadd_edge)r*rDrE self_loopsrqrorgedges_to_remapv_data_store_contractionrnprev_wprev_xrLwrs rr r sJaA }}qzz!$z7QT9RS. n- WWQZFMM!3$>??* +kFqkFq   & zz!1??#4#4 JJq !q !   aggqfo-AB ,f-=>170@!/D ,!,& !''!* $)/GGAJ{ #A & H()kAGGAJ{ # Hr2c vUSSupVURXV5(d[SUS35e[UUUUUUS9$)aReturns the graph that results from contracting the specified edge. Edge contraction identifies the two endpoints of the edge as a single node incident to any edge that was incident to the original two nodes. A graph that results from edge contraction is called a *minor* of the original graph. Parameters ---------- G : NetworkX graph The graph whose edge will be contracted. edge : tuple Must be a pair of nodes in `G`. self_loops : Boolean If this is True, any edges (including `edge`) joining the endpoints of `edge` in `G` become self-loops on the new node in the returned graph. copy : Boolean (default True) If this is True, a the contraction will be performed on a copy of `G`, otherwise the contraction will happen in place. store_contraction_as : str or None, default="contraction" Name of the node/edge attribute where information about the contraction should be stored. By default information about the contracted node and any contracted edges is stored in a ``"contraction"`` attribute on the resulting node and edge. If `None`, information about the contracted nodes/edges and their data are not stored. Returns ------- Networkx graph A new graph object of the same type as `G` (leaving `G` unmodified) with endpoints of `edge` identified in a single node. The right node of `edge` will be merged into the left one, so only the left one will appear in the returned graph. Raises ------ ValueError If `edge` is not an edge in `G`. Examples -------- Attempting to contract two nonadjacent nodes yields an error: >>> G = nx.cycle_graph(4) >>> nx.contracted_edge(G, (1, 3)) Traceback (most recent call last): ... ValueError: Edge (1, 3) does not exist in graph G; cannot contract it Contracting two adjacent nodes in the cycle graph on *n* nodes yields the cycle graph on *n - 1* nodes: >>> C5 = nx.cycle_graph(5) >>> C4 = nx.cycle_graph(4) >>> M = nx.contracted_edge(C5, (0, 1), self_loops=False) >>> nx.is_isomorphic(M, C4) True See also -------- contracted_nodes quotient_graph NrWzEdge z. does not exist in graph G; cannot contract it)rxrqro)rv ValueErrorr )r*edgerxrqrorDrEs rr r EsUV 8DA ::a  5&TUVV     1  r2)NNNrFN)TT)__doc__ itertoolsrrrrnetworkxrrnetworkx.exceptionrnetworkx.utilsr __all__ from_iterablercr _dispatchablerr!r r r r>r2rrs9@@0,    K2\XT:  t;tnN bJ?$$(P ANP P f$J?$$(RANRRr2