cgssfa (3p)

Name

cgssfa - General sparse solver numeric factorization.

Synopsis

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

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

Description

Oracle Solaris Studio Performance Library                           cgssfa(3P)



NAME
       cgssfa - General sparse solver numeric factorization.

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

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


PURPOSE
       CGSSFA - 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 CGSSIN, 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 CGSSIN, 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(*) - COMPLEX 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 CGSSIN 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 CGSSOR first.
                -301 : Failure to dynamically allocate memory.
                -666 : Internal error.




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