Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

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

mkl_?geunpack_compact

Unpacks matrices from Compact format to standard (row- or column-major, pointer-to-pointer) format.

Syntax

mkl_sgeunpack_compact
(
MKL_LAYOUT
layout
,
MKL_INT
rows
,
MKL_INT
columns
,
float
*
const
*a
,
MKL_INT
lda
,
const
float
*ap
,
MKL_INT
ldap
,
MKL_COMPACT_PACK
format
,
MKL_INT
nm
);
mkl_dgeunpack_compact
(
MKL_LAYOUT
layout
,
MKL_INT
rows
,
MKL_INT
columns
,
double
*
const
*a
,
MKL_INT
lda
,
const
double
*ap
,
MKL_INT
ldap
,
MKL_COMPACT_PACK
format
,
MKL_INT
nm
);
mkl_cgeunpack_compact
(
MKL_LAYOUT
layout
,
MKL_INT
rows
,
MKL_INT
columns
,
mkl_compact_complex_float
*
const
*a
,
MKL_INT
lda
,
const
float
*ap
,
MKL_INT
ldap
,
MKL_COMPACT_PACK
format
,
MKL_INT
nm
);
mkl_zgeunpack_compact
(
MKL_LAYOUT
layout
,
MKL_INT
rows
,
MKL_INT
columns
,
mkl_compact_complex_double
*
const
*a
,
MKL_INT
lda
,
const
double
*ap
,
MKL_INT
ldap
,
MKL_COMPACT_PACK
format
,
MKL_INT
nm
);
Description
The routine unpacks
nm
 Compact format matrices A
c
 from array
ap
 into standard (row- or column-major, pointer-to-pointer) format in array
A
.
Input Parameters
layout
Specifies whether two-dimensional array storage is row-major (
MKL_ROW_MAJOR
) or column-major (
MKL_COL_MAJOR
).
rows
The number of rows of A; rows >= 0.
columns
The number of columns of A; columns >= 0.
lda
Leading dimension of A.
layout
 =
MKL_COL_MAJOR
lda
 must be at least max (1,
rows
).
layout
 =
MKL_ROW_MAJOR
lda
 must be at least max (1,
columns
).
ap
Array storing the compact format of input matrices A
c
. See Compact Formator mkl_get_format_compact for details.
layout
 =
MKL_COL_MAJOR
ap
 has size
ldap
*
columns
*
nm
.
layout
 =
MKL_ROW_MAJOR
ap
 has size
ldap
*
rows
*
nm
.
ldap
Leading dimension of of A
c
.
layout
 =
MKL_COL_MAJOR
ldap
 must be at least max (1,
rows
).
layout
 =
MKL_ROW_MAJOR
ldap
 must be at least max (1,
columns
).
The values of
ldap
 used in
mkl_?geunpack_compact
 must be consistent with the values used in
mkl_?get_size_compact
 and
mkl_?gepack_compact
.
format
Specifies the format of the compact matrices. See Compact Format ormkl_get_format_compact for details.
nm
Total number of matrices that will be stored in Compact format.
Output Parameters
a
A standard format (row- or column-major, pointer-to-pointer) array, storing
nm
 output
A
 matrices.
layout
 =
MKL_COL_MAJOR
a
 has size
lda
*
columns
*
nm
.
layout
 =
MKL_ROW_MAJOR
a
 has size
lda
*
rows
*
nm
.

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