rocsolver_slasyf Interface Reference

rocsolver_slasyf Interface Reference#

HIPFORT API Reference: hipfort_rocsolver::rocsolver_slasyf Interface Reference
hipfort_rocsolver::rocsolver_slasyf Interface Reference

LASYF computes a partial factorization of a symmetric matrix \(A\) using Bunch-Kaufman diagonal pivoting. More...

Public Member Functions

integer(kind(rocblas_status_success)) function rocsolver_slasyf_ (handle, uplo, n, nb, kb, A, lda, ipiv, myInfo)
 
integer(kind(rocblas_status_success)) function rocsolver_slasyf_full_rank (handle, uplo, n, nb, kb, A, lda, ipiv, myInfo)
 
integer(kind(rocblas_status_success)) function rocsolver_slasyf_rank_0 (handle, uplo, n, nb, kb, A, lda, ipiv, myInfo)
 
integer(kind(rocblas_status_success)) function rocsolver_slasyf_rank_1 (handle, uplo, n, nb, kb, A, lda, ipiv, myInfo)
 

Detailed Description

LASYF computes a partial factorization of a symmetric matrix \(A\) using Bunch-Kaufman diagonal pivoting.

The partial factorization has the form

\[ A = \left[ \begin{array}{cc} I & U_{12} \newline 0 & U_{22} \end{array} \right] \left[ \begin{array}{cc} A_{11} & 0 \newline 0 & D \end{array} \right] \left[ \begin{array}{cc} I & 0 \newline U_{12}^T & U_{22}^T \end{array} \right] \]

or

\[ A = \left[ \begin{array}{cc} L_{11} & 0 \newline L_{21} & I \end{array} \right] \left[ \begin{array}{cc} D & 0 \newline 0 & A_{22} \end{array} \right] \left[ \begin{array}{cc} L_{11}^T & L_{21}^T \newline 0 & I \end{array} \right] \]

depending on the value of uplo. The order of the block diagonal matrix \(D\) is either \(nb\) or \(nb-1\), and is returned in the argument \(kb\).

Parameters
[in]handlerocblas_handle.
[in]uplorocblas_fill.
Specifies whether the upper or lower part of the matrix A is stored. If uplo indicates lower (or upper), then the upper (or lower) part of A is not used.
[in]nrocblas_int. n >= 0.
The number of rows and columns of the matrix A.
[in]nbrocblas_int. 2 <= nb <= n.
The number of columns of A to be factored.
[out]kbpointer to a rocblas_int on the GPU.
The number of columns of A that were actually factored (either nb or nb-1).
[in,out]Apointer to type. Array on the GPU of dimension lda*n.
On entry, the symmetric matrix A to be factored. On exit, the partially factored matrix.
[in]ldarocblas_int. lda >= n.
Specifies the leading dimension of A.
[out]ipivpointer to rocblas_int. Array on the GPU of dimension n.
The vector of pivot indices. Elements of ipiv are 1-based indices. If uplo is upper, then only the last kb elements of ipiv will be set. For n - kb < k <= n, if ipiv[k] > 0 then rows and columns k and ipiv[k] were interchanged and D[k,k] is a 1-by-1 diagonal block. If, instead, ipiv[k] = ipiv[k-1] < 0, then rows and columns k-1 and -ipiv[k] were interchanged and D[k-1,k-1] to D[k,k] is a 2-by-2 diagonal block. If uplo is lower, then only the first kb elements of ipiv will be set. For 1 <= k <= kb, if ipiv[k] > 0 then rows and columns k and ipiv[k] were interchanged and D[k,k] is a 1-by-1 diagonal block. If, instead, ipiv[k] = ipiv[k+1] < 0, then rows and columns k+1 and -ipiv[k] were interchanged and D[k,k] to D[k+1,k+1] is a 2-by-2 diagonal block.
[out]infopointer to a rocblas_int on the GPU.
If info = 0, successful exit. If info[i] = j > 0, D is singular. D[j,j] is the first diagonal zero.

Member Function/Subroutine Documentation

◆ rocsolver_slasyf_()

integer(kind(rocblas_status_success)) function hipfort_rocsolver::rocsolver_slasyf::rocsolver_slasyf_ ( type(c_ptr), value  handle,
integer(kind(rocblas_fill_upper)), value  uplo,
integer(c_int), value  n,
integer(c_int), value  nb,
type(c_ptr), value  kb,
type(c_ptr), value  A,
integer(c_int), value  lda,
type(c_ptr), value  ipiv,
integer(c_int)  myInfo 
)

◆ rocsolver_slasyf_full_rank()

integer(kind(rocblas_status_success)) function hipfort_rocsolver::rocsolver_slasyf::rocsolver_slasyf_full_rank ( type(c_ptr)  handle,
integer(kind(rocblas_fill_upper))  uplo,
integer(c_int)  n,
integer(c_int)  nb,
type(c_ptr)  kb,
real(c_float), dimension(:,:), target  A,
integer(c_int)  lda,
integer(c_int), dimension(:), target  ipiv,
integer(c_int)  myInfo 
)

◆ rocsolver_slasyf_rank_0()

integer(kind(rocblas_status_success)) function hipfort_rocsolver::rocsolver_slasyf::rocsolver_slasyf_rank_0 ( type(c_ptr)  handle,
integer(kind(rocblas_fill_upper))  uplo,
integer(c_int)  n,
integer(c_int)  nb,
type(c_ptr)  kb,
real(c_float), target  A,
integer(c_int)  lda,
integer(c_int), target  ipiv,
integer(c_int)  myInfo 
)

◆ rocsolver_slasyf_rank_1()

integer(kind(rocblas_status_success)) function hipfort_rocsolver::rocsolver_slasyf::rocsolver_slasyf_rank_1 ( type(c_ptr)  handle,
integer(kind(rocblas_fill_upper))  uplo,
integer(c_int)  n,
integer(c_int)  nb,
type(c_ptr)  kb,
real(c_float), dimension(:), target  A,
integer(c_int)  lda,
integer(c_int), dimension(:), target  ipiv,
integer(c_int)  myInfo 
)

The documentation for this interface was generated from the following file: