Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
?copy_batch_strided
Computes a group of vector copies.
Syntax
call scopy_batch_strided(n, x, incx, stridex, y, incy, stridey, batch_size)
call dcopy_batch_strided(n, x, incx, stridex, y, incy, stridey, batch_size)
call ccopy_batch_strided(n, x, incx, stridex, y, incy, stridey, batch_size)
call zcopy_batch_strided(n, x, incx, stridex, y, incy, stridey, batch_size)
Include Files
mkl.fi
Description
The ?copy_batch_stridedcblas_?copy_batch_strided routines perform a series of vector copies. They are similar to their ?copycblas_?copy routine counterparts, but the ?copy_batch_stridedcblas_?copy_batch_strided routines perform vector operations with a group of vectors.
All vectors x (respectively, y ) have the same parameters (size, increment) and are stored at constant distance stridex (respectively, stridey ) from each other. The operation is defined as follows:
for i = 0 … batch_size – 1
X and Y are vectors at offset i * stridex and i * stridey in x and y
Y = X
end for
Input Parameters
- n
-
INTEGER. Number of elements in vectors x and y .
- x
-
REAL for scopy_batch_strided DOUBLE PRECISION for dcopy_batch_strided COMPLEX for ccopy_batch_strided DOUBLE COMPLEX for zcopy_batch_strided Array of size at least stridex*batch_size holding the input x vectors.
- incx
-
INTEGER. Specifies the increment between two consecutive elements of a single vector x .
- stridex
-
INTEGER. Stride between two consecutive x vectors. Must be at least (1 + (n-1)*abs(incx)) .
- y
-
REAL for scopy_batch_strided DOUBLE PRECISION for dcopy_batch_strided COMPLEX for ccopy_batch_strided DOUBLE COMPLEX for zcopy_batch_strided Array of size at least stridey*batch_size holding the output y vectors.
- incy
-
INTEGER. Specifies the increment between two consecutive elements of a single vector y .
- stridey
-
INTEGER. Stride between two consecutive y vectors. Must be at least (1 + (n-1)*abs(incy)) .
- batch_size
-
INTEGER. Number of copy computations to perform and x and y vectors. Must be at least 0.
Output Parameters
- y
-
Array holding the batch_size copied vectors y .