cupy.asarray — CuPy 14.2.0 documentation

cupy.asarray(a, dtype=None, order=None, *, copy=None, blocking=False)

[source]

#

Converts an object to array.

This is equivalent to array(a,dtype,copy=False,order=order).

Parameters:a – The source object.

dtype – Data type specifier. It is inferred from the input by default.

order ({'C', 'F', 'A', 'K'}) – Whether to use row-major (C-style) or column-major (Fortran-style) memory representation. Defaults to 'K'. order is ignored for objects that are not

cupy.ndarray

, but have the __cuda_array_interface__ attribute.

copy (

bool

, optional) – If True, obj is always copied. If False, prohibits copy and raises ValueError on failure. If None (default), obj is copied only when necessary.

blocking (

bool

) – Default is False, meaning if a H2D copy is needed it would run asynchronously on the current stream, and users are responsible for ensuring the stream order. For example, writing to the source a without proper ordering while copying would result in a race condition. If set to True, the copy is synchronous (with respect to the host).

Returns:An array on the current device. If a is already on the device, no copy is performed.

Return type:

cupy.ndarray

Note

If a is an numpy.ndarray instance that contains big-endian data, this function automatically swaps its byte order to little-endian, which is the NVIDIA and AMD GPU architecture’s native use.