
    ^j
                    X    d dl mZ d dlZd dlmZ dgZ ed      	 	 	 	 	 	 	 	 dd       Zy)    )annotationsN)
exposed_in	rearrangez
torch.funcc                    t        | t        j                        st        j                  |       } ddlm}  || j                  |fi |} ||       S )a  A native implementation of `einops.rearrange`, a reader-friendly smart element reordering for multidimensional
    tensors. This operation includes functionality of transpose (axes permutation), reshape (view), squeeze, unsqueeze,
    stack, concatenate and other operations.

    See: https://einops.rocks/api/rearrange/

    Args:
        tensor (Tensor or sequence of Tensor): the tensor(s) to rearrange
        pattern (str): the rearrangement pattern
        axes_lengths (int): any additional length specifications for dimensions

    Returns:
        Tensor: the rearranged tensor

    Examples:
        >>> from torch.func import rearrange
        >>> # suppose we have a set of 32 images in "h w c" format (height-width-channel)
        >>> images = torch.randn((32, 30, 40, 3))

        >>> # stack along first (batch) axis, output is a single array
        >>> rearrange(images, "b h w c -> b h w c").shape
        torch.Size([32, 30, 40, 3])

        >>> # concatenate images along height (vertical axis), 960 = 32 * 30
        >>> rearrange(images, "b h w c -> (b h) w c").shape
        torch.Size([960, 40, 3])

        >>> # concatenated images along horizontal axis, 1280 = 32 * 40
        >>> rearrange(images, "b h w c -> h (b w) c").shape
        torch.Size([30, 1280, 3])

        >>> # reordered axes to "b c h w" format for deep learning
        >>> rearrange(images, "b h w c -> b c h w").shape
        torch.Size([32, 3, 30, 40])

        >>> # flattened each image into a vector, 3600 = 30 * 40 * 3
        >>> rearrange(images, "b h w c -> b (c h w)").shape
        torch.Size([32, 3600])

        >>> # split each image into 4 smaller (top-left, top-right, bottom-left, bottom-right), 128 = 32 * 2 * 2
        >>> rearrange(images, "b (h1 h) (w1 w) c -> (b h1 w1) h w c", h1=2, w1=2).shape
        torch.Size([128, 15, 20, 3])

        >>> # space-to-depth operation
        >>> rearrange(images, "b (h h1) (w w1) c -> b h w (c h1 w1)", h1=2, w1=2).shape
        torch.Size([32, 15, 20, 12])
    r   )_create_rearrange_callable)
isinstancetorchTensorstackfunctorch.einops.rearranger   ndim)tensorpatternaxes_lengthsr   rearrange_callables        b/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/torch/_functorch/einops.pyr   r   
   sP    j fell+V$ F3W , f%%    )r   z<torch.Tensor | list[torch.Tensor] | tuple[torch.Tensor, ...]r   strr   intreturnztorch.Tensor)
__future__r   r	   torch._functorch.utilsr   __all__r    r   r   <module>r      sT    "  - - L?&H?&?& ?& 	?& ?&r   