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 d dl	m
Z
 d dlmZ d dlmZ dZe
 ¡ Zeƒ dd
dddœdd„ƒZdd„ ZdS )é    )ÚannotationsN)Úhigh_level_function)ÚHighLevelContextÚmaybe_posaxis)ÚNumpyMetadata)Úregularize_axis)Ú	AxisError)Ú
to_regularé   T)Ú	highlevelÚbehaviorÚattrsc                c  s   | fV  t | ||||ƒS )aé  
    Args:
        array: Array-like data (anything #ak.to_layout recognizes).
        axis (int or None): The dimension at which this operation is applied.
            The outermost dimension is `0`, followed by `1`, etc., and negative
            values count backward from the innermost: `-1` is the innermost
            dimension, `-2` is the next level up, etc. If None, convert all
            variable dimensions into regular ones or raise a ValueError if that
            is not possible.
        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.

    Converts a variable-length axis into a regular one, if possible.

        >>> irregular = ak.from_iter(np.arange(2*3*5).reshape(2, 3, 5))
        >>> irregular.type.show()
        2 * var * var * int64
        >>> ak.to_regular(irregular).type.show()
        2 * 3 * var * int64
        >>> ak.to_regular(irregular, axis=2).type.show()
        2 * var * 5 * int64
        >>> ak.to_regular(irregular, axis=-1).type.show()
        2 * var * 5 * int64

    But truly irregular data cannot be converted.

        >>> ak.to_regular(ak.Array([[1, 2, 3], [], [4, 5]]))
        ValueError: while calling
            ak.to_regular(
                array = <Array [[1, 2, 3], [], [4, 5]] type='3 * var * int64'>
                axis = 1
                highlevel = True
                behavior = None
            )
        Error details: cannot convert to RegularArray because subarray lengths are not regular

    See also #ak.from_regular.
    )Ú_impl)ÚarrayÚaxisr   r   r   © r   úc/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/awkward/operations/ak_to_regular.pyr	      s    -r	   c           	        s¢   t ˆ ƒ‰ t||d�� }|j| ddd�}W d   ƒ n1 s:0    Y  ˆ d u rddd„ }tj ||¡}n0t|ˆ dƒdkrz|}n‡ fd	d„}tj ||¡}|j||d
�S )N)r   r   FÚerror)Zallow_recordZprimitive_policyc                 [  s   | j r|ƒ  ¡ S d S )N)Úis_listÚto_RegularArray)ÚlayoutZcontinuationÚkwargsr   r   r   ÚactionK   s    z_impl.<locals>.actionr
   r   c                   sB   t | ˆ |ƒ}||kr"| jr"|  ¡ S | jr>tdˆ › d|› d�ƒ‚d S )Nzaxis=z" exceeds the depth of this array (ú))r   r   r   Zis_leafr   )r   Údepthr   Zposaxis©r   r   r   r   V   s    ÿ)r   )r   r   ÚunwrapÚakZ_doZrecursively_applyr   Úwrap)	r   r   r   r   r   Úctxr   r   Úoutr   r   r   r   D   s    .
r   )r
   )Ú
__future__r   Zawkwardr   Zawkward._dispatchr   Zawkward._layoutr   r   Zawkward._nplikes.numpy_liker   Zawkward._regularizer   Zawkward.errorsr   Ú__all__ÚinstanceÚnpr	   r   r   r   r   r   Ú<module>   s   2