o ^i @sddlmZmZddlZddlZddlmZddlm Z ddgZ Gdddej Z ejedddd d ed ee d eed dfddZdS))AnyOptionalN) _to_dlpack)Device DLDeviceType from_dlpackc@sHeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdS)r))))))) ) ) ) ) ))))N)__name__ __module__ __qualname__kDLCPUkDLCUDA kDLCUDAHost kDLOpenCL kDLVulkankDLMetalkDLVPIkDLROCM kDLROCMHost kDLExtDevkDLCUDAManaged kDLOneAPI kDLWebGPU kDLHexagonkDLMAIAr)r)M/var/www/html/RAG/RAG_venv/lib/python3.10/site-packages/torch/utils/dlpack.pyrs ato_dlpack(tensor) -> PyCapsule Returns an opaque object (a "DLPack capsule") representing the tensor. .. note:: ``to_dlpack`` is a legacy DLPack interface. The capsule it returns cannot be used for anything in Python other than use it as input to ``from_dlpack``. The more idiomatic use of DLPack is to call ``from_dlpack`` directly on the tensor object - this works when that object has a ``__dlpack__`` method, which PyTorch and most other libraries indeed have now. .. warning:: Only call ``from_dlpack`` once per capsule produced with ``to_dlpack``. Behavior when a capsule is consumed multiple times is undefined. Args: tensor: a tensor to be exported The DLPack capsule shares the tensor's memory. )devicecopy ext_tensorr+r,returnz torch.Tensorc Cs:t|dri}d|d<|dur||d<|dur8t|tr!t|}t|tjs0Jdt|tj||d<|}|dt j t j fvrhtj d |d }|dt j k}|ra|jdkrad n|j}||d <z |jd i|}Wn$ty|d|jd i|}Ynw|dur|dusJd |}tj|S)afrom_dlpack(ext_tensor) -> Tensor Converts a tensor from an external library into a ``torch.Tensor``. The returned PyTorch tensor will share the memory with the input tensor (which may have come from another library). Note that in-place operations will therefore also affect the data of the input tensor. This may lead to unexpected issues (e.g., other libraries may have read-only flags or immutable data structures), so the user should only do this if they know for sure that this is fine. Args: ext_tensor (object with ``__dlpack__`` attribute, or a DLPack capsule): The tensor or DLPack capsule to convert. If ``ext_tensor`` is a tensor (or ndarray) object, it must support the ``__dlpack__`` protocol (i.e., have a ``ext_tensor.__dlpack__`` method). Otherwise ``ext_tensor`` may be a DLPack capsule, which is an opaque ``PyCapsule`` instance, typically produced by a ``to_dlpack`` function or method. device (torch.device or str or None): An optional PyTorch device specifying where to place the new tensor. If None (default), the new tensor will be on the same device as ``ext_tensor``. copy (bool or None): An optional boolean indicating whether or not to copy ``self``. If None, PyTorch will copy only if necessary. Examples:: >>> import torch.utils.dlpack >>> t = torch.arange(4) # Convert a tensor directly (supported in PyTorch >= 1.10) >>> t2 = torch.from_dlpack(t) >>> t2[:2] = -1 # show that memory is shared >>> t2 tensor([-1, -1, 2, 3]) >>> t tensor([-1, -1, 2, 3]) # The old-style DLPack usage, with an intermediate capsule object >>> capsule = torch.utils.dlpack.to_dlpack(t) >>> capsule >>> t3 = torch.from_dlpack(capsule) >>> t3 tensor([-1, -1, 2, 3]) >>> t3[0] = -9 # now we're sharing memory between 3 tensors >>> t3 tensor([-9, -1, 2, 3]) >>> t2 tensor([-9, -1, 2, 3]) >>> t tensor([-9, -1, 2, 3]) __dlpack__)rr max_versionNr,z&from_dlpack: unsupported device type: dl_devicerzcuda:rstreamzQdevice and copy kwargs not supported when ext_tensor is already a DLPack capsule.r))hasattr isinstancestrtorchr+type_C_torchDeviceToDLDevice__dlpack_device__rrr!cudacurrent_stream cuda_streamr/ TypeErrorpop _from_dlpack) r-r+r,kwargs ext_devicer2is_cuda stream_ptrdlpackr)r)r*r:s: ?      )typingrrr6enumtorch._Cr to_dlpack torch.typesr_Device__all__IntEnumrr8 _add_docstrboolrr)r)r)r*s*