3
O4W^¦  ã               @   sd   d dl Z d dlmZ d dlmZ d dlmZ d dlmZ d dlm	Z	 d dl
mZ G dd	„ d	eƒZdS )
é    N)Úinf)ÚDistribution)ÚCategorical)ÚNumber)Úconstraints)Úbroadcast_allc                   s¨   e Zd ZdZejejdœZedd„ ƒZ	edd„ ƒZ
d‡ fd	d
„	Zd‡ fdd„	Zdd„ Zejdd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZejƒ fdd„Zdd„ Z‡  ZS )ÚMultinomialas  
    Creates a Multinomial distribution parameterized by :attr:`total_count` and
    either :attr:`probs` or :attr:`logits` (but not both). The innermost dimension of
    :attr:`probs` indexes over categories. All other dimensions index over batches.

    Note that :attr:`total_count` need not be specified if only :meth:`log_prob` is
    called (see example below)

    .. note:: :attr:`probs` must be non-negative, finite and have a non-zero sum,
              and it will be normalized to sum to 1.

    -   :meth:`sample` requires a single shared `total_count` for all
        parameters and samples.
    -   :meth:`log_prob` allows different `total_count` for each parameter and
        sample.

    Example::

        >>> m = Multinomial(100, torch.tensor([ 1., 1., 1., 1.]))
        >>> x = m.sample()  # equal probability of 0, 1, 2, 3
        tensor([ 21.,  24.,  30.,  25.])

        >>> Multinomial(probs=torch.tensor([1., 1., 1., 1.])).log_prob(x)
        tensor([-4.1338])

    Args:
        total_count (int): number of trials
        probs (Tensor): event probabilities
        logits (Tensor): event log probabilities
    )ÚprobsÚlogitsc             C   s   | j | j S )N)r	   Útotal_count)Úself© r   ú@/tmp/pip-build-e66j97b2/torch/torch/distributions/multinomial.pyÚmean,   s    zMultinomial.meanc             C   s   | j | j d| j  S )Né   )r   r	   )r   r   r   r   Úvariance0   s    zMultinomial.variancer   Nc                sX   t |tƒstdƒ‚|| _t||d�| _| jj}| jjdd … }tt	| ƒj
|||d� d S )Nz*inhomogeneous total_count is not supported)r	   r
   r   )Úvalidate_argséÿÿÿÿ)Ú
isinstancer   ÚNotImplementedErrorr   r   Ú_categoricalÚbatch_shapeÚparam_shapeÚsuperr   Ú__init__)r   r   r	   r
   r   r   Úevent_shape)Ú	__class__r   r   r   4   s    
zMultinomial.__init__c                sP   | j t|ƒ}tj|ƒ}| j|_| jj|ƒ|_tt|ƒj|| j	dd� | j
|_
|S )NF)r   )Z_get_checked_instancer   ÚtorchÚSizer   r   Úexpandr   r   r   Ú_validate_args)r   r   Z	_instanceÚnew)r   r   r   r   =   s    
zMultinomial.expandc             O   s   | j j||ŽS )N)r   Ú_new)r   ÚargsÚkwargsr   r   r   r"   F   s    zMultinomial._newc             C   s   t jd| jƒS )Nr   )r   Zinteger_intervalr   )r   r   r   r   ÚsupportI   s    zMultinomial.supportc             C   s   | j jS )N)r   r
   )r   r   r   r   r
   M   s    zMultinomial.logitsc             C   s   | j jS )N)r   r	   )r   r   r   r   r	   Q   s    zMultinomial.probsc             C   s   | j jS )N)r   r   )r   r   r   r   r   U   s    zMultinomial.param_shapec             C   s‚   t j|ƒ}| jjt j| jfƒ| ƒ}tt|jƒ ƒƒ}|j|j	dƒƒ |j
|Ž }|j| j|ƒƒjƒ }|jd|t j|ƒƒ |j| jƒS )Nr   r   r   )r   r   r   Úsampler   ÚlistÚrangeZdimÚappendÚpopZpermuter!   Z_extended_shapeZzero_Zscatter_add_Z	ones_likeZtype_asr	   )r   Zsample_shapeZsamplesZshifted_idxÚcountsr   r   r   r&   Y   s    

zMultinomial.samplec             C   s|   | j r| j|ƒ t| jjƒ |ƒ\}}tj|jdƒd ƒ}tj|d ƒjdƒ}d||dk|t k@ < || jdƒ}|| | S )Nr   r   r   r   r   )	r    Z_validate_sampler   r
   Úcloner   ÚlgammaÚsumr   )r   Úvaluer
   Zlog_factorial_nZlog_factorial_xsZ
log_powersr   r   r   Úlog_probe   s    
zMultinomial.log_prob)r   NNN)N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   ZsimplexÚrealZarg_constraintsÚpropertyr   r   r   r   r"   Zdependent_propertyr%   r
   r	   r   r   r   r&   r0   Ú__classcell__r   r   )r   r   r   
   s   
		r   )r   Z
torch._sixr   Z torch.distributions.distributionr   Ztorch.distributionsr   Znumbersr   r   Ztorch.distributions.utilsr   r   r   r   r   r   Ú<module>   s   