--- rpl/lapack/lapack/zgesc2.f 2010/12/21 13:53:44 1.7 +++ rpl/lapack/lapack/zgesc2.f 2011/11/21 20:43:09 1.8 @@ -1,9 +1,124 @@ +*> \brief \b ZGESC2 +* +* =========== DOCUMENTATION =========== +* +* Online html documentation available at +* http://www.netlib.org/lapack/explore-html/ +* +*> \htmlonly +*> Download ZGESC2 + dependencies +*> +*> [TGZ] +*> +*> [ZIP] +*> +*> [TXT] +*> \endhtmlonly +* +* Definition: +* =========== +* +* SUBROUTINE ZGESC2( N, A, LDA, RHS, IPIV, JPIV, SCALE ) +* +* .. Scalar Arguments .. +* INTEGER LDA, N +* DOUBLE PRECISION SCALE +* .. +* .. Array Arguments .. +* INTEGER IPIV( * ), JPIV( * ) +* COMPLEX*16 A( LDA, * ), RHS( * ) +* .. +* +* +*> \par Purpose: +* ============= +*> +*> \verbatim +*> +*> ZGESC2 solves a system of linear equations +*> +*> A * X = scale* RHS +*> +*> with a general N-by-N matrix A using the LU factorization with +*> complete pivoting computed by ZGETC2. +*> +*> \endverbatim +* +* Arguments: +* ========== +* +*> \param[in] N +*> \verbatim +*> N is INTEGER +*> The number of columns of the matrix A. +*> \endverbatim +*> +*> \param[in] A +*> \verbatim +*> A is COMPLEX*16 array, dimension (LDA, N) +*> On entry, the LU part of the factorization of the n-by-n +*> matrix A computed by ZGETC2: A = P * L * U * Q +*> \endverbatim +*> +*> \param[in] LDA +*> \verbatim +*> LDA is INTEGER +*> The leading dimension of the array A. LDA >= max(1, N). +*> \endverbatim +*> +*> \param[in,out] RHS +*> \verbatim +*> RHS is COMPLEX*16 array, dimension N. +*> On entry, the right hand side vector b. +*> On exit, the solution vector X. +*> \endverbatim +*> +*> \param[in] IPIV +*> \verbatim +*> IPIV is INTEGER array, dimension (N). +*> The pivot indices; for 1 <= i <= N, row i of the +*> matrix has been interchanged with row IPIV(i). +*> \endverbatim +*> +*> \param[in] JPIV +*> \verbatim +*> JPIV is INTEGER array, dimension (N). +*> The pivot indices; for 1 <= j <= N, column j of the +*> matrix has been interchanged with column JPIV(j). +*> \endverbatim +*> +*> \param[out] SCALE +*> \verbatim +*> SCALE is DOUBLE PRECISION +*> On exit, SCALE contains the scale factor. SCALE is chosen +*> 0 <= SCALE <= 1 to prevent owerflow in the solution. +*> \endverbatim +* +* Authors: +* ======== +* +*> \author Univ. of Tennessee +*> \author Univ. of California Berkeley +*> \author Univ. of Colorado Denver +*> \author NAG Ltd. +* +*> \date November 2011 +* +*> \ingroup complex16GEauxiliary +* +*> \par Contributors: +* ================== +*> +*> Bo Kagstrom and Peter Poromaa, Department of Computing Science, +*> Umea University, S-901 87 Umea, Sweden. +* +* ===================================================================== SUBROUTINE ZGESC2( N, A, LDA, RHS, IPIV, JPIV, SCALE ) * -* -- LAPACK auxiliary routine (version 3.2) -- +* -- LAPACK auxiliary routine (version 3.4.0) -- * -- LAPACK is a software package provided by Univ. of Tennessee, -- * -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- -* November 2006 +* November 2011 * * .. Scalar Arguments .. INTEGER LDA, N @@ -14,53 +129,6 @@ COMPLEX*16 A( LDA, * ), RHS( * ) * .. * -* Purpose -* ======= -* -* ZGESC2 solves a system of linear equations -* -* A * X = scale* RHS -* -* with a general N-by-N matrix A using the LU factorization with -* complete pivoting computed by ZGETC2. -* -* -* Arguments -* ========= -* -* N (input) INTEGER -* The number of columns of the matrix A. -* -* A (input) COMPLEX*16 array, dimension (LDA, N) -* On entry, the LU part of the factorization of the n-by-n -* matrix A computed by ZGETC2: A = P * L * U * Q -* -* LDA (input) INTEGER -* The leading dimension of the array A. LDA >= max(1, N). -* -* RHS (input/output) COMPLEX*16 array, dimension N. -* On entry, the right hand side vector b. -* On exit, the solution vector X. -* -* IPIV (input) INTEGER array, dimension (N). -* The pivot indices; for 1 <= i <= N, row i of the -* matrix has been interchanged with row IPIV(i). -* -* JPIV (input) INTEGER array, dimension (N). -* The pivot indices; for 1 <= j <= N, column j of the -* matrix has been interchanged with column JPIV(j). -* -* SCALE (output) DOUBLE PRECISION -* On exit, SCALE contains the scale factor. SCALE is chosen -* 0 <= SCALE <= 1 to prevent owerflow in the solution. -* -* Further Details -* =============== -* -* Based on contributions by -* Bo Kagstrom and Peter Poromaa, Department of Computing Science, -* Umea University, S-901 87 Umea, Sweden. -* * ===================================================================== * * .. Parameters ..