Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

?copy_batch_strided

Computes a group of vector copies.

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)

Description

The ?copy_batch_strided routines perform a series of vector copies. They are similar to their ?copy routine counterparts, but the ?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.