ak.to_cupy
----------

.. py:module: ak.to_cupy

Defined in `awkward.operations.ak_to_cupy <https://github.com/scikit-hep/awkward/blob/36da52cfa8846355c390beb6555eac1d31c27c26/src/awkward/operations/ak_to_cupy.py>`__ on `line 13 <https://github.com/scikit-hep/awkward/blob/36da52cfa8846355c390beb6555eac1d31c27c26/src/awkward/operations/ak_to_cupy.py#L13>`__.

.. py:function:: ak.to_cupy(array)


    :param array: Array-like data (anything :py:obj:`ak.to_layout` recognizes).

Converts ``array`` (many types supported) into a CuPy array, if possible.

If the data are numerical and regular (nested lists have equal lengths
in each dimension, as described by the :py:obj:`ak.Array.type`), they can be losslessly
converted to a CuPy array and this function returns without an error.

Otherwise, the function raises an error.

If ``array`` is a scalar, it is converted into a CuPy scalar.

See also :py:obj:`ak.from_cupy` and :py:obj:`ak.to_numpy`.