§
    ·¯¸jL%  ã                   ób  — d Z ddlZddlZddlmZmZmZmZ ddlZdddddœd	eej	                 d
e
de
de
dedeeej	                 ee
         eeef         f         fd„Zddœdej	        dede
dej	        fd„Zddœdej	        deeef         dee
         dede
dej	        fd„Z G d„ d¦  «        ZdS )uš  Variableâ€‘size Mixup / CutMix utilities for NaFlex data loaders.

This module provides:

* `mix_batch_variable_size` â€“ pixelâ€‘level Mixup/CutMix that operates on a
  list of images whose spatial sizes differ, mixing only their central overlap
  so no resizing is required.
* `pairwise_mixup_target` â€“ builds softâ€‘label targets that exactly match the
  perâ€‘sample pixel provenance produced by the mixer.
* `NaFlexMixup` â€“ a callable functor that wraps the two helpers and stores
  all augmentation hyperâ€‘parameters in one place, making it easy to plug into
  different dataset wrappers.

Hacked together by / Copyright 2025, Ross Wightman, Hugging Face
é    N)ÚDictÚListÚTupleÚUnionçš™™™™™é?ç      ð?ç      à?é   ©Úmixup_alphaÚcutmix_alphaÚswitch_probÚlocal_shuffleÚimgsr   r   r   r   Úreturnc                óø  ‡ — t          ‰ ¦  «        dk     rt          d¦  «        ‚|dk    r7|dk    r1t          j        d¦  «                             ¦   «         |k     }|r|n|}n%|dk    rd}|}n|dk    rd}|}nt          d¦  «        ‚t          j                             ||¦  «                             ¦   «                              ¦   «         }t          dt          d|¦  «        ¦  «        }t          t          t          ‰ ¦  «        ¦  «        ˆ fd	„¬
¦  «        }|dk    rLt          dt          |¦  «        |¦  «        D ]-}	||	|	|z   …         }
t          j        |
¦  «         |
||	|	|z   …<   Œ.i }t          |ddd…         |ddd…         ¦  «        D ]\  }}|||<   |||<   Œt          ‰ ¦  «        dz  r|d         nd}dgt          ‰ ¦  «        z  }dgt          ‰ ¦  «        z  }t          t          ‰ ¦  «        ¦  «        D �]û}||k    r‰ |         ||<   Œ||         }‰ |         ‰ |         }}|j        \  }}}|j        \  }}}||z  }t          ||¦  «        t          ||¦  «        }}||z  }||z
  dz  ||z
  dz  }}||z
  dz  ||z
  dz  }!} |                     ¦   «         }|rÎt#          j        d|z
  ¦  «        }"t'          ||"z  ¦  «        t'          ||"z  ¦  «        }$}#|#|$z  }%t          j        d||#z
  ¦  «        }&t          j        d||$z
  ¦  «        }'||&z   ||'z   })}(| |&z   |!|'z   }+}*|dd…|*|*|#z   …|+|+|$z   …f         |dd…|(|(|#z   …|)|)|$z   …f<   |||<   d|%t+          |¦  «        z  z
  },|,||<   �Œq|dd…|||z   …|||z   …f         }-|dd…| | |z   …|!|!|z   …f         }.|-                     |¦  «                             |.d|z
  ¬¦  «        }/|/|dd…|||z   …|||z   …f<   |||<   ||z
  |z  ||z  |z  z   },|,||<   �Œý|||fS )aO  Apply Mixup or CutMix on a batch of variable-sized images.

    Sorts images by aspect ratio and pairs neighboring samples. Only the mutual
    central overlap region of each pair is mixed.

    Args:
        imgs: List of transformed images shaped (C, H, W).
        mixup_alpha: Beta distribution alpha for Mixup. Set to 0 to disable.
        cutmix_alpha: Beta distribution alpha for CutMix. Set to 0 to disable.
        switch_prob: Probability of using CutMix when both modes are enabled.
        local_shuffle: Size of local windows for shuffling after aspect sorting.

    Returns:
        Tuple of (mixed_imgs, lam_list, pair_to) where:
            - mixed_imgs: List of mixed images
            - lam_list: Per-sample lambda values representing mixing degree
            - pair_to: Mapping i -> j of which sample was mixed with which
    é   z1Need at least two images to perform Mixup/CutMix.ç        © FTu=   Both mixup_alpha and cutmix_alpha are zero â€“ nothing to do.r   c                 óR   •— ‰|          j         d         ‰|          j         d         z  S )Nr   é   )Úshape)Úir   s    €úf/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/timm/data/naflex_mixup.pyú<lambda>z)mix_batch_variable_size.<locals>.<lambda>E   s#   ø€ °4¸´7´=ÀÔ3CÀdÈ1ÄgÄmÐTUÔFVÑ3V€ ó    )Úkeyr   r   Néÿÿÿÿ©Úalpha)ÚlenÚ
ValueErrorÚtorchÚrandÚitemÚdistributionsÚBetaÚsampleÚmaxÚminÚsortedÚrangeÚrandomÚshuffleÚzipr   ÚcloneÚmathÚsqrtÚintÚrandintÚfloatÚmulÚadd_)0r   r   r   r   r   Ú
use_cutmixr    Úlam_rawÚorderÚstartÚwindowÚpair_toÚaÚbÚodd_oneÚ
mixed_imgsÚlam_listr   ÚjÚxiÚxjÚ_ÚhiÚwiÚhjÚwjÚ	dest_areaÚohÚowÚoverlap_areaÚtop_iÚleft_iÚtop_jÚleft_jÚ	cut_ratioÚchÚcwÚcut_areaÚy_offÚx_offÚyl_iÚxl_iÚyl_jÚxl_jÚcorrected_lamÚpatch_iÚpatch_jÚblendeds0   `                                               r   Úmix_batch_variable_sizera      sÄ  ø€ õ4 ˆ4�y„y�1‚}€}ÝÐLÑMÔMÐMð �SÒÐ˜\¨CÒ/Ð/Ý”Z ‘^”^×(Ò(Ñ*Ô*¨[Ò8ˆ
Ø *Ð;��°ˆˆØ	�sÒ	Ð	Øˆ
ØˆˆØ	˜Ò	Ð	Øˆ
ØˆˆåÐXÑYÔYÐYåÔ!×&Ò& u¨eÑ4Ô4×;Ò;Ñ=Ô=×BÒBÑDÔD€GÝ�#•s˜3 Ñ(Ô(Ñ)Ô)€Gõ •5�˜T™œÑ#Ô#Ð)VÐ)VÐ)VÐ)VÐWÑWÔW€EØ�qÒÐÝ˜1�c %™jœj¨-Ñ8Ô8ð 	8ð 	8ˆEØ˜5 ¨Ñ!6Ð6Ô7ˆFÝŒN˜6Ñ"Ô"Ð"Ø17ˆE�%˜ Ñ-Ð-Ñ.Ð.à €GÝ�E˜#˜#˜A˜#”J  a d¨ d¤Ñ,Ô,ð ð ‰ˆˆ1Øˆ�‰
Øˆ�‰
ˆ
å˜t™9œ9 q™=Ð2ˆe�BŒiˆi¨d€Gà&* V­c°$©i¬iÑ%7€JØ ˜E¥C¨¡I¤IÑ-€Hå•3�t‘9”9ÑÔð +(ñ +(ˆØ�Š<ˆ<Ø  œGˆJ�q‰MØà�AŒJˆØ�a”˜$˜qœ'ˆBˆØ”H‰	ˆˆ2ˆrØ”H‰	ˆˆ2ˆrØ˜‘Gˆ	õ �R˜‘”�c " b™kœkˆBˆØ˜B‘wˆØ˜b™ Q™¨¨b©°Q©ˆvˆØ˜b™ Q™¨¨b©°Q©ˆvˆà�XŠX‰ZŒZˆØð 	(åœ	 #¨¡-Ñ0Ô0ˆIÝ˜˜i™Ñ(Ô(­#¨b°9©nÑ*=Ô*=�ˆBØ˜B‘wˆHÝ”N 1 b¨2¡gÑ.Ô.ˆEÝ”N 1 b¨2¡gÑ.Ô.ˆEà ™¨°©�$ˆDØ ™¨°©�$ˆDØ68¸¸¸¸DÀ$ÈÁ)¸OÈTÐSWÐZ\ÑS\È_Ð9\Ô6]ˆBˆqˆqˆq�$˜˜r™	�/ 4¨°© ?Ð2Ñ3ØˆJ�q‰Mà (­U°9Ñ-=Ô-=Ñ"=Ñ=ˆMØ'ˆH�Q‰K‰Kð ˜˜˜˜E %¨"¡*Ð,¨f°V¸b±[Ð.@Ð@ÔAˆGØ˜˜˜˜E %¨"¡*Ð,¨f°V¸b±[Ð.@Ð@ÔAˆGà—k’k 'Ñ*Ô*×/Ò/°¸sÀW¹}Ð/ÑMÔMˆGØ:AˆBˆqˆqˆq�%˜ ™
Ð" F¨6°B©;Ð$6Ð6Ñ7ØˆJ�q‰Mà&¨Ñ5¸ÑBÀWÈ|ÑE[Ð^gÑEgÑgˆMØ'ˆH�Q‰K‰Kà�x Ð(Ð(r   r   )Ú	smoothingÚtargetsÚnum_classesrb   c                óì   — ||z  }d|z
  |z   }t          j        |                      d¦  «        |f|t           j        | j        ¬¦  «        }|                     d|                      d¦  «        |¦  «         |S )Nr   r   )ÚdtypeÚdevicer   )r#   ÚfullÚsizeÚfloat32rg   Úscatter_Ú	unsqueeze)rc   rd   rb   Úoff_valÚon_valÚy_onehots         r   Úsmoothed_sparse_targetrp   †   s~   € ð ˜+Ñ%€GØ�9‰_˜wÑ&€FåŒzØ	�Š�a‰Œ˜+Ð&ØÝŒmØŒ~ð	ñ ô €Hð ×Ò�a˜×*Ò*¨1Ñ-Ô-¨vÑ6Ô6Ð6Ø€Or   r=   rB   c                ó  — t          | ||¬¦  «        }|                     ¦   «         } |                     ¦   «         D ]F\  }}||         }| |                              |¦  «                             ||         d|z
  ¬¦  «         ŒG| S )u  Create soft targets that match the pixelâ€‘level mixing performed.

    Args:
        targets: (B,) tensor of integer class indices.
        pair_to: Mapping of sample index to its mixed partner as returned by mix_batch_variable_size().
        lam_list: Perâ€‘sample fractions of own pixels, also from the mixer.
        num_classes: Total number of classes in the dataset.
        smoothing: Labelâ€‘smoothing value in the range [0, 1).

    Returns:
        Tensor of shape (B, num_classes) whose rows sum to 1.
    ©rd   rb   r   r   )rp   r0   ÚitemsÚmul_r7   )	rc   r=   rB   rd   rb   ro   r   rC   Úlams	            r   Úpairwise_mixup_targetrv   ™   s‡   € õ( & g¸;ÐR[Ð\Ñ\Ô\€HØ�nŠnÑÔ€GØ—’‘”ð @ð @‰ˆˆ1Ø�qŒkˆØ�Œ
�Š˜ÑÔ×!Ò! (¨1¤+°S¸3±YÐ!Ñ?Ô?Ð?Ð?à€Nr   c                   óÐ   — e Zd ZdZddddddddœd	ed
edededededededdfd„Zdeddfd„Zdee	j
                 de	j
        deee	j
                 ee	j
                 f         fd„ZdS )ÚNaFlexMixupz<Callable wrapper that combines mixing and target generation.r   r   r	   r
   r   r   )r   r   r   Úprobr   Úlabel_smoothingÚmixup_off_epochrd   r   r   r   ry   r   rz   r{   r   Nc                ó®   — || _         || _        || _        || _        || _        || _        || _        || _        d| _        |  	                    d¦  «         dS )uš  Configure the augmentation.

        Args:
            num_classes: Total number of classes.
            mixup_alpha: Beta Î± for Mixup. 0 disables Mixup.
            cutmix_alpha: Beta Î± for CutMix. 0 disables CutMix.
            switch_prob: Probability of selecting CutMix when both modes are enabled.
            prob: Probability of applying any mixing per batch.
            local_shuffle: Window size used to shuffle images after aspect sorting so pairings vary between epochs.
            label_smoothing: Labelâ€‘smoothing value. 0 disables smoothing.
            mixup_off_epoch: Disable mixing at this epoch and later. Zero keeps mixing enabled.
        Tr   N)
rd   r   r   r   ry   r   rb   r{   Úmixup_enabledÚ	set_epoch)	Úselfrd   r   r   r   ry   r   rz   r{   s	            r   Ú__init__zNaFlexMixup.__init__¹   sb   € ð0 'ˆÔØ&ˆÔØ(ˆÔØ&ˆÔØˆŒ	Ø*ˆÔØ(ˆŒØ.ˆÔØ!ˆÔØ�Š�qÑÔÐÐÐr   Úepochc                 ó6   — | j          p
|| j         k     | _        dS )z+Update the mixup state for the given epoch.N)r{   r}   )r   r�   s     r   r~   zNaFlexMixup.set_epochÜ   s#   € à!%Ô!5Ð5ÐU¸ÀÔAUÒ9UˆÔÐÐr   r   rc   c                 óÌ  — t          |t          j        ¦  «        st          j        |¦  «        }| j        rt          j        ¦   «         | j        k    r3t          || j        | j	        ¬¦  «        }|| 
                    d¦  «        fS t          || j        | j        | j        | j        ¬¦  «        \  }}}t!          |||| j        | j	        ¬¦  «        }|| 
                    d¦  «        fS )u¡  Apply the augmentation and generate matching targets.

        Args:
            imgs: List of already transformed images shaped (C, H, W).
            targets: Hard labels with shape (B,).

        Returns:
            mixed_imgs: List of mixed images in the same order and shapes as the input.
            targets: Softâ€‘label tensor shaped (B, num_classes) suitable for crossâ€‘entropy with soft targets.
        rr   r   r   )Ú
isinstancer#   ÚTensorÚtensorr}   r-   ry   rp   rd   rb   Úunbindra   r   r   r   r   rv   )r   r   rc   rA   rB   r=   s         r   Ú__call__zNaFlexMixup.__call__à   sï   € õ ˜'¥5¤<Ñ0Ô0ð 	,Ý”l 7Ñ+Ô+ˆGàÔ!ð 	+¥V¤]¡_¤_°t´yÒ%@Ð%@Ý,¨WÀ$ÔBRÐ^bÔ^lÐmÑmÔmˆGØ˜Ÿš¨Ñ*Ô*Ð*Ð*å(?ØØÔ(ØÔ*ØÔ(ØÔ,ð)
ñ )
ô )
Ñ%ˆ
�H˜gõ (ØØØØÔ(Ø”nð
ñ 
ô 
ˆð ˜7Ÿ>š>¨!Ñ,Ô,Ð,Ð,r   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r3   r5   r€   r~   r   r#   r…   r   rˆ   r   r   r   rx   rx   ¶   s#  € € € € € ØFÐFð "%Ø"%Ø!$ØØ!"Ø%(Ø#$ð!ð !ð !ð ð!ð ð	!ð
  ð!ð ð!ð ð!ð ð!ð #ð!ð !ð!ð 
ð!ð !ð !ð !ðFV˜sð V tð Vð Vð Vð Vð%-à�u”|Ô$ð%-ð ”\ð%-ð 
ˆt�E”LÔ! 4¨¬Ô#5Ð5Ô	6ð	%-ð %-ð %-ð %-ð %-ð %-r   rx   )rŒ   r1   r-   Útypingr   r   r   r   r#   r…   r5   r3   ra   rp   rv   rx   r   r   r   ú<module>rŽ      sÝ  ððð ð €€€Ø €€€Ø +Ð +Ð +Ð +Ð +Ð +Ð +Ð +Ð +Ð +Ð +Ð +à €€€ð !Ø!Ø Øðl)ð l)ð l)Ø�5”<Ô ðl)ð ðl)ð ð	l)ð
 ðl)ð ðl)ð ˆ4�”Ô˜t Eœ{¨D°°c°¬NÐ:Ô;ðl)ð l)ð l)ð l)ðf ð	ð ð Ø”ðð ðð ð	ð
 „\ðð ð ð ð2 ðð ð Ø”ðà�c˜3�h”ðð �u”+ðð
 ðð ðð „\ðð ð ð ð:O-ð O-ð O-ð O-ð O-ñ O-ô O-ð O-ð O-ð O-r   