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
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 in the matrix A. The value of m must be at least zero.
- n
-
INTEGER. The number of columns in the matrix A. The value of n must be at least zero.
- 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.