zgssin (3p)

Name

zgssin - Initialize the general sparse solver.

Synopsis

SUBROUTINE ZGSSIN ( MTXTYP, PIVOT, NEQNS, COLSTR, ROWIND, OUTUNT,
MSGLVL, HANDLE, IER )

CHARACTER*2       MTXTYP
CHARACTER*1       PIVOT
INTEGER           NEQNS, COLSTR(*), ROWIND(*), OUTUNT, MSGLVL, IER
DOUBLE PRECISION  HANDLE(150)

Description

Oracle Solaris Studio Performance Library                           zgssin(3P)



NAME
       zgssin - Initialize the general sparse solver.

SYNOPSIS
        SUBROUTINE ZGSSIN ( MTXTYP, PIVOT, NEQNS, COLSTR, ROWIND, OUTUNT,
                            MSGLVL, HANDLE, IER )

        CHARACTER*2       MTXTYP
        CHARACTER*1       PIVOT
        INTEGER           NEQNS, COLSTR(*), ROWIND(*), OUTUNT, MSGLVL, IER
        DOUBLE PRECISION  HANDLE(150)


PURPOSE
       ZGSSIN - Initialize the sparse solver and input the matrix structure.

PARAMETERS
       MTXTYP    - CHARACTER*2
               On entry, MTXTYP specifies the coefficient matrix type.  Valid
               options are:

                'sp' or 'SP' - symmetric structure, Hermitian positive definite values
                'ss' or 'SS' - symmetric structure, symmetric values
                'su' or 'SU' - symmetric structure, unsymmetric values
                'uu' or 'UU' - unsymmetric structure, unsymmetric values
                'S0' or 's0' - unsymmetric,non-definite structure, use SuperLU

               If MTXTYP is 'sp', 'SP', 'ss', or 'SS', a packed column repre-
               sentation of the lower triangular part of the symmetric matrix
               is expected in COLSTR and ROWIND.  Otherwise, a packed column
               representation of the full matrix is expected in COLSTR and
               ROWIND.  Unchanged on exit.

       PIVOT     - CHARACTER*1
               On entry, PIVOT specifies whether or not pivoting is used in
               the course of the numeric factorization.  This argument is
               ignored if MTXTYP = 'S0' or 's0'.  Currently, the only valid
               option is:

                'n' or 'N' - no pivoting is used
                (Pivoting is not supported for this release).

               Unchanged on exit.

       NEQNS     - INTEGER
               On entry, NEQNS specifies the number of equations in the coef-
               ficient matrix.  NEQNS must be at least one.  Unchanged on
               exit.

       COLSTR(*) - INTEGER array
               On entry, COLSTR(*) is an array of size (NEQNS+1).  If MTXTYP
               is 'sp', 'SP', 'ss', or 'SS', it contains the column pointers
               of the lower triangular part of the symmetric matrix.  Other-
               wise, it contains 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 'sp', 'SP', 'ss', or 'SS', 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.

       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.

       OUTUNT    - INTEGER
               Output unit.  Unchanged on exit.

       MSGLVL    - INTEGER
               Message level.

                0 - no output from solver.
                (No messages supported for this release.)

               Unchanged 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:

                -101 : Failure to dynamically allocate memory.
                -102 : Invalid matrix type.
                -103 : Invalid pivot option.
                -104 : Number of nonzeros less than NEQNS.
                -105 : NEQNS < 1
                -106 : Invalid matrix structure.
                -107 : Zero-based indexing required for SuperLU.




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