o
    ¦ƒðjrÉ  ã                   @   s‚  d dl mZ ddlmZmZ dd„ ZdZeg dfdd	„ƒZed
d„ ƒZedd„ ƒZ	edd„ ƒZ
edd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZed d!„ ƒZd"d#„ Zed$d%„ ƒZed&d'„ ƒZed(d)„ ƒZed*d+„ ƒZed,d-„ ƒZed.d/„ ƒZed0d1„ ƒZedAd3d4„ƒZed5d6„ ƒZed7d8„ ƒZed9d:„ ƒZed;d<„ ƒZ ed=d>„ ƒZ!	 ed?d@„ ƒZ"d2S )Bé   )Úxrangeé   )ÚdefunÚdefun_wrappedc                 C   sr  d }}d}g }t |ƒD ]¦\}}	|	\}
}}}}}}d}t |
ƒD ]\}}|s8|  || ¡dkr8|| r8d }}d}qg d¢}t |||gƒD ]O\}}t |ƒD ]F\}}|  |¡\}}|dkr\qL|| jkr‡d}|dkr{|D ]}|  |¡rz|t|ƒkrzd} nqi|r~qL||  d7  < qL|dk r’|| 7 }d}qLqD|rª|d |d |d  krª|sª| |¡ qt|ƒr²d }}q||||fS )NFé    T)r   r   r   r   r   éüÿÿÿ)Ú	enumerateÚreÚnint_distanceÚninfÚisnpintÚintÚappendÚsum)ÚctxÚtermsÚprecÚdiscard_known_zerosÚperturbÚ	recomputeÚ	extraprecÚdiscardÚ
term_indexÚtermÚw_sÚc_sÚalpha_sÚbeta_sÚa_sÚb_sÚzÚhave_singular_nongamma_weightÚkÚwÚ
pole_countÚ
data_indexÚdataÚiÚxÚnÚdÚokÚu© r-   ú¡/tmp/claude-1000/-var-www-html-academy/3f42efd1-c2b7-4d08-9b05-30d86bb35479/scratchpad/piper/venv/lib/python3.10/site-packages/mpmath/functions/hypergeometric.pyÚ_check_need_perturb   sT   €
€
€êÿ€r/   a  
hypercomb() failed to converge to the requested %i bits of accuracy
using a working precision of %i bits. The function value may be zero or
infinite; try passing zeroprec=N or infprec=M to bound finite values between
2^(-N) and 2^M. Otherwise try a higher maxprec or maxterms.
Tc           +         sî  ˆ j }ˆ j}ˆ j}ˆ j}|d d … }	| dd¡}
| dˆ  |¡¡}||d< | d¡}| d¡}d }d}�z>	 ˆ  j d7  _ ˆ j |krKtt|ˆ j f ƒ‚ˆ j }|	d d … }||Ž }|
rltƒ  td	ƒ td
ˆ j ƒ td|ƒ t	ˆ |||ƒ\}}}‰ˆ  j |7  _ |rÄd|v r‰|d }nˆ j
r”tˆ j d ƒ}n|d | }ˆ  ˆ j| ¡}|d | d ˆ _ tt|ƒƒD ]}||  |7  < |||d  7 }q±|rÊ||Ž }|r×‡fdd„t|ƒD ƒ}|sàˆ jW |ˆ _ S g }t|ƒD ]‹\}}|\}}}}}} }!|
�r7tƒ  td|d t|ƒt|ƒt| ƒf ƒ tdˆ  |¡ˆ  |¡ƒ tdˆ  |¡ˆ  |¡ƒ tdˆ  |¡ˆ  | ¡ƒ tdˆ  |!¡ƒ ˆ  ˆ j|| |!fi |¤Žg‡ fdd„|D ƒ ‡ fdd„|D ƒ ‡ fdd„t||ƒD ƒ ¡}"|
�rltd|"ƒ | |"¡ qæt|ƒdk�r�|�s�|d }nÁˆ j
�r‹ˆ  |¡}n¾ˆ  |¡}‡ fdd„|D ƒ}#t|#ƒ}$ˆ  |¡}%|$|% }&|
�r»tƒ  td|&dƒ tdˆ j | dƒ |&ˆ j | k }'|d u �rÊd}(n|$ˆ j  | k }(|d u �rÚd})n|$|k})|'�rä|�rêˆ  |&¡�rëne|'�r%|d u �rú|d7 }|}q5ˆ  || ¡ˆ  |¡| k�r
nM|(�rˆ j}nM|)�rˆ j}nMd|v �rnN|d9 }|}ntt|&|d ƒt||ƒƒ}*ˆ  j |*7  _ |
�r@tdƒ q5q6W |ˆ _ |
 S W |ˆ _ |
 S W |ˆ _ |
 S W |ˆ _ |
 S W |ˆ _ |
 S W |ˆ _ |
 S W |ˆ _ |
 S |ˆ _ w ) NÚverboseFÚmaxprecÚzeroprecÚinfprecr   r   é
   zENTERING hypercomb main loopzprec =ÚhextraÚhmagg333333Ó?c                    s   g | ]
\}}|ˆ vr|‘qS r-   r-   )Ú.0r'   r   )r   r-   r.   Ú
<listcomp>k   ó    zhypercomb.<locals>.<listcomp>z  Evaluating term %i/%i : %iF%iz
    powersz	    gammaz	    hyperz    zc                    ó   g | ]}ˆ   |¡‘qS r-   )Úgamma©r7   Úa©r   r-   r.   r8   ~   ó    c                    r:   r-   )Úrgamma©r7   Úbr>   r-   r.   r8      r?   c                    s   g | ]
\}}ˆ   ||¡‘qS r-   )Úpower)r7   r#   Úcr>   r-   r.   r8   €   r9   z
    Value:c                    r:   r-   )Úmag)r7   r(   r>   r-   r.   r8   Ž   r?   z  Cancellation:Úbitsz  Increased precision:é   r   z*  Must start over with increased precision)r   Úzeror
   r   ÚgetÚ_default_hyper_maxprecÚ
ValueErrorÚ_hypercomb_msgÚprintr/   Ú_fixed_precisionr   ÚldexpÚoneÚrangeÚlenr   ÚnstrÚfprodÚhyperÚzipr   ÚfsumÚmaxrE   ÚisnanÚinfÚmin)+r   ÚfunctionÚparamsr   ÚkwargsÚorigÚsumvalueÚdistr   Úorig_paramsr0   r1   r2   r3   Úperturbed_reference_valuer5   Úorig2r   r   r   r   r6   Úhr"   Úevaluated_termsr   Ú	term_datar   r   r   r   r   r   r    ÚvÚterm_magnitudesÚmax_magnitudeÚsum_magnitudeÚcancellationÚprecision_okÚzero_okÚinf_okÚ	incrementr-   )r   r   r.   Ú	hypercomb:   s  




ÿ
R¯ÿÿþý






ÿ
Œ>8Ë4ãëîñóÿrq   c                    sd  ˆ   |¡}t|ƒ}t|ƒ}‡ fdd„|D ƒ}‡ fdd„|D ƒ}| dd¡ra| dd¡}d}||k ra|ra|| }	|	|v rW|sDˆ  |	d ¡sW| |	¡ | |	¡ |d	8 }|d	8 }n|d	7 }||k ra|s3|dkr}|d	krsˆ j||fi |¤ŽS |dkr|ˆ  |¡S n |d	kr®|d	kr�ˆ j|||fi |¤ŽS |d
krŸˆ j|||fi |¤ŽS |dkr­ˆ  	|d d |¡S no|d
krï|d	krÁˆ j
|||fi |¤ŽS |d
krÐˆ j|||fi |¤ŽS |dkrßˆ j|||fi |¤ŽS |dkrîˆ j|||fi |¤ŽS n.||d	 k�rˆ j|||||fi |¤ŽS ||d	 k�r| d¡�sˆ j|||||fi |¤ŽS t|| Ž \}
}ˆ j||||
|fi |¤ŽS )z0
    Hypergeometric function, general case.
    c                    r:   r-   ©Ú_convert_paramr<   r>   r-   r.   r8   Ê   r?   zhyper.<locals>.<listcomp>c                    r:   r-   rr   rA   r>   r-   r.   r8   Ë   r?   Ú	eliminateTÚeliminate_allFr   r   r   é   Úforce_series)ÚconvertrR   rI   r   ÚremoveÚ_hyp0f1ÚexpÚ_hyp1f1Ú_hyp1f2Ú_hyp1f0Ú_hyp2f1Ú_hyp2f2Ú_hyp2f3Ú_hyp2f0Ú_hypq1fqÚ
_hyp_borelrV   Úhypsum)r   r   r   r    r^   ÚpÚqÚelim_nonpositiver'   rB   ÚcoeffsÚtypesr-   r>   r.   rU   Â   sF   



ø
 rU   c                 K   s   | j g |g|fi |¤ŽS ©N©rU   )r   rB   r    r^   r-   r-   r.   Úhyp0f1í   s   r�   c                 K   s   | j |g|g|fi |¤ŽS r‹   rŒ   ©r   r=   rB   r    r^   r-   r-   r.   Úhyp1f1ñ   ó   r�   c                 K   s   | j |g||g|fi |¤ŽS r‹   rŒ   )r   Úa1Úb1Úb2r    r^   r-   r-   r.   Úhyp1f2õ   ó   r”   c                 K   s   | j ||g|g|fi |¤ŽS r‹   rŒ   )r   r=   rB   rD   r    r^   r-   r-   r.   Úhyp2f1ù   r•   r–   c                 K   s   | j ||g||g|fi |¤ŽS r‹   rŒ   )r   r‘   Úa2r’   r“   r    r^   r-   r-   r.   Úhyp2f2ý   s   r˜   c                 K   s    | j ||g|||g|fi |¤ŽS r‹   rŒ   )r   r‘   r—   r’   r“   Úb3r    r^   r-   r-   r.   Úhyp2f3  ó    rš   c                 K   s   | j ||gg |fi |¤ŽS r‹   rŒ   rŽ   r-   r-   r.   Úhyp2f0  r�   rœ   c                 K   s    | j |||g||g|fi |¤ŽS r‹   rŒ   )r   r‘   r—   Úa3r’   r“   r    r^   r-   r-   r.   Úhyp3f2	  r›   rž   c                 C   s   d| |  S ©Nr   r-   )r   r=   r    r-   r-   r.   r~     s   r~   c           	         sø   |\\‰ }ˆrˆ  ˆ¡}nd}|dkrm| d¡smzJˆj}z/ˆ jd|d  7  _‡ ‡‡fdd„}ˆj|g dd	�}ˆ ˆ ¡dˆ ˆj¡  | }W |ˆ_n|ˆ_w ˆ ˆ ¡r_ˆ ˆ¡r_ˆ |¡}|
 W S  ˆj	yl   Y nw ˆj
dd
|fˆ gˆfi |¤ŽS )Nr   é   rw   é   r   c                     sš   ˆ  ˆ ¡} ˆj|  }dd|  }ˆjˆ  }ˆ d| ¡}| |g|dgg g ˆ ˆj ˆjˆ  gg | f}||g|dgg g ˆ ˆj ˆjˆ  gg |f}||fS )Nr   é   r   éÿÿÿÿ)ÚsqrtÚjÚmpq_1_2r{   Úmpq_3_2)r#   Újwr,   rD   ÚEÚT1ÚT2©rB   r   r    r-   r.   re   !  s   

.*z_hyp0f1.<locals>.hT©rw   r   )rE   rI   r   rq   r;   r¤   ÚpiÚ_is_real_typeÚ_reÚNoConvergencer…   )	r   r   r    r^   ÚbtypeÚmagzr_   re   rh   r-   r¬   r.   rz     s(   
	 
ÿrz   c              	      sv  |\\}}|\\}}ˆsˆ j ˆ S ˆ  ˆ¡}	|	dkr¨ˆ  |¡r&ˆ  |¡dks¨ˆ  ˆ¡rKˆ  |¡ˆ  |¡  krEˆ  ˆ¡  krEdkrFˆ jS  ˆ jˆ S zTz@ˆ  j|	7  _ˆ  	ˆ¡dk ‰‡ ‡‡fdd„}
ˆ j
|
||gdd�}ˆ  |¡r�ˆ  |¡r�ˆ  ˆ¡r�ˆ  |¡}|
 W W ˆ  j|	8  _S  ˆ jy–   Y nw W ˆ  j|	8  _nˆ  j|	8  _w ˆ jdd||f||gˆfi |¤Ž}|S )Né   r   r   c                    sš   ˆrˆ   ˆ j| dd�¡}nˆ   | ¡}dˆ }|ˆgd|  g|g||  g| d|  | gg | f}ˆ  ˆ¡ˆgd| | g|g| g||  d|  gg |f}||fS )NT©Úexactr   )ÚexpjpiÚfnegr{   )r=   rB   r©   Úrzrª   r«   ©r   Úsectorr    r-   r.   re   E  s   
24z_hyp1f1.<locals>.hTr­   )rP   rE   Úisintr	   ÚisinfÚsignrZ   Únanr   Ú_imrq   r¯   r°   r±   r…   )r   r   r   r    r^   r=   ÚatyperB   r²   r³   re   rh   r-   rº   r.   r|   5  s8   



 
.ÿ
	
ýÿ "r|   c           %      K   sè  ||||f\}}}}	| j }
| dd|
 ¡}d}	 |
| | _ |  |	¡}|  d¡}|  d¡}|  d¡}d}|| | }|| j }|d | j }d| }|| }|| | }|| | }|d }| j  d }| j}| j}| j}| j}	 || }|| ||  | d|d  | ||   }|||| | |   } ||| || |   }!|||| ||  |  |  d| |  }"|| |" }#t	|||#ƒƒ}||#| ƒ|k rÎn| |!|#}}}|d7 }qp|||#ƒ }$|$|k rè	 |#S ||$7 }||kró| j
‚q)Nr1   éd   r4   r   r   r   r¢   )r   rI   rx   Úmpfr¦   rS   ÚnprintrE   r   rX   r±   )%r   r=   rB   rD   r    r^   Ú_aÚ_bÚ_cÚ_zr_   r1   Úextrar*   ÚeÚfr"   ÚabzÚchÚc1hÚnzÚgÚabgÚcbaÚz2ÚtolrS   rÄ   rE   ÚmaxmagÚkchÚkakbzÚd1Úe1ÚftÚf1rl   r-   r-   r.   Ú_hyp2f1_gosperY  sZ   





,,õýÔrÜ   c                    s  |\\}}\}}|\\‰ }	ˆdkr„ˆ  ˆ | | ¡dk}
ˆ |¡r%|dkp-ˆ |¡o-|dk}ˆ ˆ ¡oYˆ dkoYˆ |¡rHˆ |  koEdkn  pXˆ |¡oXˆ |  koVdkn   }|
s^|rt|stˆjˆ ˆ | | gˆ | ˆ | gdd�S ˆ ||ˆ dˆjd  ¡ˆj S ˆs—ˆ s�|dks�|dkr”dˆ S ˆjS ˆ ˆ ¡rÇˆ dkrÇˆ |¡r°ˆ |  kr¯dksÃn ˆ |¡rÄˆ |  kr¿dkrÄn ˆjS nˆjS tˆƒ}|dkséˆ |¡rÜ|dkrÜ|dkséˆ |¡rü|dkrü|dkrüˆjdd|||	f||ˆ gˆfi |¤ŽS ˆj	}z†ˆ j	d7  _	|d	k�r!‡ ‡‡fd
d„}ˆj
|||gfi |¤Ž}nPtdˆ ƒdk�r>‡ ‡fdd„}ˆj
|||gfi |¤Ž}n:tˆˆd  ƒdk�r^ˆ |ˆ | ˆ ˆˆd  ¡dˆ |  }n!tˆ||ˆ ˆfi |¤Ž}W |ˆ_	|
 S W |ˆ_	|
 S W |ˆ_	|
 S W |ˆ_	|
 S |ˆ_	w )Nr   r   T)Ú_infsignr   gš™™™™™é?iüÿÿr4   gÍÌÌÌÌÌô?c                    s�   ˆj ˆ  }| | }dˆ }ˆ g|  gˆ | g|ˆ |  g| ||  gˆj | g|f}ˆ g| gˆ |g| ˆ | g||| gˆj | g|f}||fS rŸ   )Úmpq_1)r=   rB   ÚtÚabr¹   rª   r«   ©rD   r   r    r-   r.   re   Ã  s   86z_hyp2f1.<locals>.hg      è?c                    s€   ˆ |  | }ˆ |  }ˆ | }dˆ }g g ˆ |g||g| |gd| g|f}|g|gˆ | | ˆ  g| |g||gd| g|f}||fS rŸ   r-   )r=   rB   rß   ÚcaÚcbr¹   rª   r«   )rD   r    r-   r.   re   Ì  s   $$0)r	   r¼   Ú	gammaprodr–   ÚepsrZ   r¿   Úabsr…   r   rq   rÜ   )r   r   r   r    r^   r=   rÁ   rB   r²   ÚctypeÚ
convergentÚfiniteÚzerodivÚabszr_   re   rh   r-   rá   r.   r   �  sj   
$Bÿ(  ÿý"ÿ&
*ëôøÿr   c              
      sº  t ˆŽ \‰}t ˆŽ \‰}tˆƒ‰tˆƒ‰tˆƒ}	d}
ˆD ]}ˆ |¡r+|dkr+d}
 nq|	dk s2|
rVzˆjˆ	ˆ
|| ˆˆ ˆfi |¤ŽW S  ˆjyU   |	dksR|
rS‚ Y nw ˆdkrwˆ tˆƒtˆƒ ¡}|dkrwˆjˆˆdfi |¤Žˆj	 S ˆ	ˆ
fdkrætˆd ƒdk ræˆ\‰ ‰‰ˆ\‰‰ˆˆ ˆ }ˆ 
ˆˆ ˆˆ ˆ ˆgˆˆ ˆˆ d|g¡}d|if‡ ‡‡‡‡‡‡fd	d
„	‰z!ˆjˆdˆj	g| d¡| dd¡d�}|ˆ 
ˆˆgˆ ˆˆg¡ W S  ˆjyå   Y nw |	dk �rÈˆ ˆ¡dk�rÈdˆjif‡‡‡‡	‡
‡‡fdd
„	‰| dd¡}zˆjˆdˆj	g| d¡| dd¡| dd¡d�W S  ˆj�y4   d|v�r2‚ Y nw | d¡�r?tdƒ 	 ‡‡‡‡fdd„‰‡‡‡‡fdd„}ˆjd }ˆj}zidˆj }ˆ jd7  _tdƒD ]J}ˆ ‡fdd„t|ƒD ƒ¡}ˆjˆ|ˆj	g|||ƒ| d¡ddd�\}}||k �rœ|| } n!|d 9 }ˆ jˆjd  7  _|d!k�r´ˆ d"¡‚�qkW |ˆ_|
 S W |ˆ_|
 S |ˆ_w ‡‡	‡
‡fd#d$„}ˆj|ˆˆ fi |¤ŽS )%z&
    Evaluates 3F2, 4F3, 5F4, ...
    Fr   Tr   gš™™™™™ñ?gÍÌÌÌÌÌì?)rv   r   gš™™™™™©?c                    s~   ˆˆ ˆ |  }| |v r||  }n$|| d  }|ˆ|  ˆ d ˆ|  ˆ d  9 }|| |d   }||| < |ˆ  ˆ ˆ|ˆ¡ S rŸ   )r–   )r"   Ú_cacher,   rß   )r‘   r—   r�   r’   r“   r   r    r-   r.   r     s   
$z_hypq1fq.<locals>.termr0   Ústrict)r0   rí   c                    sÜ   t | ƒ}|| kr0ˆˆ | ¡ ˆ | ¡ }ˆ D ]
}|ˆ || ¡9 }qˆD ]
}|ˆ || ¡ }q#|S ||v r8|| S ˆ|d ƒ}|d }tˆƒD ]
}|ˆ | | 9 }qFtˆƒD ]
}|ˆ| |  }qU|ˆ9 }|| }|||< |S rŸ   )r   rÃ   ÚfacÚrfr   )Úkkrì   r"   rß   r=   rB   Úmr¥   )r   r   r   r†   r‡   r   r    r-   r.   r   '  s    Ú
sum_methodzr+s+erÊ   Ú )r0   rí   Úmethodz$Attempting Euler-Maclaurin summationc                 3   s¬   � ˆdg }t ‡‡fdd„ˆD ƒƒt ‡‡fdd„|D ƒƒ ˆˆ ˆ¡  V  d‰ 	 t ‡‡ ‡fdd„ˆD ƒƒt ‡‡ ‡fdd„|D ƒƒ }ˆ dkrN|ˆ ˆ¡7 }|V  ˆ d7 ‰ q))Nr   c                 3   ó   � | ]
}ˆ   |ˆ ¡V  qd S r‹   ©Úloggammar<   ©r   Úk0r-   r.   Ú	<genexpr>i  ó   € z._hypq1fq.<locals>.log_diffs.<locals>.<genexpr>c                 3   rõ   r‹   rö   rA   rø   r-   r.   rú   j  rû   r   c                 3   ó    � | ]}ˆ   ˆ|ˆ ¡V  qd S r‹   ©Úpsir<   ©r   r'   rù   r-   r.   rú   m  ó   € c                 3   rü   r‹   rý   rA   rÿ   r-   r.   rú   n  r   )r   Úlog)rù   r“   rh   ©r   r   r   r    )r'   rù   r.   Ú	log_diffsg  s"   €
ÿÿÿúz_hypq1fq.<locals>.log_diffsc                 3   sH   � ˆ  dd„ ˆD ƒdd„ ˆ D ƒ¡}ˆ ˆ| ƒ¡D ]	}|| }|V  qd S )Nc                 S   ó   g | ]}|‘qS r-   r-   rA   r-   r-   r.   r8   u  ó    z1_hypq1fq.<locals>.hyper_diffs.<locals>.<listcomp>c                 S   r  r-   r-   r<   r-   r-   r.   r8   u  r  )rä   Ú	diffs_exp)rù   ÚCr*   rh   )r   r   r   r  r-   r.   Úhyper_diffst  s   € þz_hypq1fq.<locals>.hyper_diffsi   é2   rG   é   c                 3   s   � | ]}ˆ |ƒV  qd S r‹   r-   )r7   r"   )r   r-   r.   rú   €  s   € z_hypq1fq.<locals>.<genexpr>)rÔ   Úadiffsr0   ÚerrorÚ_fast_abortr   r¢   z*Euler-Maclaurin summation did not convergec            
   
      s   t | d ˆ… ƒ‰ t | ˆd … ƒ‰g }ˆjˆ }ˆjˆdd�}tˆd ƒD ]Y‰ˆ ˆ ‰|g}ˆ g}ˆˆg ‡ ‡‡fdd„tˆd ƒD ƒ }ˆ ‡‡fdd„tˆƒD ƒ }ˆg‡‡fdd„tˆƒD ƒ }‡ ‡‡fdd„tˆd ƒD ƒ}	| ||||||	|f¡ q$|S )	NTrµ   r   c                    s    g | ]}|ˆkrˆ | ˆ ‘qS r-   r-   ©r7   r¥   ©r   Úakr"   r-   r.   r8   ¡  ó     z'_hypq1fq.<locals>.h.<locals>.<listcomp>c                    s   g | ]}ˆ| ˆ  ‘qS r-   r-   r  ©r  r   r-   r.   r8   ¢  s    c                    s   g | ]
}ˆ ˆ|  d  ‘qS ©r   r-   r  r  r-   r.   r8   £  r9   c                    s$   g | ]}|ˆkrd ˆ |  ˆ ‘qS r  r-   r  r  r-   r.   r8   ¤  ó   $ )ÚlistrP   r¸   rQ   r   )
ÚargsÚTsÚreczÚnegzr  ÚCpÚGnÚGdÚFnÚFd)r   r†   r‡   r    )r   r  r   r"   r.   re   —  s   
(z_hypq1fq.<locals>.h)rV   r  ræ   r¼   r…   r±   r	   r   rU   rZ   rä   ÚnsumrI   r°   rP   ÚreplacerM   rå   r   Údpsr   rW   Úsumemrq   )r   r†   r‡   r   r   r    r^   Úa_typesÚb_typesrë   Úispolyr=   ÚSr,   Úinitialrò   r  rÔ   r   Útruncr'   ÚheadÚtailÚerrrh   re   r-   )r‘   r—   r�   r   r’   r“   r   r   r  r†   r‡   r   r    r.   rƒ   ß  s®   €$ÿÿ
, 

ÿÿ"

þ
ý


ü

ÿÿòö	ÿrƒ   c                    s  ˆ rt ˆ Ž \‰ }tˆ ƒ‰ ng d‰ }ˆrt ˆŽ \‰}tˆƒ‰ng d‰}| dˆj¡|d< zˆj|||| ˆ ˆ ˆfi |¤ŽW S  ˆjyI   Y nw ˆj}	zE| dˆjd ¡}
ˆ jd7  _dˆjif‡ ‡‡‡fdd„	‰ˆj}td	ˆjƒD ]}ˆ|ƒ}||7 }t	|ƒ|
kr�|  W |	ˆ_S quW |	ˆ_n|	ˆ_w ||d
 k�r| d¡}|sÛˆ 
ˆ¡dk rÖˆtd	t	ˆƒƒ }ˆ 
ˆ¡dkrÉddd| d| ˆjg}nddd| d| ˆjg}ndˆjg}| di ¡}‡ ‡‡‡fdd„}ˆj||fddi|¤Ž\}}|t	|ƒˆj d k�r|S ˆj‚)Nr-   ÚmaxtermsÚ	asymp_tolr¢   r4   r   c                    sl   | |v r||  S ˆ| d ƒ}ˆ D ]
}||| d  9 }qˆD ]
}||| d   }q|ˆ9 }||  }||| < |S rŸ   r-   )r"   Úcacherß   r=   rB   )r   r   r   r    r-   r.   r   ¿  s   z_hyp_borel.<locals>.termr   rv   Úcontourg      Ð?y               @y       @       @r   y       €       Ày       @       ÀÚquad_kwargsc                    s$   ˆ  |  ¡ˆ ˆ ˆdg | ˆ ¡ S rŸ   )r{   rU   )rß   r  r-   r.   rÐ   à  s   $z_hyp_borel.<locals>.gr  Tr    )rV   r  rI   r   r…   r±   rå   rP   r   ræ   ÚargrX   rZ   Úquad)r   r†   r‡   r   r   r    r^   r#  r$  r   rÔ   Úsr"   rß   r/  r,   r0  rÐ   ÚIr+  r-   )r   r   r   r   r    r.   r„   ©  sX   



$ÿ
ýý

r„   c                    s&  |\\}}\}}|\\}	}
\}}t ˆƒ}ˆ  ˆ¡}ˆ j}|}| d¡ o*ˆ  |¡dk}|r~zLz<ˆ  j|7  _‡ ‡fdd„}ˆ j||||	|gddˆ j d�}t‡ fdd	„|||	|ˆfD ƒƒd
krdˆ  |¡}|W W |ˆ _S  ˆ jyt   Y nw W |ˆ _n|ˆ _w ˆ jdd|||
|f|||	|gˆfi |¤ŽS )Nrw   rv   c                    sh  | | | | }| | }|| }i }ˆ j |d< |d | ||  | |  |d< d}d}	d}
	 |	|vr‘d| d|   | d  d|  |d  ||  | |  ||  d| d|d   |	  d|	d   }|	| | d |	| | d  |	| d  }ˆ j |	 |||	d   |||	d     ||	< ||	 ˆ|	   }t|ƒdˆ j k r¤n|	dkrµt|
ƒt|ƒ dk rµˆ j‚||7 }|}
|	d7 }	q.ˆ  ˆ¡| }ˆ|g|dg||g| |gg g df}ˆ g|  g||||  g|||  ||  g| | | d | | d g| | d gdˆ f}ˆ g| g||| | g| || || g||| d || d g|  | d gdˆ f}|||fS )	Nr   r   r   rv   çš™™™™™¹?r
  ç      ø?r£   )rP   ræ   rå   r±   r{   )r‘   r—   r’   r“   ÚXÚA2ÚB2rD   Ús1r"   ÚtprevÚuu1Úuu2Út1r&  rª   r«   ÚT3©r   r    r-   r.   re     s8   
 d,.ñ"VX
z_hyp2f2.<locals>.hTr¢   ©rw   r,  c                 3   ó   � | ]}ˆ   |¡V  qd S r‹   ©r¯   ©r7   r,   r>   r-   r.   rú   !  ó   € z_hyp2f2.<locals>.<genexpr>r
  r   )	ræ   rE   r   rI   rq   r   r	   r±   r…   )r   r   r   r    r^   r‘   Úa1typer—   Úa2typer’   Úb1typer“   Úb2typerë   r³   r_   Úasymp_extraprecÚcan_use_asymptoticre   rh   r-   r@  r.   r€   è  s2   
ÿ $
ýÿ*r€   c                    s2  |\\}}|\\}}\}	}
t ˆƒ}ˆ  ˆ¡}ˆ j}ˆo|d }| d¡ o4ˆ  |¡dko4ˆ  |¡d| k}|r†zJz:ˆ  j|7  _‡ ‡fdd„}ˆ j||||	gddˆ j d	�}t‡ fd
d„|||	ˆfD ƒƒdkrlˆ  |¡}|W W |ˆ _S  ˆ jy|   Y nw W |ˆ _n|ˆ _w ˆ j	dd|||
f|||	gˆfi |¤ŽS )Nr   rw   é   r6  c                    sP  ˆ j | | | ˆ j   }i }ˆ j|d< dˆ jd|  | | d  | | |  ||  ˆ j  |d< d|| ˆ j| | |  d|  | | d   ˆ j d  ˆ jdd|  d  | | d| | |  d| d  d|   | | d   d   |d< d}d}d}d}	 ||vrðd|d  d	|  d|  d|  d |  d| d   || d  d|  || d   ˆ j }	||  | | ˆ j  ||  | | ˆ j   ||  | | ˆ j  }
ˆ jd|  |	||d   |
||d     ||< || ˆ d
|   }ˆ j | ˆ  d¡|   | }ˆ j| ˆ  d¡|   | }t|ƒdˆ j	 k �r%n"|dk�r8t|ƒt|ƒ dk �r8ˆ j
‚||7 }||7 }|}|d7 }qƒˆ  ˆ j| dˆ  ˆ ¡  ¡| ˆ  ˆ j| dˆ  ˆ ¡   ¡|  }d| ˆ jˆ gdd
|g||g| gg g df}ˆ g|  g||g||  ||  g| | | d | | d gg dˆ f}||fS )Nr   r   rv   r   éðÿÿÿr¢   éøÿÿÿé   iúÿÿÿç      à¿r5  r
  r6  ç      à?)r¦   rP   Úmpq_1_4Úmpq_3_16Úmpq_1_16Úmpq_5_2r¥   rÃ   ræ   rå   r±   Úexpjr®   r¤   )r‘   r’   r“   r7  rD   r:  Ús2r"   r;  r<  r=  r#   r>  Út2r&  rª   r«   r@  r-   r.   re   I  sd   
<:.ÿÿÿ6
ÿÿÿ*ÿ2  ì"$ÿ"ÿ  ÿz_hyp1f2.<locals>.hTr¢   rA  c                 3   rB  r‹   rC  rD  r>   r-   r.   rú   r  rE  z_hyp1f2.<locals>.<genexpr>r   ©
ræ   rE   r   rI   r¤   rq   r   r	   r±   r…   )r   r   r   r    r^   r‘   rF  r’   rH  r“   rI  rë   r³   r_   rJ  rK  re   rh   r-   r@  r.   r}   -  s6   

ÿþ("
ýÿ&r}   c              	      sN  |\\}}\}}|\\}	}
\}}\}}t ˆƒ}ˆ  ˆ¡}ˆo!|d }ˆ j}| d¡ o:ˆ  |¡dko:ˆ  |¡d| k}|r�zNz>ˆ  j|7  _‡ ‡fdd„}ˆ j||||	||gddˆ j d	�}t‡ fd
d„|||	||ˆfD ƒƒdkrvˆ  |¡}|W W |ˆ _S  ˆ jy†   Y nw W |ˆ _n|ˆ _w ˆ j	dd|||
||f|||	||gˆfi |¤ŽS )Nr   rw   rL  r6  c              	      sÀ  ˆ j | | | | | ˆ j   }| | }|| | }| | }|| ||  ||  }	|| | }
i }ˆ j|d< d|	| ˆ jd| | d  ||   ˆ j  |d< ˆ j |d d  ˆ jdd| d  |	|  d|
  dd|d  d	|  d
|  | d  ||   d   |d< d}d}d}d}	 ||v�r\|d|  d |d|  d|  d  |d|  d|  d  |d|  d|  d  }d|d d  dd| |  |d d   dd|d  d| |  d|	  | d  |d   d|d   d| |d   d|	  d
|
  dd|	 | d  |  d|  d }d|d d  dd| | d|  d  |d   d|d   }ˆ jd|  |||d   |||d    |||d     ||< || ˆ  ˆ d| ¡ }ˆ j | ˆ  d¡|   | }ˆ j| ˆ  d¡|   | }t|ƒdˆ j	 k �r“n"|dk�r¦t|ƒt|ƒ dk �r¦ˆ j
‚||7 }||7 }|}|d7 }q’ˆ  ˆ j| dˆ  ˆ ¡  ¡| ˆ  ˆ j| dˆ  ˆ ¡   ¡|  }d| ˆ jˆ gdd|g|||g| |gg g df}ˆ g|  g|||||  g|||  ||  ||  g| | | d | | d | | d g| | d gdˆ f}ˆ g| g|||| | g| || || || g||| d || d || d g|  | d gdˆ f}|||fS )Nr   r   rv   r   rM  é    r¢   rN  rO  r    é   é   r¡   r
  iöÿÿÿrP  r5  r6  rQ  )r¦   rP   rR  rS  rT  rC   r¥   rÃ   ræ   rå   r±   rV  r®   r¤   )r‘   r—   r’   r“   r™   r7  r8  ÚB3ÚAÚBÚRrD   r:  rW  r"   r;  r<  r=  Úuu3r#   r>  rX  r&  rª   r«   r?  r@  r-   r.   re   ˜  s†    
42.ÿÿ
>ÿ*2ÿ
ÿþþþþþþ@B  ì"$ÿ&ÿ04ÿ06ÿ
z_hyp2f3.<locals>.hTr¢   rA  c                 3   rB  r‹   rC  rD  r>   r-   r.   rú   Ç  rE  z_hyp2f3.<locals>.<genexpr>r[  rv   rY  )r   r   r   r    r^   r‘   rF  r—   rG  r’   rH  r“   rI  r™   Úb3typerë   r³   rJ  r_   rK  re   rh   r-   r@  r.   r�     s6   
ÿÿ".&
ýÿ.r�   c                    sž   |\\}}\}}z|  ¡ }	|	 dˆ j¡|	d< ˆ jdd||f||gˆfi |	¤ŽW S  ˆ jy7   | d¡r5‚ Y nw ‡ ‡fdd„}
ˆ j|
|d| | gfi |¤ŽS )Nr,  r   r   rw   c                    sŒ   ˆ   |¡}dˆ }ˆ j||gdd| gg | | d |g| g|g|f}ˆ j ||gddd|  | gg | d| g| | d gd| g|f}||fS )Nr£   r   r   )Úsinpir®   )r=   rB   r#   r¹   rª   r«   r@  r-   r.   re   Þ  s
   
0Bz_hyp2f0.<locals>.hr   )ÚcopyrI   r   r…   r±   rq   )r   r   r   r    r^   r=   rÁ   rB   r²   Úkwargsbre   r-   r@  r.   r‚   Ñ  s   $
ý r‚   Nc                    s.  |\}}|\}	}
t |ƒ‰ˆt |ƒ ‰t |	ƒ‰ˆt |
ƒ ‰|| }|	|
 }‡ fdd„|D ƒ}‡ fdd„|D ƒ}ˆ  ˆ¡‰|d u r`ˆˆk rEd}ˆˆkrKd}ˆˆkr`ˆˆ ˆkr^tˆƒdkr^d}nd}| d¡rntdˆˆˆˆ|ƒ |dkr‡ ‡‡‡‡‡‡fdd	„}n‡ ‡‡‡‡‡‡fd
d	„}ˆ j||| fi |¤ŽS )Nc                    r:   r-   ©rx   ©r7   Ú_r>   r-   r.   r8   ð  r?   zmeijerg.<locals>.<listcomp>c                    r:   r-   rf  rg  r>   r-   r.   r8   ñ  r?   r   r   r0   zMeijer G m,n,p,q,series =c            	   
      s  | d ˆ… ‰ | ˆd … ‰g }t ˆƒD ]z‰ˆ	g}ˆˆ ˆ g}‡‡fdd„t ˆƒD ƒ}|‡ ‡‡fdd„t ˆƒD ƒ7 }‡ ‡‡fdd„t ˆˆƒD ƒ}|‡‡fdd„t ˆˆƒD ƒ7 }‡ ‡‡fdd„t ˆƒD ƒ}‡‡fdd„t ˆƒD ƒ}ˆj ˆˆ ˆ  ˆ	ˆjˆ   }| |||||||f¡ q|S )Nc                    s$   g | ]}|ˆkrˆ | ˆ ˆ  ‘qS r-   r-   r  ©rB   r"   r-   r.   r8     r  ú&meijerg.<locals>.h.<locals>.<listcomp>c                    ó    g | ]}d ˆ |  ˆˆ  ‘qS r  r-   r  ©r=   rB   r"   r-   r.   r8     r  c                    s   g | ]
}ˆ | ˆˆ  ‘qS r-   r-   r  rl  r-   r.   r8     r9   c                    s    g | ]}d ˆ |  ˆ ˆ  ‘qS r  r-   r  ri  r-   r.   r8     r  c                    rk  r  r-   r  rl  r-   r.   r8   	  r  c                    s(   g | ]}|ˆkrd ˆ |  ˆ ˆ  ‘qS r  r-   r  ri  r-   r.   r8   
  ó   ( )rQ   rP   r   ©	r  r   ÚbasesÚexptsÚgnÚgdÚhnÚhdÚhz©r   rñ   r)   r†   r‡   Úrr    rl  r.   re   þ  s   "zmeijerg.<locals>.hc            	   
      s@  | d ˆ… ‰ | ˆd … ‰g }t ˆƒD ]‹‰ˆ	g}ˆdkr#ˆ ˆ d g}nˆ ˆ d ˆ ˆ¡ g}‡ ‡fdd„t ˆƒD ƒ}|‡ ‡‡fdd„t ˆƒD ƒ7 }‡ ‡‡fdd„t ˆˆƒD ƒ}|‡ ‡fdd„t ˆˆƒD ƒ7 }‡ ‡‡fdd„t ˆƒD ƒ}‡ ‡fdd„t ˆƒD ƒ}ˆj ˆˆ ˆ  ˆ	ˆjˆ   }| |||||||f¡ q|S )	Nr   c                    s$   g | ]}|ˆkrˆ ˆ ˆ |  ‘qS r-   r-   r  ©r=   r"   r-   r.   r8     r  rj  c                    ó    g | ]}d ˆ ˆ  ˆ|  ‘qS r  r-   r  rl  r-   r.   r8     r  c                    s   g | ]
}ˆ ˆ ˆ|  ‘qS r-   r-   r  rl  r-   r.   r8     r9   c                    s    g | ]}d ˆ ˆ  ˆ |  ‘qS r  r-   r  rx  r-   r.   r8     r  c                    ry  r  r-   r  rl  r-   r.   r8     r  c                    s(   g | ]}|ˆkrd ˆ |  ˆ ˆ  ‘qS r  r-   r  rx  r-   r.   r8     rm  )rQ   rx   rP   r   rn  rv  rl  r.   re     s"   ")rR   rx   ræ   rI   rM   rq   )r   r   r   r    rw  Úseriesr^   ÚanÚapÚbmÚbqr=   rB   re   r-   rv  r.   Úmeijergæ  s0   

r  c           
      K   s  t |ƒt |ƒkr||}}||}}dd„ }|  |¡rnO|  |¡r"nI|  |¡r2||||f\}}}}n9||ƒsk|| |d  }	||	ƒsFtdƒ‚d| |  d| || |   | j|| ||| | ||	|fi |¤Ž S | j|g|g|gdœd|gi||fi |¤ŽS )Nc                 S   s   t | ƒdk S )Ng®Gáz®ï?)ræ   )r(   r-   r-   r.   r+   +  s   zappellf1.<locals>.okr   z%Analytic continuation not implemented©úm+nrñ   r)   r�  )ræ   r   rK   Úappellf1Úhyper2d)
r   r=   r’   r“   rD   r(   Úyr^   r+   Úu1r-   r-   r.   r‚  $  s$   




 &ÿ,r‚  c           	      K   s0   | j |g|g|gdœ|g|gdœ||fi |¤ŽS )Nr€  ©rñ   r)   ©rƒ  )	r   r=   r’   r“   Úc1Úc2r(   r„  r^   r-   r-   r.   Úappellf2A  s
   ÿÿrŠ  c                 K   sŠ   |   |¡p	|   |¡}	|   |¡p|   |¡}
|	s/|
s t|ƒt|ƒkr/||}}||||f\}}}}| j||g||gdœd|gi||fi |¤ŽS )Nr†  r�  )r   ræ   rƒ  )r   r‘   r—   r’   r“   rD   r(   r„  r^   Úouter_polynomialÚinner_polynomialr-   r-   r.   Úappellf3G  s   
,r�  c                 K   s*   | j d||gi|g|gdœ||fi |¤ŽS )Nr�  r†  r‡  )r   r=   rB   rˆ  r‰  r(   r„  r^   r-   r-   r.   Úappellf4Q  s   *rŽ  c           "         s®  ˆ   |¡}ˆ   |¡}‡ fdd„}t|ƒ}t|ƒ}||dƒ}	||dƒ}
||dƒ}||dƒ}||dƒ}||dƒ}||d	ƒ}||d
ƒ}||dƒ}||dƒ}||dƒ}|r[td| ¡ d  ƒ‚|rgtd| ¡ d  ƒ‚d}ˆ j}ˆ  d¡‰d}ˆ j}| dd| ¡}�zSˆ  jd7  _ˆ j
 }	 d}d}t	|
ƒ}t	|ƒ}‡fdd„|	D ƒ}‡fdd„|D ƒ}|D ]}|ˆ }| 
|¡ | 
|¡ q¬|D ]}|ˆ }| 
|¡ | 
|¡ q¿|D ]}| 
|ˆ ¡ | 
|ˆ d ¡ qÒ|D ]}|d9 }|dˆ 9 }| 
d| ˆ ¡ | 
| ˆ ¡ qç|D ]}| 
|dˆ  ¡ | 
|dˆ  d| dˆ   ¡ �q|D ]#}|d9 }| 
d| dˆ  ¡ | 
|dˆ  d| dˆ   ¡ �q'|D ]$}|d9 }| 
d|ˆ  ¡ | 
d|ˆ d  ¡ | 
|ˆ d ¡ �qMˆ j|||| fdˆ ji|¤Ž} ||  | }!t|!ƒ|k �r”|d7 }nd}|dk�sž|�sŸn-||!7 }|D ]}||9 }�q¥|D ]}|| }�q¯ˆd7 ‰|| ˆ }ˆ|k�rËˆ  d¡‚qŒW |ˆ _|
 S |ˆ _w )az  
    Sums the generalized 2D hypergeometric series

    .. math ::

        \sum_{m=0}^{\infty} \sum_{n=0}^{\infty}
            \frac{P((a),m,n)}{Q((b),m,n)}
            \frac{x^m y^n} {m! n!}

    where `(a) = (a_1,\ldots,a_r)`, `(b) = (b_1,\ldots,b_s)` and where
    `P` and `Q` are products of rising factorials such as `(a_j)_n` or
    `(a_j)_{m+n}`. `P` and `Q` are specified in the form of dicts, with
    the `m` and `n` dependence as keys and parameter lists as values.
    The supported rising factorials are given in the following table
    (note that only a few are supported in `Q`):

    +------------+-------------------+--------+
    | Key        |  Rising factorial | `Q`    |
    +============+===================+========+
    | ``'m'``    |   `(a_j)_m`       | Yes    |
    +------------+-------------------+--------+
    | ``'n'``    |   `(a_j)_n`       | Yes    |
    +------------+-------------------+--------+
    | ``'m+n'``  |   `(a_j)_{m+n}`   | Yes    |
    +------------+-------------------+--------+
    | ``'m-n'``  |   `(a_j)_{m-n}`   | No     |
    +------------+-------------------+--------+
    | ``'n-m'``  |   `(a_j)_{n-m}`   | No     |
    +------------+-------------------+--------+
    | ``'2m+n'`` |   `(a_j)_{2m+n}`  | No     |
    +------------+-------------------+--------+
    | ``'2m-n'`` |   `(a_j)_{2m-n}`  | No     |
    +------------+-------------------+--------+
    | ``'2n-m'`` |   `(a_j)_{2n-m}`  | No     |
    +------------+-------------------+--------+

    For example, the Appell F1 and F4 functions

    .. math ::

        F_1 = \sum_{m=0}^{\infty} \sum_{n=0}^{\infty}
              \frac{(a)_{m+n} (b)_m (c)_n}{(d)_{m+n}}
              \frac{x^m y^n}{m! n!}

        F_4 = \sum_{m=0}^{\infty} \sum_{n=0}^{\infty}
              \frac{(a)_{m+n} (b)_{m+n}}{(c)_m (d)_{n}}
              \frac{x^m y^n}{m! n!}

    can be represented respectively as

        ``hyper2d({'m+n':[a], 'm':[b], 'n':[c]}, {'m+n':[d]}, x, y)``

        ``hyper2d({'m+n':[a,b]}, {'m':[c], 'n':[d]}, x, y)``

    More generally, :func:`~mpmath.hyper2d` can evaluate any of the 34 distinct
    convergent second-order (generalized Gaussian) hypergeometric
    series enumerated by Horn, as well as the Kampe de Feriet
    function.

    The series is computed by rewriting it so that the inner
    series (i.e. the series containing `n` and `y`) has the form of an
    ordinary generalized hypergeometric series and thereby can be
    evaluated efficiently using :func:`~mpmath.hyper`. If possible,
    manually swapping `x` and `y` and the corresponding parameters
    can sometimes give better results.

    **Examples**

    Two separable cases: a product of two geometric series, and a
    product of two Gaussian hypergeometric functions::

        >>> from mpmath import *
        >>> mp.dps = 25; mp.pretty = True
        >>> x, y = mpf(0.25), mpf(0.5)
        >>> hyper2d({'m':1,'n':1}, {}, x,y)
        2.666666666666666666666667
        >>> 1/(1-x)/(1-y)
        2.666666666666666666666667
        >>> hyper2d({'m':[1,2],'n':[3,4]}, {'m':[5],'n':[6]}, x,y)
        4.164358531238938319669856
        >>> hyp2f1(1,2,5,x)*hyp2f1(3,4,6,y)
        4.164358531238938319669856

    Some more series that can be done in closed form::

        >>> hyper2d({'m':1,'n':1},{'m+n':1},x,y)
        2.013417124712514809623881
        >>> (exp(x)*x-exp(y)*y)/(x-y)
        2.013417124712514809623881

    Six of the 34 Horn functions, G1-G3 and H1-H3::

        >>> from mpmath import *
        >>> mp.dps = 10; mp.pretty = True
        >>> x, y = 0.0625, 0.125
        >>> a1,a2,b1,b2,c1,c2,d = 1.1,-1.2,-1.3,-1.4,1.5,-1.6,1.7
        >>> hyper2d({'m+n':a1,'n-m':b1,'m-n':b2},{},x,y)  # G1
        1.139090746
        >>> nsum(lambda m,n: rf(a1,m+n)*rf(b1,n-m)*rf(b2,m-n)*\
        ...     x**m*y**n/fac(m)/fac(n), [0,inf], [0,inf])
        1.139090746
        >>> hyper2d({'m':a1,'n':a2,'n-m':b1,'m-n':b2},{},x,y)  # G2
        0.9503682696
        >>> nsum(lambda m,n: rf(a1,m)*rf(a2,n)*rf(b1,n-m)*rf(b2,m-n)*\
        ...     x**m*y**n/fac(m)/fac(n), [0,inf], [0,inf])
        0.9503682696
        >>> hyper2d({'2n-m':a1,'2m-n':a2},{},x,y)  # G3
        1.029372029
        >>> nsum(lambda m,n: rf(a1,2*n-m)*rf(a2,2*m-n)*\
        ...     x**m*y**n/fac(m)/fac(n), [0,inf], [0,inf])
        1.029372029
        >>> hyper2d({'m-n':a1,'m+n':b1,'n':c1},{'m':d},x,y)  # H1
        -1.605331256
        >>> nsum(lambda m,n: rf(a1,m-n)*rf(b1,m+n)*rf(c1,n)/rf(d,m)*\
        ...     x**m*y**n/fac(m)/fac(n), [0,inf], [0,inf])
        -1.605331256
        >>> hyper2d({'m-n':a1,'m':b1,'n':[c1,c2]},{'m':d},x,y)  # H2
        -2.35405404
        >>> nsum(lambda m,n: rf(a1,m-n)*rf(b1,m)*rf(c1,n)*rf(c2,n)/rf(d,m)*\
        ...     x**m*y**n/fac(m)/fac(n), [0,inf], [0,inf])
        -2.35405404
        >>> hyper2d({'2m+n':a1,'n':b1},{'m+n':c1},x,y)  # H3
        0.974479074
        >>> nsum(lambda m,n: rf(a1,2*m+n)*rf(b1,n)/rf(c1,m+n)*\
        ...     x**m*y**n/fac(m)/fac(n), [0,inf], [0,inf])
        0.974479074

    **References**

    1. [SrivastavaKarlsson]_
    2. [Weisstein]_ http://mathworld.wolfram.com/HornFunction.html
    3. [Weisstein]_ http://mathworld.wolfram.com/AppellHypergeometricFunction.html

    c                    sD   |   |g ¡}zt|ƒ}W n ty   |g}Y nw ‡ fdd„|D ƒS )Nc                    r:   r-   rf  )r7   r1  r>   r-   r.   r8   æ  r?   z*hyper2d.<locals>.parse.<locals>.<listcomp>)Úpopr  Ú	TypeError)ÚdctÚkeyr  r>   r-   r.   Úparseà  s   
ÿzhyper2d.<locals>.parserñ   r)   r�  zm-nzn-mz2m+nz2m-nz2n-mzunsupported key: %rr   r,  rG   r4   r   c                    ó   g | ]}|ˆ  ‘qS r-   r-   r<   ©rñ   r-   r.   r8     ó    zhyper2d.<locals>.<listcomp>c                    r”  r-   r-   rA   r•  r-   r.   r8     r–  r£   r   r¢   rQ  r2   rv   zmaxterms exceeded in hyper2d)rx   ÚdictrK   ÚkeysrP   rÃ   r   rI   rå   r  r   rU   ræ   r±   )"r   r=   rB   r(   r„  r^   r“  r   r   Úa_mÚa_nÚ	a_m_add_nÚ	a_m_sub_nÚ	a_n_sub_mÚ
a_2m_add_nÚ
a_2m_sub_nÚ
a_2n_sub_mÚb_mÚb_nÚ	b_m_add_nr3  ÚouterÚok_countr   r,  rÔ   Ú
inner_signÚ
outer_signÚinner_aÚinner_bÚouter_aÚouter_bÚinnerr   r-   )r   rñ   r.   rƒ  V  s¬    
	














&&ÿÿ


Ç2	ÿrƒ  c                    st   |   ˆ¡‰|| }t|ƒ‰t|ƒ}ˆ|fdksˆ|fdkr"| jˆ S ˆ| d ‰ ‡ ‡‡fdd„}| j||fi |¤ŽS )a`  
    Evaluates the bilateral hypergeometric series

    .. math ::

        \,_AH_B(a_1, \ldots, a_k; b_1, \ldots, b_B; z) =
            \sum_{n=-\infty}^{\infty}
            \frac{(a_1)_n \ldots (a_A)_n}
                 {(b_1)_n \ldots (b_B)_n} \, z^n

    where, for direct convergence, `A = B` and `|z| = 1`, although a
    regularized sum exists more generally by considering the
    bilateral series as a sum of two ordinary hypergeometric
    functions. In order for the series to make sense, none of the
    parameters may be integers.

    **Examples**

    The value of `\,_2H_2` at `z = 1` is given by Dougall's formula::

        >>> from mpmath import *
        >>> mp.dps = 25; mp.pretty = True
        >>> a,b,c,d = 0.5, 1.5, 2.25, 3.25
        >>> bihyper([a,b],[c,d],1)
        -14.49118026212345786148847
        >>> gammaprod([c,d,1-a,1-b,c+d-a-b-1],[c-a,d-a,c-b,d-b])
        -14.49118026212345786148847

    The regularized function `\,_1H_0` can be expressed as the
    sum of one `\,_2F_0` function and one `\,_1F_1` function::

        >>> a = mpf(0.25)
        >>> z = mpf(0.75)
        >>> bihyper([a], [], z)
        (0.2454393389657273841385582 + 0.2454393389657273841385582j)
        >>> hyper([a,1],[],z) + (hyper([1],[1-a],-1/z)-1)
        (0.2454393389657273841385582 + 0.2454393389657273841385582j)
        >>> hyper([a,1],[],z) + hyper([1],[2-a],-1/z)/z/(a-1)
        (0.2454393389657273841385582 + 0.2454393389657273841385582j)

    **References**

    1. [Slater]_ (chapter 6: "Bilateral Series", pp. 180-189)
    2. [Wikipedia]_ http://en.wikipedia.org/wiki/Bilateral_hypergeometric_series

    )r   r   )r   r   r   c            	         sÈ   t | d ˆ… ƒ}t | ˆd … ƒ}dd„ |D ƒ}dd„ |D ƒ}dˆ  ˆ gdd„ |D ƒ dd„ |D ƒ }dgdgt|ƒ  dgt|ƒ  }g g g g |dg |ˆf}||g g |dg |dˆ  ˆ f}||fS )Nc                 S   ó   g | ]}d | ‘qS ©r   r-   rA   r-   r-   r.   r8   ~  r–  z&bihyper.<locals>.h.<locals>.<listcomp>c                 S   r­  r®  r-   r<   r-   r-   r.   r8     r–  r£   c                 S   r­  r  r-   rA   r-   r-   r.   r8   €  r–  c                 S   r­  r  r-   r<   r-   r-   r.   r8   €  r–  r   )r  rR   )	r   r   r   Úaa_sÚbb_sÚrpÚrcrª   r«   ©Únegr†   r    r-   r.   re   {  s   *" zbihyper.<locals>.h)rx   rR   rH   rq   )r   r   r   r    r^   r   r‡   re   r-   r³  r.   ÚbihyperD  s   
0

rµ  )r   N)#Úlibmp.backendr   Ú	functionsr   r   r/   rL   rq   rU   r�   r�   r”   r–   r˜   rš   rœ   rž   r~   rz   r|   rÜ   r   rƒ   r„   r€   r}   r�   r‚   r  r‚  rŠ  r�  rŽ  rƒ  rµ  r-   r-   r-   r.   Ú<module>   s~    / 
*









#
#6
O
 J
>
D
Q
Q
=


	

 g