Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

mkl_?omatcopy

Performs scaling and out-place transposition/copying of matrices.

Syntax

void
mkl_somatcopy
(
char
ordering
,
char
trans
,
size_t
rows
,
size_t
cols
,
const
float
alpha
,
const
float
*
A
,
size_t
lda
,
float
*
B
,
size_t
ldb
);
void
mkl_domatcopy
(
char
ordering
,
char
trans
,
size_t
rows
,
size_t
cols
,
const
double
alpha
,
const
double
*
A
,
size_t
lda
,
double
*
B
,
size_t
ldb
);
void
mkl_comatcopy
(
char
ordering
,
char
trans
,
size_t
rows
,
size_t
cols
,
const
MKL_Complex8
alpha
,
const
MKL_Complex8
*
A
,
size_t
lda
,
MKL_Complex8
*
B
,
size_t
ldb
);
void
mkl_zomatcopy
(
char
ordering
,
char
trans
,
size_t
rows
,
size_t
cols
,
const
MKL_Complex16
alpha
,
const
MKL_Complex16
*
A
,
size_t
lda
,
MKL_Complex16
*
B
,
size_t
ldb
);
Include Files
  • mkl.h
Description
The
mkl_?omatcopy
 routine performs scaling and out-of-place transposition/copying of matrices. A transposition operation can be a normal matrix copy, a transposition, a conjugate transposition, or just a conjugation. The operation is defined as follows:
B
 :=
alpha
*op(
A
)
Different arrays must not overlap.
Input Parameters
ordering
Ordering of the matrix storage.
If
ordering
 =
'R'
 or
'r'
, the ordering is row-major.
If
ordering
 =
'C'
 or
'c'
, the ordering is column-major.
trans
Parameter that specifies the operation type.
If
trans
 =
'N'
 or
'n'
,
op(
A
)=
A
 and the matrix
A
 is assumed unchanged on input.
If
trans
 =
'T'
 or
't'
, it is assumed that
A
 should be transposed.
If
trans
 =
'C'
 or
'c'
, it is assumed that
A
 should be conjugate transposed.
If
trans
 =
'R'
 or
'r'
, it is assumed that
A
 should be only conjugated.
If the data is real, then
trans
 =
'R'
 is the same as
trans
 =
'N'
, and
trans
 =
'C'
 is the same as
trans
 =
'T'
.
rows
The number of rows in matrix
B
 (the source matrix).
cols
The number of columns in matrix
B
 (the source matrix).
alpha
This parameter scales the input matrix by
alpha
.
a
Array.
lda
If
ordering
 =
'R'
 or
'r'
,
lda
 represents the number of elements in array
a
 between adjacent rows of matrix
A
;
lda
 must be at least equal to the number of columns of matrix
A
.
If
ordering
 =
'C'
 or
'c'
,
lda
 represents the number of elements in array
a
 between adjacent columns of matrix
A
;
lda
 must be at least equal to the number of row in matrix
A
.
b
Array.
ldb
If
ordering
 =
'R'
 or
'r'
,
ldb
 represents the number of elements in array
b
 between adjacent rows of matrix
B
.
  • If
    trans
     =
    'T'
     or
    't'
     or
    'C'
     or
    'c'
    ,
    ldb
     must be at least equal to
    rows
    .
  • If
    trans
     =
    'N'
     or
    'n'
     or
    'R'
     or
    'r'
    ,
    ldb
     must be at least equal to
    cols
    .
If
ordering
 =
'C'
 or
'c'
,
ldb
 represents the number of elements in array
b
 between adjacent columns of matrix
B
.
  • If
    trans
     =
    'T'
     or
    't'
     or
    'C'
     or
    'c'
    ,
    ldb
     must be at least equal to
    cols
    .
  • If
    trans
     =
    'N'
     or
    'n'
     or
    'R'
     or
    'r'
    ,
    ldb
     must be at least equal to
    rows
    .
Output Parameters
b
Array, size at least
m
.
Contains the destination matrix.
Interfaces

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804