a ij*@s0dZddlmZddlZddlZddlmZmZmZddlm Z ddl Z ej rZddl mZedZeZde jZeeeeefZe ZGd d d eZGd d d ZeZd ddddddZddddZdddddZ dddddZ!e j"ddZ#ej$dd dd!d"Z%ej$dddd#d"Z%d$d"Z%dS)%zUNumpy utils. Attributes: tau: The circle constant (2 * pi). (https://tauday.com/) ) annotationsN)AnyOptionalTypeVar)epy)Array_Tc@seZdZddddZdS)_LazyArrayMetaboolreturncCs t|SN)lazyis_array)clsobjrS/home/ghrups/robot-bench/.venv/lib/python3.9/site-packages/etils/enp/numpy_utils.py__instancecheck__6sz _LazyArrayMeta.__instancecheck__N)__name__ __module__ __qualname__rrrrrr 4sr c@seZdZdZeddddZeddddZedddd Zed d Zed d Z eddZ eddZ eddZ eddZ dddddZdddddZdddddZdddddZd dd!d"d#Zd dd!d$d%Zd dd!d&d'Zd dd!d(d)Zd*d+d ddd,d-d.Zddd/d0Zddd1d2Zddd3d4Zddd5d6Zddd7d8Zd9d:Zd;d<Zd=d>Zd?d@Ze dAddAdBdCZ!d*d+d ddDdEdFdGZ"d*d+d ddHdIdJZ#edddKdLZ$GdMdNdNe%dOZ&dPS)Q _LazyImporterzLazy import module. Help to write code seamlessly working with np, Jax and TF. Because libs are lazily imported, TF and Jax are always optional dependencies. r r cCs dtjvS)Njaxsysmodulesselfrrrhas_jaxBsz_LazyImporter.has_jaxcCs dtjvS)N tensorflowrrrrrhas_tfFsz_LazyImporter.has_tfcCs dtjvS)Ntorchrrrrr has_torchJsz_LazyImporter.has_torchcCs ddl}|SNr)r)rrrrrrNsz_LazyImporter.jaxcCsddlm}|Sr%)Z jax.numpynumpy)rjnprrrr'Ts z_LazyImporter.jnpcCs ddl}|Sr%)r!)rr!rrrtfZsz_LazyImporter.tfcCsddlmm}|Sr%)Ztensorflow.experimental.numpyZ experimentalr&)rtnprrrr)`sz_LazyImporter.tnpcCs ddl}|Sr%)r#)rr#rrrr#fsz_LazyImporter.torchcCstSr)nprrrrr*lsz_LazyImporter.npNpModule)xnpr cCs|tuSr)_nprr,rrr is_np_xnppsz_LazyImporter.is_np_xnpcCs|jo||juSr)r"r)r.rrr is_tf_xnpssz_LazyImporter.is_tf_xnpcCs|jo||juSr)r r'r.rrr is_jax_xnpvsz_LazyImporter.is_jax_xnpcCs|jo||juSr)r$r#r.rrr is_torch_xnpysz_LazyImporter.is_torch_xnprxr cCst|tjtjfSr) isinstancer*ndarraygenericrr4rrris_np|sz_LazyImporter.is_npcCs&|jo$t||jj|jj|jjjjfSr) r"r5r)r6r(Z TensorSpecZ __internal__typesTensorr8rrris_tfs z_LazyImporter.is_tfcCs|jot||jjSr)r r5r'r6r8rrris_jaxsz_LazyImporter.is_jaxcCs|jot||jjSr)r$r5r#r;r8rrris_torchsz_LazyImporter.is_torchTstrict)r4r@r cCs>|rdnt|t}||p<||p<||p<||p<|S)NF)r5_ARRAY_LIKE_TYPESr9r=r<r>)rr4r@Z is_array_likerrrrs z_LazyImporter.is_arraycCst|tjpt|tjSr)r5r*dtyper issubclassr7rrBrrr is_np_dtypesz_LazyImporter.is_np_dtypecCs|jot||jjjSr)r"r5r(dtypesZDTyperDrrr is_tf_dtypesz_LazyImporter.is_tf_dtypecCs&|jot|t|jj}||p$|Sr)r r5typer'Zfloat32rE)rrBZ check_jaxrrr is_jax_dtypesz_LazyImporter.is_jax_dtypecCs|jot||jjSr)r$r5r#rBrDrrris_torch_dtypesz_LazyImporter.is_torch_dtypecCs(||p&||p&||p&||Sr)rErIrGrJrDrrris_dtypes z_LazyImporter.is_dtypecCs`||r|j}nD||r4ddlm}||}n"||sV||sVtd|t |S)NrcompatzInvalid dtype: ) rGZas_numpy_dtyperJ etils.enprMZdtype_torch_to_nprIrE TypeErrorr*rBrrBrMrrr as_np_dtypes    z_LazyImporter.as_np_dtypecCs|jj||Sr)r(rFas_dtyperQrDrrr as_tf_dtypesz_LazyImporter.as_tf_dtypecCs ||Sr)rQrDrrr as_jax_dtypesz_LazyImporter.as_jax_dtypecCsddlm}|||S)NrrL)rNrMZdtype_np_to_torchrQrPrrras_torch_dtypes z_LazyImporter.as_torch_dtype)r,cCsb||r||S||r(||S||r<||S||rP||Std|dS)z'Normalize to dtype for the given `xnp`.z Unknown xnp: N) r/rQr0rSr1rTr2rUrO)rrBr,rrrrRs        z_LazyImporter.as_dtypezOptional[_np.dtype]) array_liker@r cCsh||r|j}nL|r,tdt|dn2t|tr>tj}n t|trLdStdt|| |S)z,Returns the dtype associated with the array.z$Cannot extract dtype from non-array z, when strict=True.N) rrBrOrHr5r r*Zbool_rArR)rrVr@rBrrrdtype_from_arrays   z_LazyImporter.dtype_from_array)r4r@cCsh||r|jS||r |jS||r.tS||r>|jS|sPt|t rPtSt dt |j dS)aReturns the numpy module associated with the given array. Args: x: Either tf, jax or numpy array. strict: If `False`, default to `np.array` if the array can't be infered ( to support array-like: list, tuple,...) Returns: The numpy module. z*Cannot infer the numpy module from array: N) r=r'r<r)r9r*r>r#r5rArOrHr)rr4r@rrrget_xnps    z_LazyImporter.get_xnpcCs|jot|jjdS)z(Returns `True` if numpy mode is enabled.Zreshape)r"hasattrr(r;rrrris_tnp_enabled sz_LazyImporter.is_tnp_enabledc@seZdZdZdS)z_LazyImporter.LazyArrayzRepresent `tf.Tensor`, `jax.ndarray`, `np.ndarray`, `torch.Tensor`. Allow to check isinstance without triggering imports from other modules: ``` assert isinstance(jnp.zeros((2,)), enp.lazy.LazyArray) ``` N)rrr__doc__rrrr LazyArraysr\) metaclassN)'rrrr[propertyr r"r$rr'r(r)r#r*r/r0r1r2r9r<r=r>rrErGrIrJrKrQrSrTrUr-rRrWrXrZr r\rrrrr:sX          rTr?rr arrayr@cCstj||dS)a Returns the numpy module associated with the given array. Args: array: Either tf, jax or numpy array. strict: If `False`, default to `np.array` if the array can't be infered ( to support array-like: list, tuple,...) Returns: The numpy module. r?)rrXr_rrr get_np_module s rar cCs:zt|}Wnty"YdS0|jtjtjtjhvS)z#Returns True if the dtype is `str`.F)r*rBrOrHZobject_Zstr_bytes_)rBrrr is_dtype_str.s  rcrr3cCs,t|ttfrdSt|r$t|jSdSdS)zReturns True if the given array is a `str` array. Note: Also returns True for scalar `str`, `bytes` values. For compatibility with `tensor.numpy()` which returns `bytes` Args: x: The array to test Returns: True or False TFN)r5bytesstrrrcrBr4rrr is_array_str8s  rgcCs0t|tjrdStjr(t|tjjr(dSdSdS)z-Returns `True` if array is np or `jnp` array.TFN)r5r*r6rr r'rfrrrrMs  rcCst|tr|dS|S)zDecodes bytes -> str array.utf8)r5rddecoderfrrr _to_str_arrayWsrjrdrecCsdSrrrfrrrnormalize_bytes2str^srkcCsdSrrrfrrrrkcscCs:t|tr|St|tr"|dSt|r2t|S|SdS)a)Normalize `bytes` array to `str` (UTF-8). Example of usage: ```python for ex in tfds.as_numpy(ds): # tf.data returns `tf.string` as `bytes` ex = tf.nest.map_structure(enp.normalize_bytes2str, ex) ``` Args: x: Any array Returns: x: `bytes` array are decoded as `str` rhN)r5rerdrirgrjrfrrrrkjs   )&r[ __future__rrtypingrrrZetilsrr&r* TYPE_CHECKINGZetils.enp.typingrrr+pitauintr floatlisttuplerAr-rHr rrrarcrgrZ vectorizerjoverloadrkrrrrs8    d