a
    ¬ˆcÉÔ  ã                   @   s\  d dl mZ d dlZd dlmZ d dlmZmZmZm	Z
mZ d dlmZmZ d dlmZ d dlmZmZmZmZmZmZmZmZmZmZ d dlZdd	lmZmZm Z m!Z!m"Z"m#Z# d dl$m%  m&Z& dd
l'm(Z(m)Z)m*Z* dd„ Z+G dd„ deƒZ,e,dd�Z-G dd„ de,ƒZ.e.ddd�Z/G dd„ deƒZ0e0dd�Z1G dd„ deƒZ2e2dd�Z3G dd„ deƒZ4e4dddd�Z5G d d!„ d!eƒZ6e6d"d�Z7G d#d$„ d$eƒZ8e8d%d�Z9G d&d'„ d'eƒZ:e:dd(d)d�Z;G d*d+„ d+eƒZ<e<d,d-d.�Z=G d/d0„ d0eƒZ>e>d d1d2d�Z?G d3d4„ d4eƒZ@e@d5d d6d7�ZAG d8d9„ d9eƒZBeBd:d;d.�ZCG d<d=„ d=eƒZDeDdd>d?d�ZEd@dA„ ZFdBdC„ ZGdDdE„ ZHG dFdG„ dGeƒZIeIddHdId�ZJG dJdK„ dKeƒZKeKejL dLdMd�ZMG dNdO„ dOeƒZNeNejL dPdQd�ZOG dRdS„ dSeƒZPePdTddU�ZQdVdW„ ZRG dXdY„ dYeƒZSG dZd[„ d[eSƒZTeTd\d]d.�ZUG d^d_„ d_eSƒZVeVd`dad.�ZWeXeYƒ  Z¡  [¡ ƒZ\e!e\eƒ\Z]Z^e]e^ Z_dS )bé    )ÚpartialN)Úspecial)ÚentrÚ	logsumexpÚbetalnÚgammalnÚzeta)Ú
_lazywhereÚrng_integers)Úinterp1d)
ÚfloorÚceilÚlogÚexpÚsqrtÚlog1pÚexpm1ÚtanhÚcoshÚsinhé   )Úrv_discreteÚ	_ncx2_pdfÚ	_ncx2_cdfÚget_distribution_namesÚ_check_shapeÚ
_ShapeInfo)Ú_PyFishersNCHypergeometricÚ_PyWalleniusNCHypergeometricÚ_PyStochasticLib3c                 C   s   | t  | ¡kS ©N)ÚnpÚround©Úx© r%   ú_/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/scipy/stats/_discrete_distns.pyÚ_isintegral   s    r'   c                   @   st   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ Zdd„ Zddd„Zdd„ ZdS )Ú	binom_gena  A binomial discrete random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `binom` is:

    .. math::

       f(k) = \binom{n}{k} p^k (1-p)^{n-k}

    for :math:`k \in \{0, 1, \dots, n\}`, :math:`0 \leq p \leq 1`

    `binom` takes :math:`n` and :math:`p` as shape parameters,
    where :math:`p` is the probability of a single success
    and :math:`1-p` is the probability of a single failure.

    %(after_notes)s

    %(example)s

    See Also
    --------
    hypergeom, nbinom, nhypergeom

    c                 C   s"   t dddtjfdƒt ddddƒgS ©	NÚnTr   ©TFÚpF©r   r   ©TT©r   r!   Úinf©Úselfr%   r%   r&   Ú_shape_info:   s    ÿzbinom_gen._shape_infoNc                 C   s   |  |||¡S r    )Úbinomial©r2   r*   r,   ÚsizeÚrandom_stater%   r%   r&   Ú_rvs>   s    zbinom_gen._rvsc                 C   s    |dkt |ƒ@ |dk@ |dk@ S ©Nr   r   ©r'   ©r2   r*   r,   r%   r%   r&   Ú	_argcheckA   s    zbinom_gen._argcheckc                 C   s
   | j |fS r    ©Úar;   r%   r%   r&   Ú_get_supportD   s    zbinom_gen._get_supportc                 C   sR   t |ƒ}t|d ƒt|d ƒt|| d ƒ  }|t ||¡ t || | ¡ S ©Nr   )r   Úgamlnr   ÚxlogyÚxlog1py)r2   r$   r*   r,   ÚkÚcombilnr%   r%   r&   Ú_logpmfG   s    (zbinom_gen._logpmfc                 C   s>   t jdd�� t |||¡W  d   ƒ S 1 s00    Y  d S )NÚignore©Údivide)r!   ÚerrstateÚ_boostZ
_binom_pdf©r2   r$   r*   r,   r%   r%   r&   Ú_pmfL   s    zbinom_gen._pmfc                 C   s   t |ƒ}t |||¡S r    )r   rK   Z
_binom_cdf©r2   r$   r*   r,   rD   r%   r%   r&   Ú_cdfR   s    zbinom_gen._cdfc                 C   s   t |ƒ}t |||¡S r    )r   rK   Z	_binom_sfrN   r%   r%   r&   Ú_sfV   s    zbinom_gen._sfc                 C   s   t  |||¡S r    )rK   Z
_binom_isfrL   r%   r%   r&   Ú_isfZ   s    zbinom_gen._isfc                 C   s   t  |||¡S r    )rK   Z
_binom_ppf)r2   Úqr*   r,   r%   r%   r&   Ú_ppf]   s    zbinom_gen._ppfÚmvc                 C   sT   t  ||¡}t  ||¡}d\}}d|v r4t  ||¡}d|v rHt  ||¡}||||fS )N©NNÚsrD   )rK   Z_binom_meanZ_binom_varianceZ_binom_skewnessZ_binom_kurtosis_excess)r2   r*   r,   ÚmomentsÚmuÚvarÚg1Úg2r%   r%   r&   Ú_stats`   s    zbinom_gen._statsc                 C   s2   t jd|d … }|  |||¡}t jt|ƒdd�S )Nr   r   ©Zaxis)r!   Úr_rM   Úsumr   )r2   r*   r,   rD   Úvalsr%   r%   r&   Ú_entropyj   s    zbinom_gen._entropy)NN)rT   ©Ú__name__Ú
__module__Ú__qualname__Ú__doc__r3   r8   r<   r?   rF   rM   rO   rP   rQ   rS   r\   ra   r%   r%   r%   r&   r(      s   


r(   Úbinom)Únamec                   @   sr   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ Zdd„ Zdd„ Zdd„ ZdS )Úbernoulli_gena  A Bernoulli discrete random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `bernoulli` is:

    .. math::

       f(k) = \begin{cases}1-p  &\text{if } k = 0\\
                           p    &\text{if } k = 1\end{cases}

    for :math:`k` in :math:`\{0, 1\}`, :math:`0 \leq p \leq 1`

    `bernoulli` takes :math:`p` as shape parameter,
    where :math:`p` is the probability of a single success
    and :math:`1-p` is the probability of a single failure.

    %(after_notes)s

    %(example)s

    c                 C   s   t ddddƒgS ©Nr,   Fr-   r.   ©r   r1   r%   r%   r&   r3   Œ   s    zbernoulli_gen._shape_infoNc                 C   s   t j| d|||d�S )Nr   ©r6   r7   )r(   r8   ©r2   r,   r6   r7   r%   r%   r&   r8   �   s    zbernoulli_gen._rvsc                 C   s   |dk|dk@ S r9   r%   ©r2   r,   r%   r%   r&   r<   ’   s    zbernoulli_gen._argcheckc                 C   s   | j | jfS r    )r>   Úbrn   r%   r%   r&   r?   •   s    zbernoulli_gen._get_supportc                 C   s   t  |d|¡S r@   )rg   rF   ©r2   r$   r,   r%   r%   r&   rF   ™   s    zbernoulli_gen._logpmfc                 C   s   t  |d|¡S r@   )rg   rM   rp   r%   r%   r&   rM   œ   s    zbernoulli_gen._pmfc                 C   s   t  |d|¡S r@   )rg   rO   rp   r%   r%   r&   rO   ¡   s    zbernoulli_gen._cdfc                 C   s   t  |d|¡S r@   )rg   rP   rp   r%   r%   r&   rP   ¤   s    zbernoulli_gen._sfc                 C   s   t  |d|¡S r@   )rg   rQ   rp   r%   r%   r&   rQ   §   s    zbernoulli_gen._isfc                 C   s   t  |d|¡S r@   )rg   rS   )r2   rR   r,   r%   r%   r&   rS   ª   s    zbernoulli_gen._ppfc                 C   s   t  d|¡S r@   )rg   r\   rn   r%   r%   r&   r\   ­   s    zbernoulli_gen._statsc                 C   s   t |ƒt d| ƒ S r@   )r   rn   r%   r%   r&   ra   °   s    zbernoulli_gen._entropy)NNrb   r%   r%   r%   r&   ri   s   s   
ri   Ú	bernoulli)ro   rh   c                   @   sL   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ Zdd„ Z	ddd„Z
dS )Úbetabinom_gena  A beta-binomial discrete random variable.

    %(before_notes)s

    Notes
    -----
    The beta-binomial distribution is a binomial distribution with a
    probability of success `p` that follows a beta distribution.

    The probability mass function for `betabinom` is:

    .. math::

       f(k) = \binom{n}{k} \frac{B(k + a, n - k + b)}{B(a, b)}

    for :math:`k \in \{0, 1, \dots, n\}`, :math:`n \geq 0`, :math:`a > 0`,
    :math:`b > 0`, where :math:`B(a, b)` is the beta function.

    `betabinom` takes :math:`n`, :math:`a`, and :math:`b` as shape parameters.

    References
    ----------
    .. [1] https://en.wikipedia.org/wiki/Beta-binomial_distribution

    %(after_notes)s

    .. versionadded:: 1.4.0

    See Also
    --------
    beta, binom

    %(example)s

    c                 C   s:   t dddtjfdƒt dddtjfdƒt dddtjfdƒgS )	Nr*   Tr   r+   r>   F©FFro   r/   r1   r%   r%   r&   r3   Û   s    þzbetabinom_gen._shape_infoNc                 C   s   |  |||¡}| |||¡S r    )Úbetar4   )r2   r*   r>   ro   r6   r7   r,   r%   r%   r&   r8   à   s    zbetabinom_gen._rvsc                 C   s   d|fS ©Nr   r%   ©r2   r*   r>   ro   r%   r%   r&   r?   ä   s    zbetabinom_gen._get_supportc                 C   s    |dkt |ƒ@ |dk@ |dk@ S ru   r:   rv   r%   r%   r&   r<   ç   s    zbetabinom_gen._argcheckc                 C   sP   t |ƒ}t|d ƒ t|| d |d ƒ }|t|| || | ƒ t||ƒ S r@   )r   r   r   )r2   r$   r*   r>   ro   rD   rE   r%   r%   r&   rF   ê   s    $zbetabinom_gen._logpmfc                 C   s   t |  ||||¡ƒS r    ©r   rF   )r2   r$   r*   r>   ro   r%   r%   r&   rM   ï   s    zbetabinom_gen._pmfrT   c                 C   sz  |||  }d| }|| }||| |  | | || d  }d\}	}
d|v r�dt |ƒ }	|	|| d|  ||  9 }	|	|| d ||   }	d|v �rn|| }
|
|| d d|  9 }
|
d| | |d  7 }
|
d|d  7 }
|
d| | | d|  8 }
|
d	| | |d  8 }
|
|| d d| |  9 }
|
|| | || d  || d  || |   }
|
d8 }
|||	|
fS )
Nr   rU   rV   ç      ð?é   rD   é   é   é   ©r   )r2   r*   r>   ro   rW   Ze_pZe_qrX   rY   rZ   r[   r%   r%   r&   r\   ò   s(    $
4zbetabinom_gen._stats)NN)rT   )rc   rd   re   rf   r3   r8   r?   r<   rF   rM   r\   r%   r%   r%   r&   rr   ·   s   #
rr   Ú	betabinomc                   @   sj   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ Zdd„ Zdd„ ZdS )Ú
nbinom_gena±  A negative binomial discrete random variable.

    %(before_notes)s

    Notes
    -----
    Negative binomial distribution describes a sequence of i.i.d. Bernoulli
    trials, repeated until a predefined, non-random number of successes occurs.

    The probability mass function of the number of failures for `nbinom` is:

    .. math::

       f(k) = \binom{k+n-1}{n-1} p^n (1-p)^k

    for :math:`k \ge 0`, :math:`0 < p \leq 1`

    `nbinom` takes :math:`n` and :math:`p` as shape parameters where n is the
    number of successes, :math:`p` is the probability of a single success,
    and :math:`1-p` is the probability of a single failure.

    Another common parameterization of the negative binomial distribution is
    in terms of the mean number of failures :math:`\mu` to achieve :math:`n`
    successes. The mean :math:`\mu` is related to the probability of success
    as

    .. math::

       p = \frac{n}{n + \mu}

    The number of successes :math:`n` may also be specified in terms of a
    "dispersion", "heterogeneity", or "aggregation" parameter :math:`\alpha`,
    which relates the mean :math:`\mu` to the variance :math:`\sigma^2`,
    e.g. :math:`\sigma^2 = \mu + \alpha \mu^2`. Regardless of the convention
    used for :math:`\alpha`,

    .. math::

       p &= \frac{\mu}{\sigma^2} \\
       n &= \frac{\mu^2}{\sigma^2 - \mu}

    %(after_notes)s

    %(example)s

    See Also
    --------
    hypergeom, binom, nhypergeom

    c                 C   s"   t dddtjfdƒt ddddƒgS r)   r/   r1   r%   r%   r&   r3   ?  s    ÿznbinom_gen._shape_infoNc                 C   s   |  |||¡S r    )Znegative_binomialr5   r%   r%   r&   r8   C  s    znbinom_gen._rvsc                 C   s   |dk|dk@ |dk@ S r9   r%   r;   r%   r%   r&   r<   F  s    znbinom_gen._argcheckc                 C   s   t  |||¡S r    )rK   Z_nbinom_pdfrL   r%   r%   r&   rM   I  s    znbinom_gen._pmfc                 C   s>   t || ƒt |d ƒ t |ƒ }||t|ƒ  t || ¡ S r@   )rA   r   r   rC   )r2   r$   r*   r,   Zcoeffr%   r%   r&   rF   M  s     znbinom_gen._logpmfc                 C   s   t |ƒ}t |||¡S r    )r   rK   Z_nbinom_cdfrN   r%   r%   r&   rO   Q  s    znbinom_gen._cdfc           	      C   sŒ   t |ƒ}|  |||¡}|dk}dd„ }|}tjdd��B ||| || || ƒ||< t ||  ¡|| < W d   ƒ n1 s~0    Y  |S )Nç      à?c                 S   s   t  t | d |d| ¡ ¡S r@   )r!   r   r   Zbetainc)rD   r*   r,   r%   r%   r&   Úf1Z  s    znbinom_gen._logcdf.<locals>.f1rG   rH   )r   rO   r!   rJ   r   )	r2   r$   r*   r,   rD   ÚcdfÚcondr�   Úlogcdfr%   r%   r&   Ú_logcdfU  s    4znbinom_gen._logcdfc                 C   s   t |ƒ}t |||¡S r    )r   rK   Z
_nbinom_sfrN   r%   r%   r&   rP   d  s    znbinom_gen._sfc                 C   sL   t  ¡ �0 d}t jd|d� t |||¡W  d   ƒ S 1 s>0    Y  d S )Nz#overflow encountered in _nbinom_isfrG   ©Úmessage)ÚwarningsÚcatch_warningsÚfilterwarningsrK   Z_nbinom_isf)r2   r$   r*   r,   r‡   r%   r%   r&   rQ   h  s    
znbinom_gen._isfc                 C   sL   t  ¡ �0 d}t jd|d� t |||¡W  d   ƒ S 1 s>0    Y  d S )Nz#overflow encountered in _nbinom_ppfrG   r†   )rˆ   r‰   rŠ   rK   Z_nbinom_ppf)r2   rR   r*   r,   r‡   r%   r%   r&   rS   o  s    
znbinom_gen._ppfc                 C   s,   t  ||¡t  ||¡t  ||¡t  ||¡fS r    )rK   Z_nbinom_meanZ_nbinom_varianceZ_nbinom_skewnessZ_nbinom_kurtosis_excessr;   r%   r%   r&   r\   u  s
    



üznbinom_gen._stats)NN)rc   rd   re   rf   r3   r8   r<   rM   rF   rO   r…   rP   rQ   rS   r\   r%   r%   r%   r&   r     s   2
r   Únbinomc                   @   sb   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ Zdd„ ZdS )Úgeom_genaÖ  A geometric discrete random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `geom` is:

    .. math::

        f(k) = (1-p)^{k-1} p

    for :math:`k \ge 1`, :math:`0 < p \leq 1`

    `geom` takes :math:`p` as shape parameter,
    where :math:`p` is the probability of a single success
    and :math:`1-p` is the probability of a single failure.

    %(after_notes)s

    See Also
    --------
    planck

    %(example)s

    c                 C   s   t ddddƒgS rj   rk   r1   r%   r%   r&   r3   ž  s    zgeom_gen._shape_infoNc                 C   s   |j ||d�S ©N©r6   )Ú	geometricrm   r%   r%   r&   r8   ¡  s    zgeom_gen._rvsc                 C   s   |dk|dk@ S ©Nr   r   r%   rn   r%   r%   r&   r<   ¤  s    zgeom_gen._argcheckc                 C   s   t  d| |d ¡| S r@   )r!   Úpower©r2   rD   r,   r%   r%   r&   rM   §  s    zgeom_gen._pmfc                 C   s   t  |d | ¡t|ƒ S r@   )r   rC   r   r’   r%   r%   r&   rF   ª  s    zgeom_gen._logpmfc                 C   s   t |ƒ}tt| ƒ| ƒ S r    )r   r   r   ©r2   r$   r,   rD   r%   r%   r&   rO   ­  s    zgeom_gen._cdfc                 C   s   t  |  ||¡¡S r    )r!   r   Ú_logsfrp   r%   r%   r&   rP   ±  s    zgeom_gen._sfc                 C   s   t |ƒ}|t| ƒ S r    )r   r   r“   r%   r%   r&   r”   ´  s    zgeom_gen._logsfc                 C   sF   t t| ƒt| ƒ ƒ}|  |d |¡}t ||k|dk@ |d |¡S r�   )r   r   rO   r!   Úwhere)r2   rR   r,   r`   Útempr%   r%   r&   rS   ¸  s    zgeom_gen._ppfc                 C   sP   d| }d| }|| | }d| t |ƒ }t g d¢|¡d|  }||||fS )Nrx   ç       @)r   iúÿÿÿrz   )r   r!   Zpolyval)r2   r,   rX   ZqrrY   rZ   r[   r%   r%   r&   r\   ½  s    zgeom_gen._stats)NN)rc   rd   re   rf   r3   r8   r<   rM   rF   rO   rP   r”   rS   r\   r%   r%   r%   r&   rŒ   �  s   
rŒ   ÚgeomzA geometric)r>   rh   Úlongnamec                   @   sr   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ Zdd„ Zdd„ Zdd„ ZdS )Úhypergeom_genaì  A hypergeometric discrete random variable.

    The hypergeometric distribution models drawing objects from a bin.
    `M` is the total number of objects, `n` is total number of Type I objects.
    The random variate represents the number of Type I objects in `N` drawn
    without replacement from the total population.

    %(before_notes)s

    Notes
    -----
    The symbols used to denote the shape parameters (`M`, `n`, and `N`) are not
    universally accepted.  See the Examples for a clarification of the
    definitions used here.

    The probability mass function is defined as,

    .. math:: p(k, M, n, N) = \frac{\binom{n}{k} \binom{M - n}{N - k}}
                                   {\binom{M}{N}}

    for :math:`k \in [\max(0, N - M + n), \min(n, N)]`, where the binomial
    coefficients are defined as,

    .. math:: \binom{n}{k} \equiv \frac{n!}{k! (n - k)!}.

    %(after_notes)s

    Examples
    --------
    >>> from scipy.stats import hypergeom
    >>> import matplotlib.pyplot as plt

    Suppose we have a collection of 20 animals, of which 7 are dogs.  Then if
    we want to know the probability of finding a given number of dogs if we
    choose at random 12 of the 20 animals, we can initialize a frozen
    distribution and plot the probability mass function:

    >>> [M, n, N] = [20, 7, 12]
    >>> rv = hypergeom(M, n, N)
    >>> x = np.arange(0, n+1)
    >>> pmf_dogs = rv.pmf(x)

    >>> fig = plt.figure()
    >>> ax = fig.add_subplot(111)
    >>> ax.plot(x, pmf_dogs, 'bo')
    >>> ax.vlines(x, 0, pmf_dogs, lw=2)
    >>> ax.set_xlabel('# of dogs in our group of chosen animals')
    >>> ax.set_ylabel('hypergeom PMF')
    >>> plt.show()

    Instead of using a frozen distribution we can also use `hypergeom`
    methods directly.  To for example obtain the cumulative distribution
    function, use:

    >>> prb = hypergeom.cdf(x, M, n, N)

    And to generate random numbers:

    >>> R = hypergeom.rvs(M, n, N, size=10)

    See Also
    --------
    nhypergeom, binom, nbinom

    c                 C   s:   t dddtjfdƒt dddtjfdƒt dddtjfdƒgS )NÚMTr   r+   r*   ÚNr/   r1   r%   r%   r&   r3     s    þzhypergeom_gen._shape_infoNc                 C   s   |j ||| ||d�S r�   )Zhypergeometric)r2   r›   r*   rœ   r6   r7   r%   r%   r&   r8     s    zhypergeom_gen._rvsc                 C   s    t  |||  d¡t  ||¡fS ru   ©r!   ÚmaximumZminimum)r2   r›   r*   rœ   r%   r%   r&   r?     s    zhypergeom_gen._get_supportc                 C   sL   |dk|dk@ |dk@ }|||k||k@ M }|t |ƒt |ƒ@ t |ƒ@ M }|S ru   r:   )r2   r›   r*   rœ   rƒ   r%   r%   r&   r<     s    zhypergeom_gen._argcheckc           	      C   sŠ   || }}|| }t |d dƒt |d dƒ t || d |d ƒ t |d || d ƒ t || d || | d ƒ t |d dƒ }|S r@   ©r   )	r2   rD   r›   r*   rœ   ÚtotÚgoodÚbadÚresultr%   r%   r&   rF     s    
0ÿÿþzhypergeom_gen._logpmfc                 C   s   t  ||||¡S r    )rK   Z_hypergeom_pdf©r2   rD   r›   r*   rœ   r%   r%   r&   rM   $  s    zhypergeom_gen._pmfc                 C   s   t  ||||¡S r    )rK   Z_hypergeom_cdfr¤   r%   r%   r&   rO   '  s    zhypergeom_gen._cdfc                 C   sÚ   d| d| d|   }}}|| }||d  d| ||   d| |  }||d | | 9 }|d| | ||  | d| d  7 }||| ||  | |d  |d   }t  |||¡t  |||¡t  |||¡|fS )Nrx   r   g      @g      @rz   r—   ç      @)rK   Z_hypergeom_meanZ_hypergeom_varianceZ_hypergeom_skewness)r2   r›   r*   rœ   Úmr[   r%   r%   r&   r\   *  s    (((üzhypergeom_gen._statsc                 C   sB   t j|||  t||ƒd … }|  ||||¡}t jt|ƒdd�S )Nr   r   r]   )r!   r^   ÚminZpmfr_   r   )r2   r›   r*   rœ   rD   r`   r%   r%   r&   ra   ;  s     zhypergeom_gen._entropyc                 C   s   t  ||||¡S r    )rK   Z_hypergeom_sfr¤   r%   r%   r&   rP   @  s    zhypergeom_gen._sfc                 C   s    g }t t ||||¡Ž D ]|\}}}}	|d |d  |d |	d  k rf| tt|  ||||	¡ƒ ƒ¡ qt |d |	d ¡}
| t|  	|
|||	¡ƒ¡ qt 
|¡S )Nr€   r   )Úzipr!   Úbroadcast_arraysÚappendr   r   r„   Úaranger   rF   Úasarray©r2   rD   r›   r*   rœ   ÚresZquantr    r¡   ZdrawZk2r%   r%   r&   r”   C  s      "zhypergeom_gen._logsfc                 C   sœ   g }t t ||||¡Ž D ]x\}}}}	|d |d  |d |	d  krf| tt|  ||||	¡ƒ ƒ¡ qt d|d ¡}
| t|  	|
|||	¡ƒ¡ qt 
|¡S )Nr€   r   r   )r¨   r!   r©   rª   r   r   Zlogsfr«   r   rF   r¬   r­   r%   r%   r&   r…   O  s      "zhypergeom_gen._logcdf)NN)rc   rd   re   rf   r3   r8   r?   r<   rF   rM   rO   r\   ra   rP   r”   r…   r%   r%   r%   r&   rš   É  s   A
rš   Ú	hypergeomc                   @   sJ   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	d
„Zdd„ Zdd„ Z	dd„ Z
dS )Únhypergeom_genaG  A negative hypergeometric discrete random variable.

    Consider a box containing :math:`M` balls:, :math:`n` red and
    :math:`M-n` blue. We randomly sample balls from the box, one
    at a time and *without* replacement, until we have picked :math:`r`
    blue balls. `nhypergeom` is the distribution of the number of
    red balls :math:`k` we have picked.

    %(before_notes)s

    Notes
    -----
    The symbols used to denote the shape parameters (`M`, `n`, and `r`) are not
    universally accepted. See the Examples for a clarification of the
    definitions used here.

    The probability mass function is defined as,

    .. math:: f(k; M, n, r) = \frac{{{k+r-1}\choose{k}}{{M-r-k}\choose{n-k}}}
                                   {{M \choose n}}

    for :math:`k \in [0, n]`, :math:`n \in [0, M]`, :math:`r \in [0, M-n]`,
    and the binomial coefficient is:

    .. math:: \binom{n}{k} \equiv \frac{n!}{k! (n - k)!}.

    It is equivalent to observing :math:`k` successes in :math:`k+r-1`
    samples with :math:`k+r`'th sample being a failure. The former
    can be modelled as a hypergeometric distribution. The probability
    of the latter is simply the number of failures remaining
    :math:`M-n-(r-1)` divided by the size of the remaining population
    :math:`M-(k+r-1)`. This relationship can be shown as:

    .. math:: NHG(k;M,n,r) = HG(k;M,n,k+r-1)\frac{(M-n-(r-1))}{(M-(k+r-1))}

    where :math:`NHG` is probability mass function (PMF) of the
    negative hypergeometric distribution and :math:`HG` is the
    PMF of the hypergeometric distribution.

    %(after_notes)s

    Examples
    --------
    >>> from scipy.stats import nhypergeom
    >>> import matplotlib.pyplot as plt

    Suppose we have a collection of 20 animals, of which 7 are dogs.
    Then if we want to know the probability of finding a given number
    of dogs (successes) in a sample with exactly 12 animals that
    aren't dogs (failures), we can initialize a frozen distribution
    and plot the probability mass function:

    >>> M, n, r = [20, 7, 12]
    >>> rv = nhypergeom(M, n, r)
    >>> x = np.arange(0, n+2)
    >>> pmf_dogs = rv.pmf(x)

    >>> fig = plt.figure()
    >>> ax = fig.add_subplot(111)
    >>> ax.plot(x, pmf_dogs, 'bo')
    >>> ax.vlines(x, 0, pmf_dogs, lw=2)
    >>> ax.set_xlabel('# of dogs in our group with given 12 failures')
    >>> ax.set_ylabel('nhypergeom PMF')
    >>> plt.show()

    Instead of using a frozen distribution we can also use `nhypergeom`
    methods directly.  To for example obtain the probability mass
    function, use:

    >>> prb = nhypergeom.pmf(x, M, n, r)

    And to generate random numbers:

    >>> R = nhypergeom.rvs(M, n, r, size=10)

    To verify the relationship between `hypergeom` and `nhypergeom`, use:

    >>> from scipy.stats import hypergeom, nhypergeom
    >>> M, n, r = 45, 13, 8
    >>> k = 6
    >>> nhypergeom.pmf(k, M, n, r)
    0.06180776620271643
    >>> hypergeom.pmf(k, M, n, k+r-1) * (M - n - (r-1)) / (M - (k+r-1))
    0.06180776620271644

    See Also
    --------
    hypergeom, binom, nbinom

    References
    ----------
    .. [1] Negative Hypergeometric Distribution on Wikipedia
           https://en.wikipedia.org/wiki/Negative_hypergeometric_distribution

    .. [2] Negative Hypergeometric Distribution from
           http://www.math.wm.edu/~leemis/chart/UDR/PDFs/Negativehypergeometric.pdf

    c                 C   s:   t dddtjfdƒt dddtjfdƒt dddtjfdƒgS )Nr›   Tr   r+   r*   Úrr/   r1   r%   r%   r&   r3   Ã  s    þznhypergeom_gen._shape_infoc                 C   s   d|fS ru   r%   )r2   r›   r*   r±   r%   r%   r&   r?   È  s    znhypergeom_gen._get_supportc                 C   sD   |dk||k@ |dk@ ||| k@ }|t |ƒt |ƒ@ t |ƒ@ M }|S ru   r:   )r2   r›   r*   r±   rƒ   r%   r%   r&   r<   Ë  s    $znhypergeom_gen._argcheckNc                    s"   t ‡ fdd„ƒ}||||||d�S )Nc                    sl   ˆ   | ||¡\}}t ||d ¡}ˆ  || ||¡}t||ddd�}	|	|j|d�ƒ t¡}
|d u rh|
 ¡ S |
S )Nr   ÚnextZextrapolate)ÚkindZ
fill_valuerŽ   )	Zsupportr!   r«   r‚   r   ÚuniformÚastypeÚintÚitem)r›   r*   r±   r6   r7   r>   ro   Úksr‚   ZppfÚrvsr1   r%   r&   Ú_rvs1Ò  s    z"nhypergeom_gen._rvs.<locals>._rvs1rl   ©Ú_vectorize_rvs_over_shapes)r2   r›   r*   r±   r6   r7   rº   r%   r1   r&   r8   Ð  s    znhypergeom_gen._rvsc                 C   s2   |dk|dk@ }t | ||||fdd„ dd�}|S )Nr   c                 S   sv   t | d |ƒ t | | dƒ t ||  d || | d ƒ t || |  d dƒ t |d || d ƒ t |d dƒ S r@   rŸ   )rD   r›   r*   r±   r%   r%   r&   Ú<lambda>ã  s    ÿÿþþz(nhypergeom_gen._logpmf.<locals>.<lambda>ç        )Ú	fillvalue)r	   )r2   rD   r›   r*   r±   rƒ   r£   r%   r%   r&   rF   à  s    ûznhypergeom_gen._logpmfc                 C   s   t |  ||||¡ƒS r    rw   )r2   rD   r›   r*   r±   r%   r%   r&   rM   ê  s    znhypergeom_gen._pmfc                 C   s€   d| d| d|   }}}|| || d  }||d  | || d || d   d||| d    }d\}}||||fS )Nrx   r   ry   rU   r%   )r2   r›   r*   r±   rX   rY   rZ   r[   r%   r%   r&   r\   ï  s
    <znhypergeom_gen._stats)NN)rc   rd   re   rf   r3   r?   r<   r8   rF   rM   r\   r%   r%   r%   r&   r°   _  s   c

r°   Ú
nhypergeomc                   @   s:   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ ZdS )Ú
logser_genaÔ  A Logarithmic (Log-Series, Series) discrete random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `logser` is:

    .. math::

        f(k) = - \frac{p^k}{k \log(1-p)}

    for :math:`k \ge 1`, :math:`0 < p < 1`

    `logser` takes :math:`p` as shape parameter,
    where :math:`p` is the probability of a single success
    and :math:`1-p` is the probability of a single failure.

    %(after_notes)s

    %(example)s

    c                 C   s   t ddddƒgS rj   rk   r1   r%   r%   r&   r3     s    zlogser_gen._shape_infoNc                 C   s   |j ||d�S r�   )Z	logseriesrm   r%   r%   r&   r8     s    zlogser_gen._rvsc                 C   s   |dk|dk @ S r9   r%   rn   r%   r%   r&   r<   "  s    zlogser_gen._argcheckc                 C   s"   t  ||¡ d | t | ¡ S ©Nrx   )r!   r‘   r   r   r’   r%   r%   r&   rM   %  s    zlogser_gen._pmfc                 C   s  t  | ¡}||d  | }| | |d d  }|||  }| | d|  d| d  }|d| |  d|d   }|t |d¡ }| | d|d d  d| |d d   d| | |d d    }	|	d| |  d| | |  d|d   }
|
|d  d }||||fS )	Nrx   ry   r{   ç      ø?r   rz   é   r¥   )r   r   r!   r‘   )r2   r,   r±   rX   Zmu2prY   Zmu3pZmu3rZ   Zmu4pÚmu4r[   r%   r%   r&   r\   )  s    :ÿ,zlogser_gen._stats)NN)	rc   rd   re   rf   r3   r8   r<   rM   r\   r%   r%   r%   r&   rÁ     s   
rÁ   ÚlogserzA logarithmicc                   @   sZ   e Zd ZdZdd„ Zdd„ Zddd„Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ ZdS )Úpoisson_gena›  A Poisson discrete random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `poisson` is:

    .. math::

        f(k) = \exp(-\mu) \frac{\mu^k}{k!}

    for :math:`k \ge 0`.

    `poisson` takes :math:`\mu \geq 0` as shape parameter.
    When :math:`\mu = 0`, the ``pmf`` method
    returns ``1.0`` at quantile :math:`k = 0`.

    %(after_notes)s

    %(example)s

    c                 C   s   t dddtjfdƒgS )NrX   Fr   r+   r/   r1   r%   r%   r&   r3   U  s    zpoisson_gen._shape_infoc                 C   s   |dkS ru   r%   )r2   rX   r%   r%   r&   r<   Y  s    zpoisson_gen._argcheckNc                 C   s   |  ||¡S r    ©Úpoisson)r2   rX   r6   r7   r%   r%   r&   r8   \  s    zpoisson_gen._rvsc                 C   s    t  ||¡t|d ƒ | }|S r@   )r   rB   rA   )r2   rD   rX   ÚPkr%   r%   r&   rF   _  s    zpoisson_gen._logpmfc                 C   s   t |  ||¡ƒS r    rw   )r2   rD   rX   r%   r%   r&   rM   c  s    zpoisson_gen._pmfc                 C   s   t |ƒ}t ||¡S r    )r   r   Úpdtr©r2   r$   rX   rD   r%   r%   r&   rO   g  s    zpoisson_gen._cdfc                 C   s   t |ƒ}t ||¡S r    )r   r   ZpdtrcrÌ   r%   r%   r&   rP   k  s    zpoisson_gen._sfc                 C   s>   t t ||¡ƒ}t |d d¡}t ||¡}t ||k||¡S r�   )r   r   Zpdtrikr!   rž   rË   r•   )r2   rR   rX   r`   Úvals1r–   r%   r%   r&   rS   o  s    zpoisson_gen._ppfc                 C   sN   |}t  |¡}|dk}t||fdd„ t jƒ}t||fdd„ t jƒ}||||fS )Nr   c                 S   s   t d|  ƒS rÂ   r}   r#   r%   r%   r&   r½   y  ó    z$poisson_gen._stats.<locals>.<lambda>c                 S   s   d|  S rÂ   r%   r#   r%   r%   r&   r½   z  rÎ   )r!   r¬   r	   r0   )r2   rX   rY   ÚtmpZ
mu_nonzerorZ   r[   r%   r%   r&   r\   u  s    
zpoisson_gen._stats)NN)rc   rd   re   rf   r3   r<   r8   rF   rM   rO   rP   rS   r\   r%   r%   r%   r&   rÇ   <  s   
rÇ   rÉ   z	A Poisson)rh   r™   c                   @   sb   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Z	dd„ Z
ddd„Zdd„ Zdd„ ZdS )Ú
planck_gena  A Planck discrete exponential random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `planck` is:

    .. math::

        f(k) = (1-\exp(-\lambda)) \exp(-\lambda k)

    for :math:`k \ge 0` and :math:`\lambda > 0`.

    `planck` takes :math:`\lambda` as shape parameter. The Planck distribution
    can be written as a geometric distribution (`geom`) with
    :math:`p = 1 - \exp(-\lambda)` shifted by ``loc = -1``.

    %(after_notes)s

    See Also
    --------
    geom

    %(example)s

    c                 C   s   t dddtjfdƒgS )NÚlambdaFr   rs   r/   r1   r%   r%   r&   r3   �  s    zplanck_gen._shape_infoc                 C   s   |dkS ru   r%   )r2   Úlambda_r%   r%   r&   r<      s    zplanck_gen._argcheckc                 C   s   t | ƒ t| | ƒ S r    )r   r   )r2   rD   rÒ   r%   r%   r&   rM   £  s    zplanck_gen._pmfc                 C   s   t |ƒ}t| |d  ƒ S r@   )r   r   ©r2   r$   rÒ   rD   r%   r%   r&   rO   ¦  s    zplanck_gen._cdfc                 C   s   t |  ||¡ƒS r    )r   r”   )r2   r$   rÒ   r%   r%   r&   rP   ª  s    zplanck_gen._sfc                 C   s   t |ƒ}| |d  S r@   ©r   rÓ   r%   r%   r&   r”   ­  s    zplanck_gen._logsfc                 C   sL   t d| t| ƒ d ƒ}|d j|  |¡Ž }|  ||¡}t ||k||¡S )Nç      ð¿r   )r   r   Úclipr?   rO   r!   r•   )r2   rR   rÒ   r`   rÍ   r–   r%   r%   r&   rS   ±  s    zplanck_gen._ppfNc                 C   s   t | ƒ }|j||d�d S )NrŽ   rx   )r   r�   )r2   rÒ   r6   r7   r,   r%   r%   r&   r8   ·  s    zplanck_gen._rvsc                 C   sP   dt |ƒ }t| ƒt | ƒd  }dt|d ƒ }ddt|ƒ  }||||fS )Nr   ry   r—   rÄ   )r   r   r   )r2   rÒ   rX   rY   rZ   r[   r%   r%   r&   r\   ¼  s
    zplanck_gen._statsc                 C   s&   t | ƒ }|t| ƒ | t|ƒ S r    )r   r   r   )r2   rÒ   ÚCr%   r%   r&   ra   Ã  s    zplanck_gen._entropy)NN)rc   rd   re   rf   r3   r<   rM   rO   rP   r”   rS   r8   r\   ra   r%   r%   r%   r&   rÐ   �  s   
rÐ   ÚplanckzA discrete exponential c                   @   sH   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Z	dd„ Z
dS )Úboltzmann_gena—  A Boltzmann (Truncated Discrete Exponential) random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `boltzmann` is:

    .. math::

        f(k) = (1-\exp(-\lambda)) \exp(-\lambda k) / (1-\exp(-\lambda N))

    for :math:`k = 0,..., N-1`.

    `boltzmann` takes :math:`\lambda > 0` and :math:`N > 0` as shape parameters.

    %(after_notes)s

    %(example)s

    c                 C   s(   t dddtjfdƒt dddtjfdƒgS )NrÒ   Fr   rs   rœ   Tr/   r1   r%   r%   r&   r3   á  s    ÿzboltzmann_gen._shape_infoc                 C   s   |dk|dk@ t |ƒ@ S ru   r:   ©r2   rÒ   rœ   r%   r%   r&   r<   å  s    zboltzmann_gen._argcheckc                 C   s   | j |d fS r@   r=   rÚ   r%   r%   r&   r?   è  s    zboltzmann_gen._get_supportc                 C   s2   dt | ƒ dt | | ƒ  }|t | | ƒ S r@   ©r   )r2   rD   rÒ   rœ   Zfactr%   r%   r&   rM   ë  s     zboltzmann_gen._pmfc                 C   s0   t |ƒ}dt| |d  ƒ dt| | ƒ  S r@   )r   r   )r2   r$   rÒ   rœ   rD   r%   r%   r&   rO   ñ  s    zboltzmann_gen._cdfc                 C   sd   |dt | | ƒ  }td| td| ƒ d ƒ}|d  dtj¡}|  |||¡}t ||k||¡S )Nr   rÕ   r¾   )r   r   r   rÖ   r!   r0   rO   r•   )r2   rR   rÒ   rœ   Zqnewr`   rÍ   r–   r%   r%   r&   rS   õ  s
    zboltzmann_gen._ppfc                 C   s  t | ƒ}t | | ƒ}|d|  || d|   }|d| d  || | d| d   }d| d|  }||d  || |  }|d|  |d  |d | d|   }	|	|d  }	|dd|  ||   |d  |d | dd|  ||    }
|
| | }
|||	|
fS )Nrx   r   ry   r{   rÃ   rÄ   rÛ   )r2   rÒ   rœ   ÚzZzNrX   rY   ZtrmZtrm2rZ   r[   r%   r%   r&   r\   ü  s    
((@zboltzmann_gen._statsN)rc   rd   re   rf   r3   r<   r?   rM   rO   rS   r\   r%   r%   r%   r&   rÙ   Ë  s   rÙ   Ú	boltzmannz!A truncated discrete exponential )rh   r>   r™   c                   @   sZ   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Z	dd„ Z
ddd„Zdd„ ZdS )Úrandint_gena”  A uniform discrete random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `randint` is:

    .. math::

        f(k) = \frac{1}{\texttt{high} - \texttt{low}}

    for :math:`k \in \{\texttt{low}, \dots, \texttt{high} - 1\}`.

    `randint` takes :math:`\texttt{low}` and :math:`\texttt{high}` as shape
    parameters.

    %(after_notes)s

    %(example)s

    c                 C   s0   t ddtj tjfdƒt ddtj tjfdƒgS )NÚlowTrs   Úhighr/   r1   r%   r%   r&   r3   &  s    ÿzrandint_gen._shape_infoc                 C   s   ||kt |ƒ@ t |ƒ@ S r    r:   ©r2   rß   rà   r%   r%   r&   r<   *  s    zrandint_gen._argcheckc                 C   s   ||d fS r@   r%   rá   r%   r%   r&   r?   -  s    zrandint_gen._get_supportc                 C   s,   t  |¡||  }t  ||k||k @ |d¡S )Nr¾   )r!   Z	ones_liker•   )r2   rD   rß   rà   r,   r%   r%   r&   rM   0  s    zrandint_gen._pmfc                 C   s   t |ƒ}|| d ||  S rÂ   rÔ   )r2   r$   rß   rà   rD   r%   r%   r&   rO   5  s    zrandint_gen._cdfc                 C   sH   t |||  | ƒd }|d  ||¡}|  |||¡}t ||k||¡S r@   )r   rÖ   rO   r!   r•   )r2   rR   rß   rà   r`   rÍ   r–   r%   r%   r&   rS   9  s    zrandint_gen._ppfc           
      C   sj   t  |¡t  |¡ }}|| d d }|| }|| d d }d}d|| d  || d  }	||||	fS )Nrx   ry   r   g      (@r¾   g333333ó¿)r!   r¬   )
r2   rß   rà   Úm2Úm1rX   ÚdrY   rZ   r[   r%   r%   r&   r\   ?  s    zrandint_gen._statsNc                 C   sr   t  |¡jdkr0t  |¡jdkr0t||||d�S |durPt  ||¡}t  ||¡}t jtt|ƒt jgd�}|||ƒS )z=An array of *size* random integers >= ``low`` and < ``high``.r   rŽ   N)Zotypes)r!   r¬   r6   r
   Zbroadcast_toÚ	vectorizer   Úint_)r2   rß   rà   r6   r7   Úrandintr%   r%   r&   r8   H  s     ÿzrandint_gen._rvsc                 C   s   t || ƒS r    )r   rá   r%   r%   r&   ra   Y  s    zrandint_gen._entropy)NN)rc   rd   re   rf   r3   r<   r?   rM   rO   rS   r\   r8   ra   r%   r%   r%   r&   rÞ     s   	
rÞ   rç   z#A discrete uniform (random integer)c                   @   s:   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ ZdS )Úzipf_genaŒ  A Zipf (Zeta) discrete random variable.

    %(before_notes)s

    See Also
    --------
    zipfian

    Notes
    -----
    The probability mass function for `zipf` is:

    .. math::

        f(k, a) = \frac{1}{\zeta(a) k^a}

    for :math:`k \ge 1`, :math:`a > 1`.

    `zipf` takes :math:`a > 1` as shape parameter. :math:`\zeta` is the
    Riemann zeta function (`scipy.special.zeta`)

    The Zipf distribution is also known as the zeta distribution, which is
    a special case of the Zipfian distribution (`zipfian`).

    %(after_notes)s

    References
    ----------
    .. [1] "Zeta Distribution", Wikipedia,
           https://en.wikipedia.org/wiki/Zeta_distribution

    %(example)s

    Confirm that `zipf` is the large `n` limit of `zipfian`.

    >>> from scipy.stats import zipfian
    >>> k = np.arange(11)
    >>> np.allclose(zipf.pmf(k, a), zipfian.pmf(k, a, n=10000000))
    True

    c                 C   s   t dddtjfdƒgS )Nr>   Fr   rs   r/   r1   r%   r%   r&   r3   �  s    zzipf_gen._shape_infoNc                 C   s   |j ||d�S r�   )Úzipf)r2   r>   r6   r7   r%   r%   r&   r8   �  s    zzipf_gen._rvsc                 C   s   |dkS r@   r%   ©r2   r>   r%   r%   r&   r<   “  s    zzipf_gen._argcheckc                 C   s   dt  |d¡ ||  }|S ©Nrx   r   ©r   r   )r2   rD   r>   rÊ   r%   r%   r&   rM   –  s    zzipf_gen._pmfc                 C   s    t ||d k||fdd„ tjƒS )Nr   c                 S   s   t  | | d¡t  | d¡ S r@   rì   )r>   r*   r%   r%   r&   r½   ž  rÎ   z zipf_gen._munp.<locals>.<lambda>)r	   r!   r0   )r2   r*   r>   r%   r%   r&   Ú_munp›  s
    ýzzipf_gen._munp)NN)	rc   rd   re   rf   r3   r8   r<   rM   rí   r%   r%   r%   r&   rè   b  s   *
rè   ré   zA Zipfc                 C   s   t |dƒt || d ƒ S )z"Generalized harmonic number, a > 1r   )r   ©r*   r>   r%   r%   r&   Ú_gen_harmonic_gt1¥  s    rï   c                 C   sf   t  | ¡s| S t  | ¡}t j|td�}t j|ddtd�D ](}|| k}||  d|||   7  < q8|S )z#Generalized harmonic number, a <= 1©Zdtyper   éÿÿÿÿr   )r!   r6   ÚmaxZ
zeros_likeÚfloatr«   )r*   r>   Zn_maxÚoutÚiÚmaskr%   r%   r&   Ú_gen_harmonic_leq1«  s    

r÷   c                 C   s(   t  | |¡\} }t|dk| |fttd�S )zGeneralized harmonic numberr   ©ÚfÚf2)r!   r©   r	   rï   r÷   rî   r%   r%   r&   Ú_gen_harmonic¸  s    ÿrû   c                   @   sH   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Z	dd„ Z
dS )Úzipfian_gena`  A Zipfian discrete random variable.

    %(before_notes)s

    See Also
    --------
    zipf

    Notes
    -----
    The probability mass function for `zipfian` is:

    .. math::

        f(k, a, n) = \frac{1}{H_{n,a} k^a}

    for :math:`k \in \{1, 2, \dots, n-1, n\}`, :math:`a \ge 0`,
    :math:`n \in \{1, 2, 3, \dots\}`.

    `zipfian` takes :math:`a` and :math:`n` as shape parameters.
    :math:`H_{n,a}` is the :math:`n`:sup:`th` generalized harmonic
    number of order :math:`a`.

    The Zipfian distribution reduces to the Zipf (zeta) distribution as
    :math:`n \rightarrow \infty`.

    %(after_notes)s

    References
    ----------
    .. [1] "Zipf's Law", Wikipedia, https://en.wikipedia.org/wiki/Zipf's_law
    .. [2] Larry Leemis, "Zipf Distribution", Univariate Distribution
           Relationships. http://www.math.wm.edu/~leemis/chart/UDR/PDFs/Zipf.pdf

    %(example)s

    Confirm that `zipfian` reduces to `zipf` for large `n`, `a > 1`.

    >>> from scipy.stats import zipf
    >>> k = np.arange(11)
    >>> np.allclose(zipfian.pmf(k, a=3.5, n=10000000), zipf.pmf(k, a=3.5))
    True

    c                 C   s(   t dddtjfdƒt dddtjfdƒgS )Nr>   Fr   r+   r*   Trs   r/   r1   r%   r%   r&   r3   í  s    ÿzzipfian_gen._shape_infoc                 C   s"   |dk|dk@ |t j|td�k@ S )Nr   rð   )r!   r¬   r¶   ©r2   r>   r*   r%   r%   r&   r<   ñ  s    zzipfian_gen._argcheckc                 C   s   d|fS r@   r%   rý   r%   r%   r&   r?   õ  s    zzipfian_gen._get_supportc                 C   s   dt ||ƒ ||  S rÂ   ©rû   ©r2   rD   r>   r*   r%   r%   r&   rM   ø  s    zzipfian_gen._pmfc                 C   s   t ||ƒt ||ƒ S r    rþ   rÿ   r%   r%   r&   rO   û  s    zzipfian_gen._cdfc                 C   s:   |d }|| t ||ƒt ||ƒ  d || t ||ƒ  S r@   rþ   rÿ   r%   r%   r&   rP   þ  s    ÿzzipfian_gen._sfc                 C   sþ   t ||ƒ}t ||d ƒ}t ||d ƒ}t ||d ƒ}t ||d ƒ}|| }|| |d  }	|d }
|	|
 }|| d| | |d   d|d  |d   |d  }|d | d|d  | |  d| |d  |  d|d   |	d  }|d8 }||||fS )Nr   ry   r{   rÄ   rÃ   rz   rþ   )r2   r>   r*   ZHnaZHna1ZHna2ZHna3ZHna4Úmu1Zmu2nZmu2dÚmu2rZ   r[   r%   r%   r&   r\     s"    
82
ÿÿzzipfian_gen._statsN)rc   rd   re   rf   r3   r<   r?   rM   rO   rP   r\   r%   r%   r%   r&   rü   ¿  s   -rü   Úzipfianz	A Zipfianc                   @   sJ   e Zd ZdZdd„ Zdd„ Zdd„ Zdd	„ Zd
d„ Zdd„ Z	ddd„Z
dS )Údlaplace_genaL  A  Laplacian discrete random variable.

    %(before_notes)s

    Notes
    -----
    The probability mass function for `dlaplace` is:

    .. math::

        f(k) = \tanh(a/2) \exp(-a |k|)

    for integers :math:`k` and :math:`a > 0`.

    `dlaplace` takes :math:`a` as shape parameter.

    %(after_notes)s

    %(example)s

    c                 C   s   t dddtjfdƒgS )Nr>   Fr   rs   r/   r1   r%   r%   r&   r3   0  s    zdlaplace_gen._shape_infoc                 C   s   t |d ƒt| t|ƒ ƒ S ©Nr—   )r   r   Úabs)r2   rD   r>   r%   r%   r&   rM   3  s    zdlaplace_gen._pmfc                 C   s0   t |ƒ}dd„ }dd„ }t|dk||f||d�S )Nc                 S   s   dt | |  ƒt |ƒd   S rë   rÛ   ©rD   r>   r%   r%   r&   r½   9  rÎ   z#dlaplace_gen._cdf.<locals>.<lambda>c                 S   s   t || d  ƒt |ƒd  S r@   rÛ   r  r%   r%   r&   r½   :  rÎ   r   rø   )r   r	   )r2   r$   r>   rD   rù   rú   r%   r%   r&   rO   7  s    zdlaplace_gen._cdfc                 C   st   dt |ƒ }tt |ddt | ƒ  k t|| ƒ| d td| | ƒ | ¡ƒ}|d }t |  ||¡|k||¡S )Nr   rx   )r   r   r!   r•   r   rO   )r2   rR   r>   Úconstr`   rÍ   r%   r%   r&   rS   =  s    þzdlaplace_gen._ppfc                 C   s\   t |ƒ}d| |d d  }d| |d d|  d  |d d  }d|d||d  d fS )Nr—   rx   ry   g      $@rÄ   r¾   r¥   rÛ   )r2   r>   Zear  rÅ   r%   r%   r&   r\   E  s    (zdlaplace_gen._statsc                 C   s   |t |ƒ tt|d ƒƒ S r  )r   r   r   rê   r%   r%   r&   ra   K  s    zdlaplace_gen._entropyNc                 C   s8   t  t  |¡ ¡ }|j||d�}|j||d�}|| S r�   )r!   r   r¬   r�   )r2   r>   r6   r7   ZprobOfSuccessr$   Úyr%   r%   r&   r8   N  s    zdlaplace_gen._rvs)NN)rc   rd   re   rf   r3   rM   rO   rS   r\   ra   r8   r%   r%   r%   r&   r    s   r  ÚdlaplacezA discrete Laplacianc                   @   s:   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ ZdS )Úskellam_genaÍ  A  Skellam discrete random variable.

    %(before_notes)s

    Notes
    -----
    Probability distribution of the difference of two correlated or
    uncorrelated Poisson random variables.

    Let :math:`k_1` and :math:`k_2` be two Poisson-distributed r.v. with
    expected values :math:`\lambda_1` and :math:`\lambda_2`. Then,
    :math:`k_1 - k_2` follows a Skellam distribution with parameters
    :math:`\mu_1 = \lambda_1 - \rho \sqrt{\lambda_1 \lambda_2}` and
    :math:`\mu_2 = \lambda_2 - \rho \sqrt{\lambda_1 \lambda_2}`, where
    :math:`\rho` is the correlation coefficient between :math:`k_1` and
    :math:`k_2`. If the two Poisson-distributed r.v. are independent then
    :math:`\rho = 0`.

    Parameters :math:`\mu_1` and :math:`\mu_2` must be strictly positive.

    For details see: https://en.wikipedia.org/wiki/Skellam_distribution

    `skellam` takes :math:`\mu_1` and :math:`\mu_2` as shape parameters.

    %(after_notes)s

    %(example)s

    c                 C   s(   t dddtjfdƒt dddtjfdƒgS )Nr   Fr   rs   r  r/   r1   r%   r%   r&   r3   †  s    ÿzskellam_gen._shape_infoNc                 C   s   |}|  ||¡|  ||¡ S r    rÈ   )r2   r   r  r6   r7   r*   r%   r%   r&   r8   Š  s    

ÿzskellam_gen._rvsc              	   C   sN   t  |dk td| dd|  d| ƒd td| dd|  d| ƒd ¡}|S )Nr   ry   r   )r!   r•   r   ©r2   r$   r   r  Zpxr%   r%   r&   rM   �  s
    
þzskellam_gen._pmfc              
   C   sN   t |ƒ}t |dk td| d| d| ƒdtd| d|d  d| ƒ ¡}|S )Nr   ry   éþÿÿÿr   )r   r!   r•   r   r  r%   r%   r&   rO   –  s    
þzskellam_gen._cdfc                 C   s4   || }|| }|t |d ƒ }d| }||||fS )Nr{   r   r}   )r2   r   r  ÚmeanrY   rZ   r[   r%   r%   r&   r\   �  s
    zskellam_gen._stats)NN)	rc   rd   re   rf   r3   r8   rM   rO   r\   r%   r%   r%   r&   r
  h  s   
r
  Úskellamz	A Skellamc                   @   sZ   e Zd ZdZdd„ Zddd„Zdd„ Zd	d
„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zdd„ ZdS )Úyulesimon_genaî  A Yule-Simon discrete random variable.

    %(before_notes)s

    Notes
    -----

    The probability mass function for the `yulesimon` is:

    .. math::

        f(k) =  \alpha B(k, \alpha+1)

    for :math:`k=1,2,3,...`, where :math:`\alpha>0`.
    Here :math:`B` refers to the `scipy.special.beta` function.

    The sampling of random variates is based on pg 553, Section 6.3 of [1]_.
    Our notation maps to the referenced logic via :math:`\alpha=a-1`.

    For details see the wikipedia entry [2]_.

    References
    ----------
    .. [1] Devroye, Luc. "Non-uniform Random Variate Generation",
         (1986) Springer, New York.

    .. [2] https://en.wikipedia.org/wiki/Yule-Simon_distribution

    %(after_notes)s

    %(example)s

    c                 C   s   t dddtjfdƒgS )NÚalphaFr   rs   r/   r1   r%   r%   r&   r3   Ê  s    zyulesimon_gen._shape_infoNc                 C   s6   |  |¡}|  |¡}t| tt| | ƒ ƒ ƒ}|S r    )Zstandard_exponentialr   r   r   )r2   r  r6   r7   ZE1ZE2Zansr%   r%   r&   r8   Í  s    

zyulesimon_gen._rvsc                 C   s   |t  ||d ¡ S r@   ©r   rt   ©r2   r$   r  r%   r%   r&   rM   Ó  s    zyulesimon_gen._pmfc                 C   s   |dkS ru   r%   )r2   r  r%   r%   r&   r<   Ö  s    zyulesimon_gen._argcheckc                 C   s   t |ƒt ||d ¡ S r@   ©r   r   r   r  r%   r%   r&   rF   Ù  s    zyulesimon_gen._logpmfc                 C   s   d|t  ||d ¡  S r@   r  r  r%   r%   r&   rO   Ü  s    zyulesimon_gen._cdfc                 C   s   |t  ||d ¡ S r@   r  r  r%   r%   r&   rP   ß  s    zyulesimon_gen._sfc                 C   s   t |ƒt ||d ¡ S r@   r  r  r%   r%   r&   r”   â  s    zyulesimon_gen._logsfc                 C   s  t  |dkt j||d  ¡}t  |dk|d |d |d d   t j¡}t  |dkt j|¡}t  |dkt|d ƒ|d d  ||d   t j¡}t  |dkt j|¡}t  |dk|d |d d|  d ||d  |d    t j¡}t  |dkt j|¡}||||fS )Nr   ry   r—   r{   rÄ   é1   é   )r!   r•   r0   Únanr   )r2   r  rX   r  rZ   r[   r%   r%   r&   r\   å  s*    
þ
"þ
ÿÿþzyulesimon_gen._stats)NN)rc   rd   re   rf   r3   r8   rM   r<   rF   rO   rP   r”   r\   r%   r%   r%   r&   r  ¨  s   !
r  Ú	yulesimon)rh   r>   c                    s   ‡ fdd„}|S )z?Decorator that vectorizes _rvs method to work on ndarray shapesc                    sÚ   t |d j| ƒ\}}t | ¡} t |¡}t |¡}t |¡rRˆg |¢| ‘|‘R Ž S t | ¡}t |j¡}t ||  || f¡}t 	|||¡}tj
| |  Ž D ],‰ ˆg ‡ fdd„|D ƒ¢|‘|‘R Ž |ˆ < qžt 	|||¡S )Nr   c                    s   g | ]}t  |¡ˆ  ‘qS r%   )r!   Zsqueeze)Ú.0Úarg©rõ   r%   r&   Ú
<listcomp>  rÎ   z<_vectorize_rvs_over_shapes.<locals>._rvs.<locals>.<listcomp>)r   Úshaper!   ÚarrayÚallÚemptyr«   ÚndimZhstackZmoveaxisZndindex)r6   r7   ÚargsZ
_rvs1_sizeZ_rvs1_indicesrô   Zj0Zj1©rº   r  r&   r8     s"    




ÿÿz(_vectorize_rvs_over_shapes.<locals>._rvsr%   )rº   r8   r%   r"  r&   r¼   ù  s    	r¼   c                   @   sJ   e Zd ZdZdZdZdd„ Zdd„ Zdd„ Zdd	d
„Z	dd„ Z
dd„ ZdS )Ú_nchypergeom_genz‰A noncentral hypergeometric discrete random variable.

    For subclassing by nchypergeom_fisher_gen and nchypergeom_wallenius_gen.

    Nc                 C   sL   t dddtjfdƒt dddtjfdƒt dddtjfdƒt dddtjfd	ƒgS )
Nr›   Tr   r+   r*   rœ   ÚoddsFrs   r/   r1   r%   r%   r&   r3   )  s
    ýz_nchypergeom_gen._shape_infoc           	      C   s<   |||  }}}|| }t  d|| ¡}t  ||¡}||fS ru   r�   )	r2   r›   r*   rœ   r$  rã   râ   Zx_minZx_maxr%   r%   r&   r?   /  s
    z_nchypergeom_gen._get_supportc                 C   sž   t  |¡t  |¡ }}t  |¡t  |¡ }}| t¡|k|dk@ }| t¡|k|dk@ }| t¡|k|dk@ }|dk}||k}	||k}
||@ |@ |@ |	@ |
@ S ru   )r!   r¬   rµ   r¶   )r2   r›   r*   rœ   r$  Zcond1Zcond2Zcond3Zcond4Zcond5Zcond6r%   r%   r&   r<   6  s    z_nchypergeom_gen._argcheckc                    s$   t ‡ fdd„ƒ}|||||||d�S )Nc           
         s<   t  |¡}tƒ }t|ˆ jƒ}|||| |||ƒ}	|	 |¡}	|	S r    )r!   Úprodr   ÚgetattrÚrvs_nameZreshape)
r›   r*   rœ   r$  r6   r7   ÚlengthÚurnZrv_genr¹   r1   r%   r&   rº   C  s    

z$_nchypergeom_gen._rvs.<locals>._rvs1rl   r»   )r2   r›   r*   rœ   r$  r6   r7   rº   r%   r1   r&   r8   A  s    z_nchypergeom_gen._rvsc                    sR   t  |||||¡\}}}}}|jdkr0t  |¡S t j‡ fdd„ƒ}||||||ƒS )Nr   c                    s   ˆ   ||||d¡}| | ¡S ©Ngê-�™—q=)ÚdistZprobability)r$   r›   r*   rœ   r$  r)  r1   r%   r&   Ú_pmf1T  s    z$_nchypergeom_gen._pmf.<locals>._pmf1)r!   r©   r6   Z
empty_likerå   )r2   r$   r›   r*   rœ   r$  r,  r%   r1   r&   rM   N  s    

z_nchypergeom_gen._pmfc                    sL   t j‡ fdd„ƒ}d|v s"d|v r0|||||ƒnd\}}d\}	}
|||	|
fS )Nc                    s   ˆ   ||| |d¡}| ¡ S r*  )r+  rW   )r›   r*   rœ   r$  r)  r1   r%   r&   Ú	_moments1]  s    z*_nchypergeom_gen._stats.<locals>._moments1r¦   ÚvrU   )r!   rå   )r2   r›   r*   rœ   r$  rW   r-  r¦   r.  rV   rD   r%   r1   r&   r\   [  s    ÿz_nchypergeom_gen._stats)NN)rc   rd   re   rf   r'  r+  r3   r?   r<   r8   rM   r\   r%   r%   r%   r&   r#    s   
r#  c                   @   s   e Zd ZdZdZeZdS )Únchypergeom_fisher_genag	  A Fisher's noncentral hypergeometric discrete random variable.

    Fisher's noncentral hypergeometric distribution models drawing objects of
    two types from a bin. `M` is the total number of objects, `n` is the
    number of Type I objects, and `odds` is the odds ratio: the odds of
    selecting a Type I object rather than a Type II object when there is only
    one object of each type.
    The random variate represents the number of Type I objects drawn if we
    take a handful of objects from the bin at once and find out afterwards
    that we took `N` objects.

    %(before_notes)s

    See Also
    --------
    nchypergeom_wallenius, hypergeom, nhypergeom

    Notes
    -----
    Let mathematical symbols :math:`N`, :math:`n`, and :math:`M` correspond
    with parameters `N`, `n`, and `M` (respectively) as defined above.

    The probability mass function is defined as

    .. math::

        p(x; M, n, N, \omega) =
        \frac{\binom{n}{x}\binom{M - n}{N-x}\omega^x}{P_0},

    for
    :math:`x \in [x_l, x_u]`,
    :math:`M \in {\mathbb N}`,
    :math:`n \in [0, M]`,
    :math:`N \in [0, M]`,
    :math:`\omega > 0`,
    where
    :math:`x_l = \max(0, N - (M - n))`,
    :math:`x_u = \min(N, n)`,

    .. math::

        P_0 = \sum_{y=x_l}^{x_u} \binom{n}{y}\binom{M - n}{N-y}\omega^y,

    and the binomial coefficients are defined as

    .. math:: \binom{n}{k} \equiv \frac{n!}{k! (n - k)!}.

    `nchypergeom_fisher` uses the BiasedUrn package by Agner Fog with
    permission for it to be distributed under SciPy's license.

    The symbols used to denote the shape parameters (`N`, `n`, and `M`) are not
    universally accepted; they are chosen for consistency with `hypergeom`.

    Note that Fisher's noncentral hypergeometric distribution is distinct
    from Wallenius' noncentral hypergeometric distribution, which models
    drawing a pre-determined `N` objects from a bin one by one.
    When the odds ratio is unity, however, both distributions reduce to the
    ordinary hypergeometric distribution.

    %(after_notes)s

    References
    ----------
    .. [1] Agner Fog, "Biased Urn Theory".
           https://cran.r-project.org/web/packages/BiasedUrn/vignettes/UrnTheory.pdf

    .. [2] "Fisher's noncentral hypergeometric distribution", Wikipedia,
           https://en.wikipedia.org/wiki/Fisher's_noncentral_hypergeometric_distribution

    %(example)s

    Z
rvs_fisherN)rc   rd   re   rf   r'  r   r+  r%   r%   r%   r&   r/  h  s   Ir/  Únchypergeom_fisherz$A Fisher's noncentral hypergeometricc                   @   s   e Zd ZdZdZeZdS )Únchypergeom_wallenius_gena}	  A Wallenius' noncentral hypergeometric discrete random variable.

    Wallenius' noncentral hypergeometric distribution models drawing objects of
    two types from a bin. `M` is the total number of objects, `n` is the
    number of Type I objects, and `odds` is the odds ratio: the odds of
    selecting a Type I object rather than a Type II object when there is only
    one object of each type.
    The random variate represents the number of Type I objects drawn if we
    draw a pre-determined `N` objects from a bin one by one.

    %(before_notes)s

    See Also
    --------
    nchypergeom_fisher, hypergeom, nhypergeom

    Notes
    -----
    Let mathematical symbols :math:`N`, :math:`n`, and :math:`M` correspond
    with parameters `N`, `n`, and `M` (respectively) as defined above.

    The probability mass function is defined as

    .. math::

        p(x; N, n, M) = \binom{n}{x} \binom{M - n}{N-x}
        \int_0^1 \left(1-t^{\omega/D}\right)^x\left(1-t^{1/D}\right)^{N-x} dt

    for
    :math:`x \in [x_l, x_u]`,
    :math:`M \in {\mathbb N}`,
    :math:`n \in [0, M]`,
    :math:`N \in [0, M]`,
    :math:`\omega > 0`,
    where
    :math:`x_l = \max(0, N - (M - n))`,
    :math:`x_u = \min(N, n)`,

    .. math::

        D = \omega(n - x) + ((M - n)-(N-x)),

    and the binomial coefficients are defined as

    .. math:: \binom{n}{k} \equiv \frac{n!}{k! (n - k)!}.

    `nchypergeom_wallenius` uses the BiasedUrn package by Agner Fog with
    permission for it to be distributed under SciPy's license.

    The symbols used to denote the shape parameters (`N`, `n`, and `M`) are not
    universally accepted; they are chosen for consistency with `hypergeom`.

    Note that Wallenius' noncentral hypergeometric distribution is distinct
    from Fisher's noncentral hypergeometric distribution, which models
    take a handful of objects from the bin at once, finding out afterwards
    that `N` objects were taken.
    When the odds ratio is unity, however, both distributions reduce to the
    ordinary hypergeometric distribution.

    %(after_notes)s

    References
    ----------
    .. [1] Agner Fog, "Biased Urn Theory".
           https://cran.r-project.org/web/packages/BiasedUrn/vignettes/UrnTheory.pdf

    .. [2] "Wallenius' noncentral hypergeometric distribution", Wikipedia,
           https://en.wikipedia.org/wiki/Wallenius'_noncentral_hypergeometric_distribution

    %(example)s

    Zrvs_walleniusN)rc   rd   re   rf   r'  r   r+  r%   r%   r%   r&   r1  »  s   Ir1  Únchypergeom_walleniusz&A Wallenius' noncentral hypergeometric)`Ú	functoolsr   rˆ   Zscipyr   Zscipy.specialr   r   r   r   rA   r   Zscipy._lib._utilr	   r
   Zscipy.interpolater   Únumpyr   r   r   r   r   r   r   r   r   r   r!   Z_distn_infrastructurer   r   r   r   r   r   Zscipy.stats._boostÚstatsrK   Z
_biasedurnr   r   r   r'   r(   rg   ri   rq   rr   r~   r   r‹   rŒ   r˜   rš   r¯   r°   rÀ   rÁ   rÆ   rÇ   rÉ   rÐ   rØ   rÙ   rÝ   rÞ   rç   rè   ré   rï   r÷   rû   rü   r  r  r0   r	  r
  r  r  r  r¼   r#  r/  r0  r1  r2  ÚlistÚglobalsÚcopyÚitemsÚpairsZ_distn_namesZ_distn_gen_namesÚ__all__r%   r%   r%   r&   Ú<module>   sŠ   0 R
AR
r
E 
 
8BG?ÿO@WKÿ=N&INþNþ