Solves a system of distributed linear equations.
Copyright (c) 2003, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from U.S. Dept. of Energy)
All rights reserved.
The source code is distributed under BSD license, see the file License.txt at the top-level directory.
-- Distributed SuperLU routine (version 1.0) --
Lawrence Berkeley National Lab, Univ. of California Berkeley.
September 1, 1999
Modified:
Feburary 7, 2001 use MPI_Isend/MPI_Irecv
October 2, 2001 use MPI_Isend/MPI_Irecv with MPI_Test
Purpose
=======
pzgstrs_Bglobal solves a system of distributed linear equations
A*X = B with a general N-by-N matrix A using the LU factorization
computed by pzgstrf.
Arguments
=========
n (input) int (global)
The order of the system of linear equations.
LUstruct (input) LUstruct_t*
The distributed data structures storing L and U factors.
The L and U factors are obtained from pzgstrf for
the possibly scaled and permuted matrix A.
See superlu_ddefs.h for the definition of 'LUstruct_t'.
grid (input) gridinfo_t*
The 2D process mesh. It contains the MPI communicator, the number
of process rows (NPROW), the number of process columns (NPCOL),
and my process rank. It is an input argument to all the
parallel routines.
Grid can be initialized by subroutine SUPERLU_GRIDINIT.
See superlu_ddefs.h for the definition of 'gridinfo_t'.
B (input/output) doublecomplex*
On entry, the right-hand side matrix of the possibly equilibrated
and row permuted system.
On exit, the solution matrix of the possibly equilibrated
and row permuted system if info = 0;
NOTE: Currently, the N-by-NRHS matrix B must reside on all
processes when calling this routine.
ldb (input) int (global)
Leading dimension of matrix B.
nrhs (input) int (global)
Number of right-hand sides.
stat (output) SuperLUStat_t*
Record the statistics about the triangular solves.
See util.h for the definition of 'SuperLUStat_t'.
info (output) int*
= 0: successful exit
< 0: if info = -i, the i-th argument had an illegal value