+
    )i                     t    R t ^ RIt^ RIHt R.t]! R4      ]! R4      ]P                  R 4       4       4       tR# )zProvides a function for computing the extendability of a graph which is
undirected, simple, connected and bipartite and contains at least one perfect matching.N)not_implemented_formaximal_extendabilitydirected
multigraphc           
        \         P                  ! V 4      '       g   \         P                  ! R4      h\         P                  P	                  V 4      '       g   \         P                  ! R4      h\         P                  P                  V 4      w  r\         P                  P                  V 4      p\         P                  ! W4      '       g   \         P                  ! R4      hW#P                  4       ,           Uu. uF  qDW4,          3NK  	  ppV P                   UUu. uF'  w  rgWb9   d	   Wg3V9   g   Wa9   d   Wv3V9  d   Wg3MWv3NK)  	  ppp\         P                  ! 4       p	V	P                  V 4       V	P                  V4       \         P                  ! V	4      '       g   \         P                  ! R4      h\        R4      p
V F=  pV F4  p\        R \         P                   ! WV4       4       4      pW8  d   T
MTp
K6  	  K?  	  V
# u upi u uppi )u  Computes the extendability of a graph.

The extendability of a graph is defined as the maximum $k$ for which `G`
is $k$-extendable. Graph `G` is $k$-extendable if and only if `G` has a
perfect matching and every set of $k$ independent edges can be extended
to a perfect matching in `G`.

Parameters
----------
G : NetworkX Graph
    A fully-connected bipartite graph without self-loops

Returns
-------
extendability : int

Raises
------
NetworkXError
   If the graph `G` is disconnected.
   If the graph `G` is not bipartite.
   If the graph `G` does not contain a perfect matching.
   If the residual graph of `G` is not strongly connected.

Notes
-----
Definition:
Let `G` be a simple, connected, undirected and bipartite graph with a perfect
matching M and bipartition (U,V). The residual graph of `G`, denoted by $G_M$,
is the graph obtained from G by directing the edges of M from V to U and the
edges that do not belong to M from U to V.

Lemma [1]_ :
Let M be a perfect matching of `G`. `G` is $k$-extendable if and only if its residual
graph $G_M$ is strongly connected and there are $k$ vertex-disjoint directed
paths between every vertex of U and every vertex of V.

Assuming that input graph `G` is undirected, simple, connected, bipartite and contains
a perfect matching M, this function constructs the residual graph $G_M$ of G and
returns the minimum value among the maximum vertex-disjoint directed paths between
every vertex of U and every vertex of V in $G_M$. By combining the definitions
and the lemma, this value represents the extendability of the graph `G`.

Time complexity O($n^3$ $m^2$)) where $n$ is the number of vertices
and $m$ is the number of edges.

References
----------
.. [1] "A polynomial algorithm for the extendability problem in bipartite graphs",
      J. Lakhal, L. Litzler, Information Processing Letters, 1998.
.. [2] "On n-extendible graphs", M. D. Plummer, Discrete Mathematics, 31:201–210, 1980
      https://doi.org/10.1016/0012-365X(80)90037-0

zGraph G is not connectedzGraph G is not bipartitez+Graph G does not contain a perfect matchingz1The residual graph of G is not strongly connectedinfc              3   &   "   T F  p^x  K	  	  R# 5i)   N ).0_s   & i/var/www/html/photoedit/myenv/lib/python3.14/site-packages/networkx/algorithms/bipartite/extendability.py	<genexpr>(maximal_extendability.<locals>.<genexpr>g   s     P'O!A'Os   )nxis_connectedNetworkXError	bipartiteis_bipartitesetshopcroft_karp_matchingis_perfect_matchingkeysedgesDiGraphadd_nodes_fromadd_edges_fromis_strongly_connectedfloatsumnode_disjoint_paths)GUVmaximum_matchingnodepmxydirected_edges
residual_Gkuv	num_pathss   &             r   r   r   
   s   t ??19::<<$$Q''9::<<QDA||::1=!!!66LMM 679N9N9P5P	Q5PT!'
(5PB	Q
 GGDA 6qflA6;KSTRXX   Ja n-##J//RSS 	eAAPr'='=jQ'OPPI]	A   H/ 
Rs   8H-H	)__doc__networkxr   networkx.utilsr   __all___dispatchabler   r
       r   <module>r5      sQ   [  ."
# Z \"\  # !\r4   