o
    h'                     @   sj   d Z ddlZddlmZ ddlmZ ddgZedd	ejdd
dZdd Z	edd	ejdd Z
dS )z8Algorithms to calculate reciprocity in a directed graph.    N)NetworkXError   )not_implemented_forreciprocityoverall_reciprocity
undirected
multigraphc                 C   sL   |du rt | S || v rtt| |d }|du rtd|S tt| |S )af  Compute the reciprocity in a directed graph.

    The reciprocity of a directed graph is defined as the ratio
    of the number of edges pointing in both directions to the total
    number of edges in the graph.
    Formally, $r = |{(u,v) \in G|(v,u) \in G}| / |{(u,v) \in G}|$.

    The reciprocity of a single node u is defined similarly,
    it is the ratio of the number of edges in both directions to
    the total number of edges attached to node u.

    Parameters
    ----------
    G : graph
       A networkx directed graph
    nodes : container of nodes, optional (default=whole graph)
       Compute reciprocity for nodes in this container.

    Returns
    -------
    out : dictionary
       Reciprocity keyed by node label.

    Notes
    -----
    The reciprocity is not defined for isolated nodes.
    In such cases this function will return None.

    N   zNot defined for isolated nodes.)r   next_reciprocity_iterr   dict)Gnodesr    r   s/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/networkx/algorithms/reciprocity.pyr      s   !c           	      c   s|    |  |}|D ]3}t| |}t| |}||@ }t|t| }|dkr.|dfV  qdt| | }||fV  qdS )z*Return an iterator of (node, reciprocity).r   Nr   )nbunch_itersetpredecessors
successorslen)	r   r   nnodepredsuccoverlapn_totalr   r   r   r   r   =   s   
r   c                 C   s4   |   }||     d }|dkrtd|| S )zCompute the reciprocity for the whole graph.

    See the doc of reciprocity for the definition.

    Parameters
    ----------
    G : graph
       A networkx graph

    r   r   zNot defined for empty graphs)number_of_edgesto_undirectedr   )r   
n_all_edgen_overlap_edger   r   r   r   O   s
   )N)__doc__networkxnxr   utilsr   __all___dispatchabler   r   r   r   r   r   r   <module>   s    0