mkl_?omatcopy_batch

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

mkl_?omatcopy_batch_strided

Computes a group of out of place scaled matrix copy or transposition using general matrices.

Syntax

void mkl_somatcopy_batch_strided(const char layout, const char trans, size_t row, size_t col,
                                 const float alpha, const float *a, size_t lda,
                                 size_t stridea, float *b, size_t ldb, size_t strideb,
                                 size_t batch_size);

void mkl_domatcopy_batch_strided(const char layout, const char trans, size_t row, size_t col,
                                 const double alpha, const double *a, size_t lda,
                                 size_t stridea, double *b, size_t ldb, size_t strideb,
                                 size_t batch_size);

void mkl_comatcopy_batch_strided(const char layout, const char trans, size_t row, size_t col,
                                 const MKL_complex8 alpha, const MKL_complex8 *a, size_t lda,
                                 size_t stridea, MKL_complex8 *b, size_t ldb, size_t strideb,
                                 size_t batch_size);

void mkl_zomatcopy_batch_strided(const char layout, const char trans, size_t row, size_t col,
                                 const MKL_complex16 alpha, const MKL_complex16 *a, size_t lda,
                                 size_t stridea, MKL_complex16 *b, size_t ldb, size_t strideb,
                                 size_t batch_size);

Include Files

mkl.h

Description

The mkl_?omatcopy_batch_strided routine performs a series of out-of-place scaled matrix copy or transposition. They are similar to the mkl_?omatcopy routine counterparts, but the mkl_?omatcopy_batch_strided routine performs matrix operations with group of matrices.

All matrices a and b have the same parameters (size, transposition operation…) and are stored at constant stride from each other respectively given by stridea and strideb . The operation is defined as

for i = 0 … batch_size – 1
    A and B are matrices at offset i * stridea in a and I * strideb in b
    B = alpha * op(A)
end for

Input Parameters

layout

Specifies whether two-dimensional array storage is row-major (CblasRowMajor) or column-major (CblasColMajor) .

trans

Specifies op(A) , the transposition operation applied to the AB matrices.

If trans = ‘N’ or ‘n’ , op(A)=A . If trans = ‘T’ or ‘t’ , op(A)=A' If trans = ‘C’ or ‘c’ , op(A)=conig(A') If trans = ‘R’ or ‘r’ , op(A)=conig(A)

row

Specifies the number of rows of the matrices A and B . The value of row must be at least zero.

col

Specifies the number of columns of the matrices A and B . The value of col must be at least zero.

alpha: REAL for mkl_somatcopy_batch_strided . DOUBLE PRECISION for mkl_domatcopy_batch_strided . COMPLEX for mkl_comatcopy_batch_strided . DOUBLE COMPLEX for mkl_zomatcopy_batch_strided . Specifies the scalar alpha .
a: REAL for mkl_somatcopy_batch_strided . DOUBLE PRECISION for mkl_domatcopy_batch_strided . COMPLEX for mkl_comatcopy_batch_strided . DOUBLE COMPLEX for mkl_zomatcopy_batch_strided . Array holding all the input matrices A . Must be of size at least lda * k + stridea * (batch_size - 1) * stridea where k is col if column major is used and row otherwise.

lda

The leading dimension of the matrix input A . It must be positive and at least row if column major layout is used or at least col if row major layout is used.

stridea

Stride between two consecutive A matrices, must be at least 0.

b: REAL for mkl_somatcopy_batch_strided . DOUBLE PRECISION for mkl_domatcopy_batch_strided . COMPLEX for mkl_comatcopy_batch_strided . DOUBLE COMPLEX for mkl_zomatcopy_batch_strided . Array holding all the output matrices B . Must be of size at least batch_size * strideb . The b array must be independent from the a array.

ldb

The leading dimension of the output matrix B . It must be positive and at least: row if column major layout is used and op(A) = A or conjg(A)row if row major layout is used and op(A) = A' or conjg(A')col otherwise

strideb

Stride between two consecutive B matrices. It must be positive and at least: ldb * col if column major layout is used and op(A) = A or conjg(A)ldb * col if row major layout is used and op(A) = A' or conjg(A')ldb * row otherwise

batch_size

Output Parameters

b: Array holding the batch_size updated matrices B .

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in