Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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)

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

home | help