pitrou commented on code in PR #40708: URL: https://github.com/apache/arrow/pull/40708#discussion_r1539352942
########## docs/source/format/CDataInterface/PyCapsuleInterface.rst: ########## @@ -185,6 +230,34 @@ raise an exception. The requested schema mechanism is only meant to negotiate between different representations of the same data and not to allow arbitrary schema transformations. +Device Support +-------------- + +Th PyCapsule interface has cross hardware support through using the +:ref:`C device interface <c-device-data-interface>`. This means it is possible +to exchange data on non-CPU devices (e.g. CUDA GPUs) and to inspect on what +device the exchanged data lives. + +For exchanging the data structures, this interface has two sets of protocol +methods: the standard CPU-only versions (:meth:`__arrow_c_array__` and +:meth:`__arrow_c_stream__`) and the equivalent device-aware versions +(:meth:`__arrow_c_device_array__```, and :meth:`__arrow_c_device_stream__`). + +For CPU-only libraries, it is allowed to either implement only the standard Review Comment: ```suggestion For CPU-only producers, it is allowed to either implement only the standard ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
