Developer Reference for Intel® oneAPI Math Kernel Library for C
p?tran
Transposes a real distributed matrix.
Syntax
void pstran(const MKL_INT *m, const MKL_INT *n, const float *alpha, const float *a,
const MKL_INT *ia, const MKL_INT *ja, const MKL_INT *desca, const float *beta,
float *c, const MKL_INT *ic, const MKL_INT *jc, const MKL_INT *descc);
void pdtran(const MKL_INT *m, const MKL_INT *n, const double *alpha, const double *a,
const MKL_INT *ia, const MKL_INT *ja, const MKL_INT *desca,
const double *beta, double *c, const MKL_INT *ic, const MKL_INT *jc,
const MKL_INT *descc);
Include Files
mkl_pblas.h
Description
The p?tran routines transpose a real distributed matrix. The operation is defined as sub( C ):= beta *sub( C ) + alpha *sub( A )’,
where:
alpha and beta are scalars,
sub(C) is an m -by- n distributed matrix, sub(C)=C(ic:ic+m-1, jc:jc+n-1) .
sub(A) is a distributed matrix, sub(A)=A(ia:ia+n-1, ja:ja+m-1) .
Input Parameters
m
(global) Specifies the number of rows of the distributed matrix sub(C) , m ≥ 0.
n
(global) Specifies the number of columns of the distributed matrix sub(C) , n ≥ 0.
alpha
(global)
DOUBLE PRECISION for pdtran Specifies the scalar alpha .
a
(local)
DOUBLE PRECISION for pdtran Array, size (lld_a, LOCq(ja+m-1)) . This array contains the local pieces of the distributed matrix sub(A) .
ia , ja
(global) The row and column indices in the distributed matrix A indicating the first row and the first column of the submatrix sub(A) , respectively.
desca
(global and local) array of dimension 9. The array descriptor of the distributed matrix A .
beta
(global)
DOUBLE PRECISION for pdtran Specifies the scalar beta . When beta is equal to zero, then sub(C) need not be set on input.
c
(local)
DOUBLE PRECISION for pdtran Array, size (lld_c, LOCq(jc+n-1)) . This array contains the local pieces of the distributed matrix sub(C) .
ic , jc
(global) The row and column indices in the distributed matrix C indicating the first row and the first column of the submatrix sub(C) , respectively.
descc
(global and local) array of dimension 9. The array descriptor of the distributed matrix C .
Output Parameters
- c
-
Overwritten by the updated submatrix.