ó
    …~iú  ã                   óF   • S r SSKrS/r\R                  " SS9SS j5       rg)z
Flow Hierarchy.
é    NÚflow_hierarchyÚweight)Ú
edge_attrsc                 ó@  ^ ^• [         R                  " T 5      (       a  [         R                  " S5      eT R                  5       (       d  [         R                  " S5      e[         R                  " T 5      nS[        U U4S jU 5       5      T R                  T5      -  -
  $ )aq  Returns the flow hierarchy of a directed network.

Flow hierarchy is defined as the fraction of edges not participating
in cycles in a directed graph [1]_.

Parameters
----------
G : DiGraph or MultiDiGraph
   A directed graph

weight : string, optional (default=None)
   Attribute to use for edge weights. If None the weight defaults to 1.

Returns
-------
h : float
   Flow hierarchy value

Raises
------
NetworkXError
   If `G` is not a directed graph or if `G` has no edges.

Notes
-----
The algorithm described in [1]_ computes the flow hierarchy through
exponentiation of the adjacency matrix.  This function implements an
alternative approach that finds strongly connected components.
An edge is in a cycle if and only if it is in a strongly connected
component, which can be found in $O(m)$ time using Tarjan's algorithm.

References
----------
.. [1] Luo, J.; Magee, C.L. (2011),
   Detecting evolving patterns of self-organizing networks by flow
   hierarchy measurement, Complexity, Volume 16 Issue 6 53-61.
   DOI: 10.1002/cplx.20368
   http://web.mit.edu/~cmagee/www/documents/28-DetectingEvolvingPatterns_FlowHierarchy.pdf
z-flow_hierarchy not applicable to empty graphsz%G must be a digraph in flow_hierarchyé   c              3   ód   >#   • U  H%  nTR                  U5      R                  T5      v •  M'     g 7f©N)ÚsubgraphÚsize)Ú.0ÚcÚGr   s     €€ÚZ/home/mande/repo/quber/.venv/lib/python3.13/site-packages/networkx/algorithms/hierarchy.pyÚ	<genexpr>Ú!flow_hierarchy.<locals>.<genexpr>9   s'   øé € Ð;²s°!�1—:‘:˜a“=×%Ñ% f×-Ð-²sùs   ƒ-0)ÚnxÚis_emptyÚNetworkXErrorÚis_directedÚstrongly_connected_componentsÚsumr   )r   r   Úsccs   `` r   r   r   
   su   ù€ ôT 
‡{‚{�1‡~�~Ü×ÒÐNÓOÐOØ�=‰=�?‰?Ü×ÒÐFÓGÐGÜ
×
*Ò
*¨1Ó
-€CØŒsÕ;±sÓ;Ó;¸a¿f¹fÀV»nÑLÑLÐLó    r	   )Ú__doc__Únetworkxr   Ú__all__Ú_dispatchabler   © r   r   Ú<module>r      s8   ðñó àÐ
€ð ×Ò˜XÑ&ó.Mó 'ñ.Mr   