ó
    …~i²  ã                   ó  • S r SSKJr  SSKrSSKJr  / SQr\" S5      \R                  SS j5       5       r	\" S5      \R                  SS j5       5       r
\" S	5      \" S5      \R                  " S
S9SS j5       5       5       rg)zBridge-finding algorithms.é    )ÚchainN)Únot_implemented_for)ÚbridgesÚhas_bridgesÚlocal_bridgesÚdirectedc              #   óÖ  #   • U R                  5       nU(       a  [        R                  " U 5      OU n[        R                  " X1S9n[	        [
        R                  " U5      5      nUb3  UR                  [        R                  " X15      5      R                  5       nUR                  5        H9  u  pgXg4U;  d  M  Xv4U;  d  M  U(       a  [        X   U   5      S:”  a  M4  Xg4v •  M;     g7f)a”  Generate all bridges in a graph.

A *bridge* in a graph is an edge whose removal causes the number of
connected components of the graph to increase.  Equivalently, a bridge is an
edge that does not belong to any cycle. Bridges are also known as cut-edges,
isthmuses, or cut arcs.

Parameters
----------
G : undirected graph

root : node (optional)
   A node in the graph `G`. If specified, only the bridges in the
   connected component containing this node will be returned.

Yields
------
e : edge
   An edge in the graph whose removal disconnects the graph (or
   causes the number of connected components to increase).

Raises
------
NodeNotFound
   If `root` is not in the graph `G`.

NetworkXNotImplemented
    If `G` is a directed graph.

Examples
--------
The barbell graph with parameter zero has a single bridge:

>>> G = nx.barbell_graph(10, 0)
>>> list(nx.bridges(G))
[(9, 10)]

Notes
-----
This is an implementation of the algorithm described in [1]_.  An edge is a
bridge if and only if it is not contained in any chain. Chains are found
using the :func:`networkx.chain_decomposition` function.

The algorithm described in [1]_ requires a simple graph. If the provided
graph is a multigraph, we convert it to a simple graph and verify that any
bridges discovered by the chain decomposition algorithm are not multi-edges.

Ignoring polylogarithmic factors, the worst-case time complexity is the
same as the :func:`networkx.chain_decomposition` function,
$O(m + n)$, where $n$ is the number of nodes in the graph and $m$ is
the number of edges.

References
----------
.. [1] https://en.wikipedia.org/wiki/Bridge_%28graph_theory%29#Bridge-Finding_with_Chain_Decompositions
©ÚrootNé   )Úis_multigraphÚnxÚGraphÚchain_decompositionÚsetr   Úfrom_iterableÚsubgraphÚnode_connected_componentÚcopyÚedgesÚlen)ÚGr   Ú
multigraphÚHÚchainsÚchain_edgesÚuÚvs           ÚX/home/mande/repo/quber/.venv/lib/python3.13/site-packages/networkx/algorithms/bridges.pyr   r      sµ   é € ðv —‘Ó"€JÞ!Œ�Š�Œ q€AÜ×#Ò# AÑ1€FÜ”e×)Ò)¨&Ó1Ó2€KØÑØ�J‰J”r×2Ò2°1Ó;Ó<×AÑAÓCˆØ—‘–	‰ˆØˆ6˜Õ$¨!¨°{Õ)BÞœc !¡$ q¡'›l¨QÓ.ÙØ�$ŒJò	 ùs   ‚B3C)Â9C)Ã'C)c                 óJ   •  [        [        XS95        g! [         a     gf = f)aP  Decide whether a graph has any bridges.

A *bridge* in a graph is an edge whose removal causes the number of
connected components of the graph to increase.

Parameters
----------
G : undirected graph

root : node (optional)
   A node in the graph `G`. If specified, only the bridges in the
   connected component containing this node will be considered.

Returns
-------
bool
   Whether the graph (or the connected component containing `root`)
   has any bridges.

Raises
------
NodeNotFound
   If `root` is not in the graph `G`.

NetworkXNotImplemented
    If `G` is a directed graph.

Examples
--------
The barbell graph with parameter zero has a single bridge::

    >>> G = nx.barbell_graph(10, 0)
    >>> nx.has_bridges(G)
    True

On the other hand, the cycle graph has no bridges::

    >>> G = nx.cycle_graph(5)
    >>> nx.has_bridges(G)
    False

Notes
-----
This implementation uses the :func:`networkx.bridges` function, so
it shares its worst-case time complexity, $O(m + n)$, ignoring
polylogarithmic factors, where $n$ is the number of nodes in the
graph and $m$ is the number of edges.

r
   TF)Únextr   ÚStopIteration)r   r   s     r   r   r   S   s.   € ðhÜŒW�QÑ"Ô#ð øô ó Ùðús   ‚ •
"¡"r   Úweight)Ú
edge_attrsc              #   óà  ^^#   • USLa=  U R                    H,  u  p4[        X   5      [        X   5      -  (       a  M'  X44v •  M.     g[        R                  R	                  X5      mU R                    HM  u  p4[        X   5      [        X   5      -  (       a  M'  X41mUU4S jn [        R
                  " XXES9nX4U4v •  MO     g! [        R                   a    X4[        S5      4v •   Mx  f = f7f)aø  Iterate over local bridges of `G` optionally computing the span

A *local bridge* is an edge whose endpoints have no common neighbors.
That is, the edge is not part of a triangle in the graph.

The *span* of a *local bridge* is the shortest path length between
the endpoints if the local bridge is removed.

Parameters
----------
G : undirected graph

with_span : bool
    If True, yield a 3-tuple `(u, v, span)`

weight : function, string or None (default: None)
    If function, used to compute edge weights for the span.
    If string, the edge data attribute used in calculating span.
    If None, all edges have weight 1.

Yields
------
e : edge
    The local bridges as an edge 2-tuple of nodes `(u, v)` or
    as a 3-tuple `(u, v, span)` when `with_span is True`.

Raises
------
NetworkXNotImplemented
    If `G` is a directed graph or multigraph.

Examples
--------
A cycle graph has every edge a local bridge with span N-1.

   >>> G = nx.cycle_graph(9)
   >>> (0, 8, 8) in set(nx.local_bridges(G))
   True
Tc                 ó0   >• U T;  d  UT;  a	  T" XU5      $ g ©N© )ÚnÚnbrÚdÚenodesÚwts      €€r   Ú	hide_edgeÚ local_bridges.<locals>.hide_edgeÄ   s    ø€ Ø “¨#°VÓ*;Ù! !¨!›}Ð,Øó    )r#   ÚinfN)r   r   r   ÚweightedÚ_weight_functionÚshortest_path_lengthÚNetworkXNoPathÚfloat)	r   Ú	with_spanr#   r   r   r.   Úspanr,   r-   s	          @@r   r   r   �   sÎ   ùé € ðV ˜ÒØ—G”G‰DˆAÜ˜™“I¤ A¡D£	×)Ñ)Ø�d”
ò ô �[‰[×)Ñ)¨!Ó4ˆØ—G”G‰DˆAÜ˜™“I¤ A¡D£	×)Ñ)Ø˜�ö ð
-Ü×2Ò2°1¸ÑM�DØ ˜*Ô$ò øô ×(Ñ(ó -Ø¤ e£Ð,Õ,ð-üs5   „5C.½AC.Â
C.Â$CÂ?C.Ã#C+Ã'C.Ã*C+Ã+C.r'   )TN)Ú__doc__Ú	itertoolsr   Únetworkxr   Únetworkx.utilsr   Ú__all__Ú_dispatchabler   r   r   r(   r0   r   Ú<module>r?      s¡   ðÙ  å ã Ý .â
5€ñ �ZÓ Ø×ÑóCó ó !ðCñL �ZÓ Ø×Ñó7ó ó !ð7ñt �\Ó"Ù�ZÓ Ø×Ò˜XÑ&ó;-ó 'ó !ó #ñ;-r0   