a
    yn„f€  ã                   @  s‚   d dl mZ d dlZd dlmZ d dlmZmZm	Z	 d dl
mZ d dlmZ dZe ¡ Zeƒ dddd	ddd
œdd„ƒZdd„ ZdS )é    )ÚannotationsN)Úhigh_level_function)ÚHighLevelContextÚensure_same_backendÚmaybe_highlevel_to_lowlevel)ÚNumpyMetadata)Úregularize_axis)ÚmomentFT)ÚkeepdimsÚmask_identityÚ	highlevelÚbehaviorÚattrsc          	   
   c  s"   | |fV  t | ||||||||ƒ	S )a“	  
    Args:
        x: The data on which to compute the moment (anything #ak.to_layout recognizes).
        n (int): The choice of moment: `0` is a sum of weights, `1` is
            #ak.mean, `2` is #ak.var without subtracting the mean, etc.
        weight: Data that can be broadcasted to `x` to give each value a
            weight. Weighting values equally is the same as no weights;
            weighting some values higher increases the significance of those
            values. Weights can be zero or negative.
        axis (None or int): If None, combine all values from the array into
            a single scalar result; if an int, group by that axis: `0` is the
            outermost, `1` is the first level of nested lists, etc., and
            negative `axis` counts from the innermost: `-1` is the innermost,
            `-2` is the next level up, etc.
        keepdims (bool): If False, this function decreases the number of
            dimensions by 1; if True, the output values are wrapped in a new
            length-1 dimension so that the result of this operation may be
            broadcasted with the original array.
        mask_identity (bool): If True, the application of this function on
            empty lists results in None (an option type); otherwise, the
            calculation is followed through with the reducers' identities,
            usually resulting in floating-point `nan`.
        highlevel (bool): If True, return an #ak.Array; otherwise, return
            a low-level #ak.contents.Content subclass.
        behavior (None or dict): Custom #ak.behavior for the output array, if
            high-level.
        attrs (None or dict): Custom attributes for the output array, if
            high-level.

    Computes the `n`th moment in each group of elements from `x` (many
    types supported, including all Awkward Arrays and Records). The grouping
    is performed the same way as for reducers, though this operation is not a
    reducer and has no identity.

    This function has no NumPy equivalent.

    Passing all arguments to the reducers, the moment is calculated as

        ak.sum((x*weight)**n) / ak.sum(weight)

    The `n=2` moment differs from #ak.var in that #ak.var also subtracts the
    mean (the `n=1` moment).

    See #ak.sum for a complete description of handling nested lists and
    missing values (None) in reducers, and #ak.mean for an example with another
    non-reducer.
    )Ú_impl)	ÚxÚnÚweightÚaxisr
   r   r   r   r   © r   ú_/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/awkward/operations/ak_moment.pyr	      s    =
ÿr	   c	              
   C  s`  t |ƒ}t||d��:}	t|	j| ddd�|	j|ddddd�ƒ\}
}W d   ƒ n1 sT0    Y  |	 |
¡} |	j|dd�}tjd	d	d
��Æ |d u rÔtjj	j
| |||d|	j|	jd�}tjjj
| | |||d|	j|	jd�}nPtjjj
| d | |||d|	j|	jd�}tjjj
| | | |||d|	j|	jd�}|	jt|| ƒ|dd�W  d   ƒ S 1 �sR0    Y  d S )N)r   r   FÚerror)Úallow_recordÚprimitive_policyzpass-through)r   Zallow_unknownr   Znone_policyT)Úallow_otherÚignore)ÚinvalidÚdivide)r   r   r   r   )r   r   )r   r   r   ÚunwrapÚwrapÚnpZerrstateÚakÚ
operationsZak_countr   r   r   Zak_sumr   )r   r   r   r   r
   r   r   r   r   ÚctxZx_layoutZweight_layoutZsumwZsumwxnr   r   r   r   Y   sr    ûþ&
ù	ù

ù	
ù	
ýr   )NN)Ú
__future__r   Zawkwardr    Zawkward._dispatchr   Zawkward._layoutr   r   r   Zawkward._nplikes.numpy_liker   Zawkward._regularizer   Ú__all__Úinstancer   r	   r   r   r   r   r   Ú<module>   s$     üöD