sgssfa (3p)

Name

sgssfa - General sparse solver numeric factorization.

Synopsis

SUBROUTINE SGSSFA ( NEQNS, COLSTR, ROWIND, VALUES, HANDLE, IER )

INTEGER           NEQNS, COLSTR(*), ROWIND(*), IER
REAL              VALUES(*)
DOUBLE PRECISION  HANDLE(150)

Description

Oracle Solaris Studio Performance Library                           sgssfa(3P)



NAME
       sgssfa - General sparse solver numeric factorization.

SYNOPSIS
        SUBROUTINE SGSSFA ( NEQNS, COLSTR, ROWIND, VALUES, HANDLE, IER )

        INTEGER           NEQNS, COLSTR(*), ROWIND(*), IER
        REAL              VALUES(*)
        DOUBLE PRECISION  HANDLE(150)


PURPOSE
       SGSSFA - Numeric factorization of a sparse matrix.

PARAMETERS
       NEQNS     - INTEGER
               On entry, NEQNS specifies the number of equations in coeffi-
               cient matrix.  Unchanged on exit.

       COLSTR(*) - INTEGER array
               On entry, COLSTR(*) is an array of size (NEQNS+1).  If MTXTYP
               is specified as 'sp', 'SP', 'ss', or 'SS' in the initialization
               routine SGSSIN, it contains the column pointers of the lower
               triangular part of the symmetric matrix.  Otherwise, it con-
               tains the column pointers of the  full matrix.  Unchanged on
               exit.

       ROWIND(*) - INTEGER array
               On entry, ROWIND(*) is an array of size COLSTR(NEQNS+1)-1.  If
               MTXTYP is specified as 'sp', 'SP', 'ss', or 'SS' in the ini-
               tialization routine SGSSIN, it contains the row indices of the
               nonzero values in the lower triangular part of the symmetric
               matrix.  Otherwise, it contains the row indices of the nonzero
               values in the full matrix.  Unchanged on exit.

       VALUES(*) - REAL array
               VALUES(*) is an array of size COLSTR(NEQNS+1)-1.  On entry, If
               MTXTYP is specified as 'sp', 'SP', 'ss', or 'SS' in the ini-
               tialization routine SGSSIN it contains the nonzero values in
               the lower triangular part of the symmetric matrix.   Otherwise,
               it contains the nonzero values in the full matrix.  Unchanged
               on exit.

       HANDLE(150)  - DOUBLE PRECISION array
               On entry, HANDLE(*) is an array containing information needed
               by the solver, and must be passed unchanged to each sparse
               solver subroutine.  Modified on exit.

       IER       - INTEGER
               Error number.  If no error encountered, unchanged on exit.  If
               error encountered, it is set to a non-zero integer.  Error num-
               bers set by this subroutine:

                -300 : Invalid calling sequence - need to call SGSSOR first.
                -301 : Failure to dynamically allocate memory.
                -666 : Internal error.




3rd Berkeley Distribution         7 Nov 2015                        sgssfa(3P)