cgssfs(3P) Sun Performance Library cgssfs(3P)NAMEcgssfs - General sparse solver one call interface.
SYNOPSIS
SUBROUTINE CGSSFS ( 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
COMPLEX VALUES(*), RHS(*)
DOUBLE PRECISION HANDLE(150)PURPOSE
CGSSFS - 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(*) - 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(*) - 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 CGSSUO)
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 6 Mar 2009 cgssfs(3P)
