Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
?laset
Initializes the off-diagonal elements and the diagonal elements of a matrix to given values.
Syntax
call slaset ( uplo , m , n , alpha , beta , a , lda )
call dlaset ( uplo , m , n , alpha , beta , a , lda )
call claset ( uplo , m , n , alpha , beta , a , lda )
call zlaset ( uplo , m , n , alpha , beta , a , lda )
Include Files
mkl.fi
Description
slaset dlaset claset zlaset
The routine initializes an m -by- n matrix A to beta on the diagonal and alpha on the off-diagonals.
Input Parameters
The data types are given for the Fortran interface.
uplo
CHARACTER*1 . Specifies the part of the matrix A to be set.
If uplo = 'U' , upper triangular part is set; the strictly lower triangular part of A is not changed. If uplo = 'L' : lower triangular part is set; the strictly upper triangular part of A is not changed. Otherwise: A ll of the matrix A is set.
m
INTEGER . The number of rows of the matrix A . m≥ 0 .
n
INTEGER . The number of columns of the matrix A .
n≥ 0 .
- alpha , beta
-
REAL for slaset DOUBLE PRECISION for dlaset COMPLEX for claset DOUBLE COMPLEX for zlaset . The constants to which the off-diagonal and diagonal elements are to be set, respectively.
- a
-
REAL for slaset DOUBLE PRECISION for dlaset COMPLEX for claset DOUBLE COMPLEX for zlaset . Array, DIMENSION ( lda , n ). Array, size at least max(1, lda*n) for column major and max(1, lda*m) for row major layout. The array a contains the m -by- n matrix A .
lda
INTEGER . The leading dimension of the array a .
lda ≥ max(1, m ) .
Output Parameters
- a
-
On exit, the leading m -by- n submatrix of A is set as follows: if uplo = 'U' , A_{ij} = alpha , 1≤i≤j-1, 1≤j≤n , if uplo = 'L' , A_{ij} = alpha, j+1≤i≤m, 1≤j≤n , otherwise, A_{ij} = alpha , 1≤i≤m, 1≤j≤n, i≠j , and, for all uplo , A_{ii} = beta , 1≤i≤min(m, n) .
Return Values
No return value.