rocsparse_bsric0_zero_pivot Interface Reference

rocsparse_bsric0_zero_pivot Interface Reference#

HIPFORT API Reference: hipfort_rocsparse::rocsparse_bsric0_zero_pivot Interface Reference
hipfort_rocsparse::rocsparse_bsric0_zero_pivot Interface Reference

Incomplete Cholesky factorization with 0 fill-ins and no pivoting using BSR storage format. More...

Public Member Functions

integer(kind(rocsparse_status_success)) function rocsparse_bsric0_zero_pivot_ (handle, myInfo, position)

Detailed Description

Incomplete Cholesky factorization with 0 fill-ins and no pivoting using BSR storage format.

rocsparse_bsric0_zero_pivot returns rocsparse_status_zero_pivot, if either a structural or numerical zero has been found during rocsparse_sbsric0(), rocsparse_dbsric0(), rocsparse_cbsric0() or rocsparse_zbsric0() computation. The first zero pivot \(j\) at \(A_{j,j}\) is stored in position, using same index base as the BSR matrix.

position can be in host or device memory. If no zero pivot has been found, position is set to -1 and rocsparse_status_success is returned instead.

If a zero pivot is found, position=j means that either the diagonal block A(j,j) is missing (structural zero) or the diagonal block A(j,j) is not positive definite (numerical zero).
rocsparse_bsric0_zero_pivot is a blocking function. It might influence performance negatively.
[in]handlehandle to the rocsparse library context queue.
[in]infostructure that holds the information collected during the analysis step.
[in,out]positionpointer to zero pivot \(j\), can be in host or device memory.
Return values
rocsparse_status_successthe operation completed successfully.
rocsparse_status_invalid_handlethe library context was not initialized.
rocsparse_status_invalid_pointerinfo or position pointer is invalid.
rocsparse_status_internal_erroran internal error occurred.
rocsparse_status_zero_pivotzero pivot has been found.

Member Function/Subroutine Documentation

◆ rocsparse_bsric0_zero_pivot_()

integer(kind(rocsparse_status_success)) function hipfort_rocsparse::rocsparse_bsric0_zero_pivot::rocsparse_bsric0_zero_pivot_ ( type(c_ptr), value  handle,
type(c_ptr), value  myInfo,
integer(c_int)  position 

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