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

  
 
  

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 methods.  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  con-
	    tain 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 estimated
	    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 assumes
	    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 it-
     erations prior to finding that the matrix (or preconditioner) is not  posi-
     tive 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+15.1.quarterly>

home | help