zgssfs (3p)

Name

zgssfs - General sparse solver one call interface.

Synopsis

SUBROUTINE ZGSSFS ( MTXTYP, PIVOT , NEQNS, COLSTR, ROWIND,
VALUES, NRHS  , RHS   , LDRHS , ORDMTHD,
OUTUNT, MSGLVL, HANDLE, IER )

CHARACTER*2       MTXTYP
CHARACTER*1       PIVOT
INTEGER           NEQNS, COLSTR(*), ROWIND(*), NRHS, LDRHS,
OUTUNT, MSGLVL, IER
CHARACTER*3       ORDMTHD
DOUBLE COMPLEX    VALUES(*), RHS(*)
DOUBLE PRECISION  HANDLE(150)

Description

Oracle Solaris Studio Performance Library                           zgssfs(3P)



NAME
       zgssfs - General sparse solver one call interface.

SYNOPSIS
        SUBROUTINE ZGSSFS ( MTXTYP, PIVOT , NEQNS, COLSTR, ROWIND,
                            VALUES, NRHS  , RHS   , LDRHS , ORDMTHD,
                            OUTUNT, MSGLVL, HANDLE, IER )

        CHARACTER*2       MTXTYP
        CHARACTER*1       PIVOT
        INTEGER           NEQNS, COLSTR(*), ROWIND(*), NRHS, LDRHS,
                          OUTUNT, MSGLVL, IER
        CHARACTER*3       ORDMTHD
        DOUBLE COMPLEX    VALUES(*), RHS(*)
        DOUBLE PRECISION  HANDLE(150)


PURPOSE
       ZGSSFS - General sparse solver one call interface.

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), containing
               the pointers of the matrix structure.  Unchanged on exit.

       ROWIND(*) - INTEGER array
               On entry, ROWIND(*) is an array of size COLSTR(NEQNS+1)-1, con-
               taining the indices of the matrix structure.  Unchanged on
               exit.

       VALUES(*) - DOUBLE COMPLEX array
               On entry, VALUES(*) is an array of size COLSTR(NEQNS+1)-1, con-
               taining the non-zero numeric values of the sparse matrix to be
               factored.  Unchanged on exit.

       NRHS      - INTEGER
               On entry, NRHS specifies the number of right hand sides to
               solve for.  Unchanged on exit.

       RHS(*)    - DOUBLE COMPLEX array
               On entry, RHS(LDRHS,NRHS) contains the NRHS right hand sides.
               On exit, it contains the solutions.

       LDRHS     - INTEGER
               On entry, LDRHS specifies the leading dimension of the RHS
               array. Unchanged on exit.

       ORDMTHD   - CHARACTER*3
               On entry, ORDMTHD specifies the fill-reducing ordering to be
               used by the sparse solver.  Valid options are:

                'nat' or 'NAT' - natural ordering (no ordering)
                'mmd' or 'MMD' - multiple minimum degree (default)
                'gnd' or 'GND' - general nested dissection
                'uso' or 'USO' - user specified ordering (see ZGSSUO)

               When SuperLU is selected in the initialization routine DGSSIN,
               valid options are:

                'nat' or 'NAT' - natural ordering (no ordering)
                'mmd' or 'MMD' - minimum degree ordering on A'*A (default)
                'spm' or 'SPM' - Minimum degree ordering on A'+A
                'sam' or 'SAM' - Approximate minimum degree column ordering

               In the case of an invalid option, the default method is used.
               Unchanged 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.

       HANDLE(150)  - DOUBLE PRECISION array
               On entry, HANDLE(*) is an array of 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:

                -101 : Failure to dynamically allocate memory.
                -102 : Invalid matrix type.
                -103 : Invalid pivot option.
                -104 : Number of nonzeros is less than NEQNS.
                -105 : NEQNS < 1
                -106 : Invalid matrix structure.
                -107 : Zero-based indexing required for SuperLU.
                -201 : Failure to dynamically allocate memory.
                -301 : Failure to dynamically allocate memory.
                -401 : Failure to dynamically allocate memory.
                -402 : NRHS < 1
                -403 : NEQNS > LDRHS
                -666 : Internal error.




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