o ¨i eDã@sdZddlZddlZddlmZddlmZddlmZddlm Z ddlm Z dd lm Zgd ¢Zd d d ddddœZd#dd„ZejejejejejejdœZd$dd„ZiZdd„ZiZdd„Ze je jejejejdœZe je jejejejdœZdd„Zdd „Zd!d"„Z dS)%z¦ Handles dispatching array operations to the correct backend library, as well as converting arrays to backend formats and then potentially storing them as constants. éNé)Ú object_arrays)Úcupy)Újax)Ú tensorflow)Útheano)Útorch)Úget_funcÚ has_einsumÚ has_tensordotÚbuild_expressionÚevaluate_constantsÚ has_backendz dask.arrayz theano.tensorzopt_einsum.backends.torchz jax.numpyzautograd.numpyz mars.tensor)ÚdaskrrrÚautogradÚmarscCsXzt t ||¡¡}|durt||ƒWSt|||ƒWSty+d}t| ||¡ƒ‚w)z½Try and import ``{backend}.{func}``. If library is installed and func is found, return the func; otherwise if default is provided, return default; otherwise raise an error. Nz´{} doesn't seem to provide the function {} - see https://optimized-einsum.readthedocs.io/en/latest/backends.html for details on which functions are required for which contractions.)Ú importlibÚ import_moduleÚ_aliasesÚgetÚgetattrÚAttributeErrorÚformat)ÚfuncÚbackendÚdefaultÚlibÚ error_msg©rúK/var/www/myenv/lib/python3.10/site-packages/opt_einsum/backends/dispatch.pyÚ _import_funcs" ür ))Ú tensordotÚnumpy)Ú transposer")Úeinsumr")r!Úobject)r#r%)r$r%r"cCs>zt||fWStyt|||ƒ}|t||f<|YSw)ziReturn ``{backend}.{func}``, e.g. ``numpy.einsum``, or a default func if provided. Cache result. )Ú _cached_funcsÚKeyErrorr )rrrÚfnrrrr <s   ýr c CóXzt|WSty+z td|ƒdt|<Wn ty$dt|<Ynwt|YSw)zHCheck if ``{backend}.einsum`` exists, cache result for performance. r$TF)Ú _has_einsumr'r r©rrrrr Ló      ÿ ùr c Cr))zKCheck if ``{backend}.tensordot`` exists, cache result for performance. r!TF)Ú_has_tensordotr'r rr+rrrr ^r,r )rrrrrcCót|||ƒS)zxBuild an expression, based on ``expr`` and initial arrays ``arrays``, that evaluates using backend ``backend``. )ÚCONVERT_BACKENDS©rÚarraysÚexprrrrr €ór cCr.)zƒConvert constant arrays to the correct backend, and perform as much of the contraction of ``expr`` with these as possible. )ÚEVAL_CONSTS_BACKENDSr0rrrr ‡r3r cCs | ¡tvS)z$Checks if the backend is known. )Úlowerr/r+rrrrŽs r)N)r"N)!Ú__doc__rr"ÚrrÚ_cupyrÚ_jaxrÚ _tensorflowrÚ_theanorÚ_torchÚ__all__rr r!r#r$Ú object_einsumr&r r*r r-r r r/r r4rrrrrÚsZ      ú ù  û û