§
    +P„j¥'  ã                  óÌ  — d Z ddlmZ ddlZddlZddlZddlZddlZddlmZm	Z	m
Z
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ZeZ ed	¦  «        Zej         G d
„ d¦  «        ¦   «         Zej         G d„ d¦  «        ¦   «         Zej        	 d*ddœd+d„¦   «         Zej        	 d*ddœd,d„¦   «         Zd-ddœd.d„Zd/d„Zd0d „Z ej        d¦  «        d1d"„¦   «         Zd2d#„Z d3d)„Z!dS )4zCheck util.é    )ÚannotationsN)ÚAnyÚCallableÚOptionalÚTypeVar)Úepy)Únumpy_utils)Útype_parsing)ÚtypingÚ_Fnc                  ó:   — e Zd ZU dZded<   ded<   ded<   dd
„ZdS )Ú_ArrayParamzArgument matching an array.zarray_typing.ArrayAliasMetaÚtypeÚboolÚis_optionalÚstrÚnameÚxnpúnumpy_utils.NpModulec               ó¶   — 	 | j         j                             ||d¬¦  «        S # t          $ r*}t	          j        |d| j        › d�¬¦  «         Y d}~dS d}~ww xY w)z0Convert the value to array of the correct dtype.Únone)r   ÚcastingúInvalid ú: ©ÚprefixN)r   ÚdtypeÚasarrayÚ	Exceptionr   Úreraiser   )ÚselfÚvr   Úes       úW/root/disk_3tb/conda_envs/Huy-visual/lib/python3.11/site-packages/etils/enp/checking.pyr   z_ArrayParam.asarray2   sz   € ð6ØŒYŒ_×$Ò$ Q¨C¸Ð$Ñ@Ô@Ð@øÝð 6ð 6ð 6Ý	„k�!Ð4 t¤yÐ4Ð4Ð4Ð5Ñ5Ô5Ð5Ð5Ð5Ð5Ð5Ð5Ð5øøøøð6øøøs   ‚!$ ¤
A®AÁAN)r   r   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú__annotations__r   © ó    r$   r   r   *   sQ   € € € € € € à#Ð#à#Ð#Ð#Ñ#ØÐÐÑØ€)€)�)ð6ð 6ð 6ð 6ð 6ð 6r+   r   c                  ó2   — e Zd ZU dZded<   ded<   ded<   dS )	Ú_FnSignatureCachez Cache of the function signature.zinspect.SignatureÚsigr   Úhas_xnp_kwargszdict[str, _ArrayParam]Úarray_paramsN)r%   r&   r'   r(   r)   r*   r+   r$   r-   r-   :   s<   € € € € € € à(Ð(àÐÐÑØÐÐÑØ&Ð&Ð&Ñ&Ð&Ð&r+   r-   .©ÚstrictÚfnÚNoner2   r   ÚreturnúCallable[[_Fn], _Fn]c               ó   — d S ©Nr*   ©r3   r2   s     r$   Úcheck_and_normalize_arraysr:   C   ó	   € ð €#r+   c               ó   — d S r8   r*   r9   s     r$   r:   r:   L   r;   r+   Tc               ó’   ‡ ‡— ‰ €t          j        t          ‰¬¦  «        S d‰ _        t          j        ‰ ¦  «        ˆ ˆfd„¦   «         }|S )aS  Check and normalize arrays.

  This function:

  * Validate that the dtype/shape input arrays match the typing annotations
  * Normalize np, jnp, tf types to be consistent
  * Add an optional `xnp` argument to convert input arrays to np/jnp/tnp.

  See doc at: https://github.com/google/etils/blob/main/etils/array_types/README.md

  Example:

  ```python
  @enp.check_and_normalize_arrays(strict=False)
  def add(x: FloatArray[...], y: FloatArray[...]) -> y: FloatArray[...]:
    return x + y

  # Inside the function, `np` normalized to `jnp`
  add(np.array(1.), jnp.array(2.)) == jnp.array(3.)

  # strict=False, so `list` accepted and normalized to `xnp`
  add(jnp.array(1.), [1., 2., 3.]) == jnp.array([2., 3., 4.])
  ```

  Example with an explicit `xnp` argument, which automatically passed to the
  wrapped function:

  ```python
  @enp.check_and_normalize_arrays(strict=False)
  def clip(x: Array, *, xnp: enp.NpModule = ...) -> y: Array:
    return xnp.clip(x, 0.0, 1.0)
  ```

  If present in the function signature, the `xnp` argument must be a
  keyword-only argument.

  Args:
    fn: The function to decorate. Arguments will be automatically infered.
    strict: If `False`, `fn` will also accept list, int,... in which case those
      are automatically converted to `xnp`

  Returns:
    fn: The decorated function, with dynamic shape checking
  Nr1   c                 óŒ  •‡‡— 	 t          |¦  «        }|                     dd ¦  «        Š‰j        €t          ‰¦  «        ‰_        ‰j        Š‰j        rd|d<    ‰j        j        | i |¤Ž}ˆfd„|j                             ¦   «         D ¦   «         }‰pt          |‰¬¦  «        Št          ‰¦  «         ˆˆfd„|                     ¦   «         D ¦   «         }|j                             |¦  «         ‰j        r
‰|j        d<   n6# t          $ r)}t          j        |d‰j        › d�¬¦  «         Y d }~nd }~ww xY w ‰|j        i |j        ¤ŽS )	Nr   .c                ó2   •— i | ]\  }}|‰j         v ¯|®||“ŒS r8   )r0   )Ú.0Úkr"   Ústates      €r$   ú
<dictcomp>zDcheck_and_normalize_arrays.<locals>.decorated_fn.<locals>.<dictcomp>›   s9   ø€ ð ð ð áˆa�Ø�%Ô$Ð$Ð$¨¨ð ˆQà)6¨¨r+   r1   c                ó\   •— i | ](\  }}|‰j         |                              |‰¬ ¦  «        “Œ)S ))r   )r0   r   )r@   rA   r"   rB   r   s      €€r$   rC   zDcheck_and_normalize_arrays.<locals>.decorated_fn.<locals>.<dictcomp>¨   sJ   ø€ ð ð ð áˆa�ð ˆUÔ Ô"×*Ò*¨1°#Ð*Ñ6Ô6ðð ð r+   z*@enp.check_and_normalize_arrays error for r   r   )ÚdictÚpopÚ_array_types_stateÚ_parse_signaturer/   r.   ÚbindÚ	argumentsÚitemsÚ_get_xnpÚ_maybe_set_tnp_castingÚupdater   r   r    r'   ÚargsÚkwargs)	rO   rP   Ú
bound_argsÚ
array_argsr#   rB   r   r3   r2   s	        @@€€r$   Údecorated_fnz0check_and_normalize_arrays.<locals>.decorated_fnˆ   sÄ  øøø€ ð1Ý�F‰|Œ|€fØ�JŠJ�u˜dÑ#Ô#€cð 
Ô	Ð	&Ý 0°Ñ 4Ô 4ˆÔà!#Ô!6€eð 
Ô	ð Øˆˆu‰Ø!�5”9”> 4Ð2¨6Ð2Ð2€jðð ð ð à Ô*×0Ò0Ñ2Ô2ðñ ô €jð Ð6•8˜J¨vÐ6Ñ6Ô6€cÝ˜SÑ!Ô!Ð!ð
ð ð ð ð à ×&Ò&Ñ(Ô(ðñ ô €jð Ô×!Ò! *Ñ-Ô-Ð-ð 
Ô	ð *Ø&)ˆ
Ô˜UÑ#øøÝð ð ð Ý	„kØ
àN¸2¼?ÐNÐNÐNðñ ô ð ð ð ð ð ð øøøøðøøøð ˆ2ˆzŒÐ4 *Ô"3Ð4Ð4Ð4s   …C8C> Ã>
D1ÄD,Ä,D1)Ú	functoolsÚpartialr:   rG   Úwraps)r3   r2   rS   s   `` r$   r:   r:   U   sg   øø€ ð\ €ZÝÔÕ7ÀÐGÑGÔGÐGà€"Ôå„?�2ÑÔð45ð 45ð 45ð 45ð 45ñ Ôð45ðl 
Ðr+   rR   údict[str, Any]r   c               ó^  — t          j        t          ¦  «        }|                      ¦   «         D ]q\  }}	 |t          j                             ||¬¦  «                                      |¦  «         ŒA# t          $ r$}t          j
        |d|› d�¬¦  «         Y d}~Œjd}~ww xY wt          |¦  «        S )z*Extract the xnp module common to the args.r1   r   z: Expected xnp.ndarray: r   N)ÚcollectionsÚdefaultdictÚlistrK   r	   ÚlazyÚget_xnpÚappendr   r   r    Ú
_infer_xnp)rR   r2   ÚxnpsrA   r"   r#   s         r$   rL   rL   Â   sÐ   € õ 
Ô	 ¥Ñ	&Ô	&€$Ø×ÒÑ Ô ð Dð D�d€aˆðDØ
�;Ô×#Ò# A¨fÐ#Ñ5Ô5Ô6×=Ò=¸aÑ@Ô@Ð@Ð@øÝð Dð Dð DÝ	„k�!ÐB qÐBÐBÐBÐCÑCÔCÐCÐCÐCÐCÐCÐCøøøøðDøøøõ 
�DÑ	Ô	Ðs   ´:A/Á/
BÁ9BÂBr`   ú%dict[numpy_utils.NpModule, list[str]]c                óÖ   — t          | ¦  «        t          hz
  }t          |¦  «        dk    r0d„ |                      ¦   «         D ¦   «         } t	          d| › �¦  «        ‚|st          S |\  }|S )zExtract the `xnp` module.é   c                ó$   — i | ]\  }}|j         |“ŒS r*   )r%   )r@   rA   r"   s      r$   rC   z_infer_xnp.<locals>.<dictcomp>Û   s    € Ð3Ð3Ð3™d˜a ˆAŒJ˜Ð3Ð3Ð3r+   zConflicting numpy types: )ÚsetÚnpÚlenrK   Ú
ValueError)r`   Únon_np_xnpsr   s      r$   r_   r_   Ó   sv   € õ �D‘	”	�R˜DÑ €+õ 	ˆÑÔ˜ÒÐØ3Ð3 d§j¢j¡l¤lÐ3Ñ3Ô3€DÝ
Ð7°Ð7Ð7Ñ
8Ô
8Ð8à	ð Ý€Ià�F€SØ€Jr+   r   c                ó  — t           j        j        r| t           j        j        urdS t           j        j        sTddlm} |                     ¦   «         s|                     d¦  «         t          j
        d¦  «        }t          |¦  «         dS dS )aê  If TF numpy mode is not set, make sure `tnp.asarray(1.)` is `tf.float32`.

  If user uses TF without numpy mode, it will create casting issues (for
  example: `tf.float64 + tf.float32` will raise an error).
  To limit the errors encountered, we set `tnp.asarray(1.)` to `tf.float32`
  instead of `tf.float64`.

  If numpy mode is already activated, then no need to do anything, as
  `tf.float64 + tf.float32` will support auto-casting, like Jax and Numpy.

  Args:
    xnp: numpy module.
  Nr   )Ú	np_dtypesTzý
        WARNING: Using array types for TF but without numpy mode enabled. It
        is recommended to activate numpy mode as:

        import tensorflow.experimental.numpy as tnp
        tnp.experimental_enable_numpy_behavior(prefer_float32=True)
    )r	   r\   Úhas_tfÚtnpÚis_tnp_enabledÚtensorflow.python.ops.numpy_opsrk   Úis_prefer_float32Úset_prefer_float32r   ÚdedentÚprint)r   rk   Úmsgs      r$   rM   rM   å   s¢   € õ 
Ô	Ô	 ð  C­{Ô/?Ô/CÐ$CÐ$CØ
€Få	Ô	Ô	(ð ð :Ð9Ð9Ð9Ð9Ð9à×&Ò&Ñ(Ô(ð )Ø×"Ò" 4Ñ(Ô(Ð(å
Œ*ð	ñô €Cõ 
ˆ#�J„J€J€J€Jð)ð r+   c                ó¬  — 	 t          j        | ¦  «        }n=# t          $ r0}t          j        |d| j        › d| j        › �¬¦  «         Y d}~nd}~ww xY wt          j        | ¦  «        }i }|j	         
                    ¦   «         D ]\  }}t          ||¦  «        }|�|||<   Œ|st          d| j        › d|› d�¦  «        ‚t          |d|j	        v |¬	¦  «        S )
zParse the function signature.z%Could not infer typing annotation of z defined in r   Nz)Could not detect any array type hints in z with signature ú.r   )r.   r/   r0   )r   Úget_type_hintsr   r   r    r'   r&   ÚinspectÚ	signatureÚ
parametersrK   Ú_get_array_paramrh   r-   )r3   Úhintsr#   r.   r0   r   ÚparamÚarray_params           r$   rH   rH     sQ  € ð	ÝÔ! "Ñ%Ô%€E€EøÝ	ð ð ð Ý„KØ	ð*°B´Oð *ð *Øœ-ð*ð *ðñ ô ð ð ð ð ð ð øøøøðøøøõ 	Ô˜"ÑÔ€#ð €,Ø”^×)Ò)Ñ+Ô+ð 'ð '�k€dˆEÝ" 5¨%Ñ0Ô0€KØÐØ&€l�4Ñøà	ð Ý
ð	°B´Oð 	ð 	Øð	ð 	ð 	ñô ð õ
 
Ø
Ø˜cœnÐ,Øð
ñ 
ô 
ð s   ‚ —
A¡&AÁAr}   úinspect.Parameterr|   údict[str, _TypeForm]úOptional[_ArrayParam]c                óÎ  ‡	‡
— | j         Š
‰
|vrdS |‰
         Š	dˆ	ˆ
fd„}t          j        ‰	¦  «        }d|v }d„ |D ¦   «         }d„ |D ¦   «         }|                     d	¦  «        }|                     d
¦  «        }|r|r |d¦  «        ‚|dk    r |d¦  «        ‚|rdS |\  }| j        t
          j        j        t
          j        j        hv r |d¦  «        ‚t          ||‰
¬¦  «        S )z#Parse the type & hint of the array.Nrt   r   r5   r   c           	     ó6   •— t          d| › d‰› d‰› d�¦  «        S )Nz2`enp.check_and_normalize_arrays` does not support z6. Please open an issue if you need this feature. For `r   ú`)ÚNotImplementedError)rt   Úhintr   s    €€r$   Úmake_errz"_get_array_param.<locals>.make_err>  sM   ø€ Ýð	C¸Sð 	Cð 	CØ37ð	Cð 	CØ;?ð	Cð 	Cð 	Cñô ð r+   c                ó   — g | ]}|®|‘ŒS r8   r*   )r@   Úts     r$   ú
<listcomp>z$_get_array_param.<locals>.<listcomp>G  s   € Ð7Ð7Ð7�a¨¨�¨¨¨r+   c                óB   — g | ]}t          |t          j        ¦  «        ‘ŒS r*   )Ú
isinstanceÚarray_typingÚArrayAliasMeta)r@   Úls     r$   rŠ   z$_get_array_param.<locals>.<listcomp>J  s%   € ÐNÐNÐN¸a�z˜!�\Ô8Ñ9Ô9ÐNÐNÐNr+   TFzUnion of array and non-arrayrc   zUnion of arraysz*args, **kwargs)r   r   r   )rt   r   r5   r   )
r   r
   Úget_leaf_typesÚcountÚkindrx   Ú	ParameterÚVAR_POSITIONALÚVAR_KEYWORDr   )r}   r|   r‡   Ú
leaf_typesr   Ú	are_arrayÚcount_arrayÚcount_non_arrayÚ
array_typer†   r   s            @@r$   r{   r{   3  sW  øø€ ð
 
Œ€$Ø	�ÐÐØˆ4à	ˆtŒ€$ðð ð ð ð ð ð õ Ô*¨4Ñ0Ô0€*Ø˜
Ð"€+à7Ð7˜:Ð7Ñ7Ô7€*ð OÐNÀ:ÐNÑNÔN€)Ø—’ Ñ%Ô%€+Ø—O’O EÑ*Ô*€/àð 3�_ð 3Ø
ˆ(Ð1Ñ
2Ô
2Ð2Ø�1‚_€_Ø
ˆ(Ð$Ñ
%Ô
%Ð%Øð Øˆ4à�-€:à
„ZÝÔÔ&ÝÔÔ#ðð ð ð ˆ(Ð$Ñ
%Ô
%Ð%å	ØØØð
ñ 
ô 
ð r+   ).)r3   r4   r2   r   r5   r6   )r3   r   r2   r   r5   r   r8   )r2   r   )rR   rW   r2   r   r5   r   )r`   ra   r5   r   )r   r   r5   r4   )r5   r-   )r}   r   r|   r€   r5   r�   )"r(   Ú
__future__r   rY   ÚdataclassesrT   rx   r   r   r   r   r   Úetilsr   Ú	etils.enpr	   r
   Úetils.enp.array_typesr�   Únumpyrf   Ú	_TypeFormr   Ú	dataclassr   r-   Úoverloadr:   rL   r_   Ú	lru_cacherM   rH   r{   r*   r+   r$   ú<module>r¥      sx  ðð Ð à "Ð "Ð "Ð "Ð "Ð "à Ð Ð Ð Ø Ð Ð Ð Ø Ð Ð Ð Ø €€€Ø €€€Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3à Ð Ð Ð Ð Ð Ø !Ð !Ð !Ð !Ð !Ð !Ø "Ð "Ð "Ð "Ð "Ð "Ø 8Ð 8Ð 8Ð 8Ð 8Ð 8Ø Ð Ð Ð à€	Ø€gˆe�n„n€ð Ôð6ð 6ð 6ð 6ð 6ñ 6ô 6ñ Ôð6ð Ôð'ð 'ð 'ð 'ð 'ñ 'ô 'ñ Ôð'ð „àðð ðð ð ð ð ñ „ðð „àðð ðð ð ð ð ñ „ððj¸$ð jð jð jð jð jð jðZð ð ð ð"ð ð ð ð$ €Ô�TÑÔð%ð %ð %ñ Ôð%ðP"ð "ð "ð "ðJ.ð .ð .ð .ð .ð .r+   