# FreeBSD Manual Pages

```BSpar_solve(3)			 BlockSolve95			BSpar_solve(3)

NAME
BSpar_solve - General solver of a system	of equations preconditioned by
one of several preconditioners and using	one of several possible	 meth-
ods.  The rhs can be a block of vectors.

INPUT PARAMETERS
A      -	a sparse matrix
fact_A -	the incomplete factored	version	of A, if any
comm_A -	the communication structure for	A
rhs    -	the contiguous block of	vectors	forming	the rhs
residual
-	the final computed residual

OUTPUT PARAMETERS
x      -	 the  contiguous block of vectors containing the solution (can
contain an initial guess if BSctx_set_guess() is set.

NOW SPECIFIED IN PROCINFO CONTEXT
pre_option
-	the preconditioner to use:
PRE_ICC: incomplete Cholesky factorization
PRE_ILU: incomplete LU factorization
PRE_SSOR: Successive over relaxation
PRE_BJACOBI: Block Jacobi
err_tol
-	the tolerance to which to solve	the problem stop if the	 esti-
mated  norm  of  the  residual divided by	the norm of the	rhs is
less than	err_tol
max_iter
-	the maximum number of iterations to take
guess  -	if TRUE, then initialize out_x to 0, otherwise the program as-
sumes that out_x contains	an initial guess
procinfo
-	the usual processor stuff

RETURNS
The  number of iterations or a negative number indicating the number of
iterations prior	to finding that	the matrix (or preconditioner) is  not
positive	definite.

NOTES
The preconditioners must	be computed prior to calling BSpar_solve.  For
more  information  on  the   preconditioners,   see   the   manual   or
BSctx_set_pre().

SYNOPSIS
int BSpar_solve(BSpar_mat *A, BSpar_mat *fact_A,	BScomm *comm_A,
FLOAT *rhs, FLOAT *x, FLOAT *residual, BSprocinfo *procinfo)

LOCATION
BlockSolve95/src/BSpar_solve.c

1/10/1996			BSpar_solve(3)
```

NAME | INPUT PARAMETERS | OUTPUT PARAMETERS | NOW SPECIFIED IN PROCINFO CONTEXT | RETURNS | NOTES | SYNOPSIS | LOCATION

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=BSpar_solve&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>