o
    ݐi'                     @   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_reciprocityZ
undirectedZ
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   n/var/www/html/eduruby.in/lip-sync/lip-sync-env/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   )Znbunch_itersetZpredecessors
successorslen)	r   r   nnodepredsuccoverlapZ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)Znumber_of_edgesZto_undirectedr   )r   Z
n_all_edgeZn_overlap_edger   r   r   r   O   s
   )N)__doc__Znetworkxnxr   utilsr   __all__Z_dispatchabler   r	   r   r   r   r   r   <module>   s    0