dgssfa (3p)

Name

dgssfa - General sparse solver numeric factorization.

Synopsis

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

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

Description

Oracle Solaris Studio Performance Library                           dgssfa(3P)



NAME
       dgssfa - General sparse solver numeric factorization.

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

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


PURPOSE
       DGSSFA - 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 DGSSIN, 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 DGSSIN, 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(*) - DOUBLE PRECISION 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 DGSSIN 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 DGSSOR first.
                -301 : Failure to dynamically allocate memory.
                -666 : Internal error.




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