o "Â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)ZdaskrrrZautogradZmarscCsXzt 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ÚlibZ error_msg©rú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. rTF)Ú_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©rZarraysÚ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_BACKENDSr,rrrr ‡r.r cCs | ¡tvS)z$Checks if the backend is known. )Úlowerr+r'rrrrŽs r)N)rN)!Ú__doc__rrÚrrZ_cupyrZ_jaxrZ _tensorflowrZ_theanorZ_torchÚ__all__rrrrr Z object_einsumr"r r&r r)r r r+r r/rrrrrÚsZ      ú ù  û û