ó
    …~iÇ   ã                   ó  • S r SSKJr  SSKJr  SSKJr  SSKrSSK	J
r
  SSKJr  / S	Qr\R                  S
 5       rS r\
" S5      \
" S5      \R                  S 5       5       5       r\
" S5      \
" S5      \R                  S 5       5       5       rg)zI
=======================
Distance-regular graphs
=======================
é    )Údefaultdict)Úcombinations_with_replacement)ÚlogN)Únot_implemented_foré   )Údiameter)Úis_distance_regularÚis_strongly_regularÚintersection_arrayÚglobal_parametersc                 óP   •  [        U 5        g! [        R                   a     gf = f)a¥  Returns True if the graph is distance regular, False otherwise.

A connected graph G is distance-regular if for any nodes x,y
and any integers i,j=0,1,...,d (where d is the graph
diameter), the number of vertices at distance i from x and
distance j from y depends only on i,j and the graph distance
between x and y, independently of the choice of x and y.

Parameters
----------
G: Networkx graph (undirected)

Returns
-------
bool
  True if the graph is Distance Regular, False otherwise

Examples
--------
>>> G = nx.hypercube_graph(6)
>>> nx.is_distance_regular(G)
True

See Also
--------
intersection_array, global_parameters

Notes
-----
For undirected and simple graphs only

References
----------
.. [1] Brouwer, A. E.; Cohen, A. M.; and Neumaier, A.
    Distance-Regular Graphs. New York: Springer-Verlag, 1989.
.. [2] Weisstein, Eric W. "Distance-Regular Graph."
    http://mathworld.wolfram.com/Distance-RegularGraph.html

TF)r   ÚnxÚNetworkXError©ÚGs    Úa/home/mande/repo/quber/.venv/lib/python3.13/site-packages/networkx/algorithms/distance_regular.pyr	   r	      s+   € ðRÜ˜1ÔØøÜ×Ñó Ùðús   ‚ Ž%¤%c                 ó@   ^ • U 4S j[        T S/-   S/U-   5       5       $ )a  Returns global parameters for a given intersection array.

Given a distance-regular graph G with diameter d and integers b_i,
c_i,i = 0,....,d such that for any 2 vertices x,y in G at a distance
i=d(x,y), there are exactly c_i neighbors of y at a distance of i-1 from x
and b_i neighbors of y at a distance of i+1 from x.

Thus, a distance regular graph has the global parameters,
[[c_0,a_0,b_0],[c_1,a_1,b_1],......,[c_d,a_d,b_d]] for the
intersection array  [b_0,b_1,.....b_{d-1};c_1,c_2,.....c_d]
where a_i+b_i+c_i=k , k= degree of every vertex.

Parameters
----------
b : list

c : list

Returns
-------
iterable
   An iterable over three tuples.

Examples
--------
>>> G = nx.dodecahedral_graph()
>>> b, c = nx.intersection_array(G)
>>> list(nx.global_parameters(b, c))
[(0, 0, 3), (1, 0, 2), (1, 1, 1), (1, 1, 1), (2, 0, 1), (3, 0, 0)]

References
----------
.. [1] Weisstein, Eric W. "Global Parameters."
   From MathWorld--A Wolfram Web Resource.
   http://mathworld.wolfram.com/GlobalParameters.html

See Also
--------
intersection_array
c              3   óD   >#   • U  H  u  pUTS    U-
  U-
  U4v •  M     g7f)r   N© )Ú.0ÚxÚyÚbs      €r   Ú	<genexpr>Ú$global_parameters.<locals>.<genexpr>q   s(   øé € ÐCÒ-B¡T QˆQ��!‘�q‘˜1‘˜aÕ Ò-Bùs   ƒ r   )Úzip)r   Úcs   ` r   r   r   H   s%   ø€ ôR D¬S°°a°S±¸1¸#À¹'Ô-BÓCÐCó    ÚdirectedÚ
multigraphc                 ó’  ^^• [         R                  " U 5      (       a  [         R                  " U 5      (       d  [         R                  " S5      e[	        [
        5      n0 n0 nSnS[        [        U 5      S5      -  S-  n[        U S5       GHV  u  pgX   mUT;  aE  TR                  [         R                  " X5      5        TR                  5        H  u  p‰X‘U   U'   M     X   U   m[        UT5      nXE:”  a  [         R                  " S5      eX   n
U
 HS  nX   nXl;  d  M  UR                  [         R                  " X5      5        UR                  5        H  u  p‰X‘U   U'   M     MU     [        UU4S jU
 5       5      n[        UU4S jU
 5       5      nUR                  TU5      U:w  d  UR                  TU5      U:w  a  [         R                  " S5      eXâT'   XÓT'   GMY     [        U5       Vs/ s H  oòR                  US5      PM     sn[        U5       Vs/ s H  oóR                  US	-   S5      PM     sn4$ s  snf s  snf )
a(  Returns the intersection array of a distance-regular graph.

Given a distance-regular graph G with integers b_i, c_i,i = 0,....,d
such that for any 2 vertices x,y in G at a distance i=d(x,y), there
are exactly c_i neighbors of y at a distance of i-1 from x and b_i
neighbors of y at a distance of i+1 from x.

A distance regular graph's intersection array is given by,
[b_0,b_1,.....b_{d-1};c_1,c_2,.....c_d]

Parameters
----------
G: Networkx graph (undirected)

Returns
-------
b,c: tuple of lists

Examples
--------
>>> G = nx.icosahedral_graph()
>>> nx.intersection_array(G)
([5, 2, 1], [1, 2, 5])

References
----------
.. [1] Weisstein, Eric W. "Intersection Array."
   From MathWorld--A Wolfram Web Resource.
   http://mathworld.wolfram.com/IntersectionArray.html

See Also
--------
global_parameters
zGraph is not distance regular.r   é   é   é   c              3   óD   >#   • U  H  nTU   TS -
  :X  d  M  S v •  M     g7f©r   Nr   ©r   ÚnÚiÚpl_us     €€r   r   Ú%intersection_array.<locals>.<genexpr>Ë   ó"   øé € Ð5š5�a D¨¡G¨q°1©uÑ$4—‘š5ùó   ƒ —	 c              3   óD   >#   • U  H  nTU   TS -   :X  d  M  S v •  M     g7fr&   r   r'   s     €€r   r   r+   Í   r,   r-   zGraph is not distance regularr   )r   Ú
is_regularÚis_connectedr   r   Údictr   Úlenr   ÚupdateÚ"single_source_shortest_path_lengthÚitemsÚmaxÚsumÚgetÚrange)r   Úpath_lengthÚbintÚcintÚdiamÚmax_diameter_for_dr_graphsÚuÚvr   ÚdistanceÚvnbrsr(   Úpl_nr   r   Újr)   r*   s                   @@r   r   r   t   sÿ  ù€ ôd �=Š=˜×Ñ¤2§?¢?°1×#5Ñ#5Ü×ÒÐ?Ó@Ð@äœdÓ#€KØ€DØ€Dð
 €DØ"#¤c¬#¨a«&°!£nÑ"4¸Ñ!9ÐÜ-¨a°×3‰ˆà‰~ˆØ�D‹=Ø�K‰Kœ×=Ò=¸aÓCÔDØ#Ÿz™zž|‘�Ø$,˜A‘˜qÓ!ñ  ,ð ‰N˜1ÑˆÜ�4˜‹|ˆð Ó,Ü×"Ò"Ð#CÓDÐDà‘ˆãˆAØ‘>ˆDØ�}Ø—‘œB×AÒAÀ!ÓGÔHØ#'§:¡:¦<‘K�AØ(0 ‘N 1Ó%ó $0ñ	 ô Õ5™5Ó5Ó5ˆäÕ5™5Ó5Ó5ˆà�8‰8�A�q‹>˜QÓ $§(¡(¨1¨a£.°AÓ"5Ü×"Ò"Ð#BÓCÐCØˆQ‰ØˆQŒñA 4ôF "' t¤Ó-¢˜A�‰�!�QŽ¡Ñ-Ü%*¨4¤[Ó1¢[ �‰�!�a‘%˜Ö	¡[Ñ1ðð ùÚ-ùÚ1s   Ç3H?ÈIc                 óB   • [        U 5      =(       a    [        U 5      S:H  $ )a«  Returns True if and only if the given graph is strongly
regular.

An undirected graph is *strongly regular* if

* it is regular,
* each pair of adjacent vertices has the same number of neighbors in
  common,
* each pair of nonadjacent vertices has the same number of neighbors
  in common.

Each strongly regular graph is a distance-regular graph.
Conversely, if a distance-regular graph has diameter two, then it is
a strongly regular graph. For more information on distance-regular
graphs, see :func:`is_distance_regular`.

Parameters
----------
G : NetworkX graph
    An undirected graph.

Returns
-------
bool
    Whether `G` is strongly regular.

Examples
--------

The cycle graph on five vertices is strongly regular. It is
two-regular, each pair of adjacent vertices has no shared neighbors,
and each pair of nonadjacent vertices has one shared neighbor::

    >>> G = nx.cycle_graph(5)
    >>> nx.is_strongly_regular(G)
    True

r#   )r	   r   r   s    r   r
   r
   Û   s   € ôj ˜qÓ!×6¤h¨q£k°QÑ&6Ð6r   )Ú__doc__Úcollectionsr   Ú	itertoolsr   Úmathr   Únetworkxr   Únetworkx.utilsr   Údistance_measuresr   Ú__all__Ú_dispatchabler	   r   r   r
   r   r   r   Ú<module>rO      s²   ðñõ $Ý 3Ý ã Ý .å 'ò€ð ×Ññ,ó ð,ò^)DñX �ZÓ Ù�\Ó"Ø×Ññ`ó ó #ó !ð`ñH �ZÓ Ù�\Ó"Ø×Ññ27ó ó #ó !ñ27r   