version 1.4, 2017/06/17 10:54:13
|
version 1.9, 2023/08/07 08:39:22
|
Line 7
|
Line 7
|
* |
* |
*> \htmlonly |
*> \htmlonly |
*> Download ZGSVJ1 + dependencies |
*> Download ZGSVJ1 + dependencies |
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/dgsvj1.f"> |
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/zgsvj1.f"> |
*> [TGZ]</a> |
*> [TGZ]</a> |
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/dgsvj1.f"> |
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/zgsvj1.f"> |
*> [ZIP]</a> |
*> [ZIP]</a> |
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/dgsvj1.f"> |
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/zgsvj1.f"> |
*> [TXT]</a> |
*> [TXT]</a> |
*> \endhtmlonly |
*> \endhtmlonly |
* |
* |
Line 40
|
Line 40
|
*> ZGSVJ1 is called from ZGESVJ as a pre-processor and that is its main |
*> ZGSVJ1 is called from ZGESVJ as a pre-processor and that is its main |
*> purpose. It applies Jacobi rotations in the same way as ZGESVJ does, but |
*> purpose. It applies Jacobi rotations in the same way as ZGESVJ does, but |
*> it targets only particular pivots and it does not check convergence |
*> it targets only particular pivots and it does not check convergence |
*> (stopping criterion). Few tunning parameters (marked by [TP]) are |
*> (stopping criterion). Few tuning parameters (marked by [TP]) are |
*> available for the implementer. |
*> available for the implementer. |
*> |
*> |
*> Further Details |
*> Further Details |
Line 61
|
Line 61
|
*> In terms of the columns of A, the first N1 columns are rotated 'against' |
*> In terms of the columns of A, the first N1 columns are rotated 'against' |
*> the remaining N-N1 columns, trying to increase the angle between the |
*> the remaining N-N1 columns, trying to increase the angle between the |
*> corresponding subspaces. The off-diagonal block is N1-by(N-N1) and it is |
*> corresponding subspaces. The off-diagonal block is N1-by(N-N1) and it is |
*> tiled using quadratic tiles of side KBL. Here, KBL is a tunning parmeter. |
*> tiled using quadratic tiles of side KBL. Here, KBL is a tuning parameter. |
*> The number of sweeps is given in NSWEEP and the orthogonality threshold |
*> The number of sweeps is given in NSWEEP and the orthogonality threshold |
*> is given in TOL. |
*> is given in TOL. |
*> \endverbatim |
*> \endverbatim |
Line 147
|
Line 147
|
*> \param[in] MV |
*> \param[in] MV |
*> \verbatim |
*> \verbatim |
*> MV is INTEGER |
*> MV is INTEGER |
*> If JOBV .EQ. 'A', then MV rows of V are post-multipled by a |
*> If JOBV = 'A', then MV rows of V are post-multipled by a |
*> sequence of Jacobi rotations. |
*> sequence of Jacobi rotations. |
*> If JOBV = 'N', then MV is not referenced. |
*> If JOBV = 'N', then MV is not referenced. |
*> \endverbatim |
*> \endverbatim |
Line 155
|
Line 155
|
*> \param[in,out] V |
*> \param[in,out] V |
*> \verbatim |
*> \verbatim |
*> V is COMPLEX*16 array, dimension (LDV,N) |
*> V is COMPLEX*16 array, dimension (LDV,N) |
*> If JOBV .EQ. 'V' then N rows of V are post-multipled by a |
*> If JOBV = 'V' then N rows of V are post-multipled by a |
*> sequence of Jacobi rotations. |
*> sequence of Jacobi rotations. |
*> If JOBV .EQ. 'A' then MV rows of V are post-multipled by a |
*> If JOBV = 'A' then MV rows of V are post-multipled by a |
*> sequence of Jacobi rotations. |
*> sequence of Jacobi rotations. |
*> If JOBV = 'N', then V is not referenced. |
*> If JOBV = 'N', then V is not referenced. |
*> \endverbatim |
*> \endverbatim |
Line 166
|
Line 166
|
*> \verbatim |
*> \verbatim |
*> LDV is INTEGER |
*> LDV is INTEGER |
*> The leading dimension of the array V, LDV >= 1. |
*> The leading dimension of the array V, LDV >= 1. |
*> If JOBV = 'V', LDV .GE. N. |
*> If JOBV = 'V', LDV >= N. |
*> If JOBV = 'A', LDV .GE. MV. |
*> If JOBV = 'A', LDV >= MV. |
*> \endverbatim |
*> \endverbatim |
*> |
*> |
*> \param[in] EPS |
*> \param[in] EPS |
Line 187
|
Line 187
|
*> TOL is DOUBLE PRECISION |
*> TOL is DOUBLE PRECISION |
*> TOL is the threshold for Jacobi rotations. For a pair |
*> TOL is the threshold for Jacobi rotations. For a pair |
*> A(:,p), A(:,q) of pivot columns, the Jacobi rotation is |
*> A(:,p), A(:,q) of pivot columns, the Jacobi rotation is |
*> applied only if ABS(COS(angle(A(:,p),A(:,q)))) .GT. TOL. |
*> applied only if ABS(COS(angle(A(:,p),A(:,q)))) > TOL. |
*> \endverbatim |
*> \endverbatim |
*> |
*> |
*> \param[in] NSWEEP |
*> \param[in] NSWEEP |
Line 205
|
Line 205
|
*> \param[in] LWORK |
*> \param[in] LWORK |
*> \verbatim |
*> \verbatim |
*> LWORK is INTEGER |
*> LWORK is INTEGER |
*> LWORK is the dimension of WORK. LWORK .GE. M. |
*> LWORK is the dimension of WORK. LWORK >= M. |
*> \endverbatim |
*> \endverbatim |
*> |
*> |
*> \param[out] INFO |
*> \param[out] INFO |
*> \verbatim |
*> \verbatim |
*> INFO is INTEGER |
*> INFO is INTEGER |
*> = 0 : successful exit. |
*> = 0: successful exit. |
*> < 0 : if INFO = -i, then the i-th argument had an illegal value |
*> < 0: if INFO = -i, then the i-th argument had an illegal value |
*> \endverbatim |
*> \endverbatim |
* |
* |
* Authors: |
* Authors: |
Line 223
|
Line 223
|
*> \author Univ. of Colorado Denver |
*> \author Univ. of Colorado Denver |
*> \author NAG Ltd. |
*> \author NAG Ltd. |
* |
* |
*> \date June 2016 |
|
* |
|
*> \ingroup complex16OTHERcomputational |
*> \ingroup complex16OTHERcomputational |
* |
* |
*> \par Contributor: |
*> \par Contributor: |
Line 236
|
Line 234
|
SUBROUTINE ZGSVJ1( JOBV, M, N, N1, A, LDA, D, SVA, MV, V, LDV, |
SUBROUTINE ZGSVJ1( JOBV, M, N, N1, A, LDA, D, SVA, MV, V, LDV, |
$ EPS, SFMIN, TOL, NSWEEP, WORK, LWORK, INFO ) |
$ EPS, SFMIN, TOL, NSWEEP, WORK, LWORK, INFO ) |
* |
* |
* -- LAPACK computational routine (version 3.7.0) -- |
* -- LAPACK computational routine -- |
* -- LAPACK is a software package provided by Univ. of Tennessee, -- |
* -- LAPACK is a software package provided by Univ. of Tennessee, -- |
* -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- |
* -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- |
* June 2016 |
|
* |
* |
IMPLICIT NONE |
IMPLICIT NONE |
* .. Scalar Arguments .. |
* .. Scalar Arguments .. |
Line 282
|
Line 279
|
* .. |
* .. |
* .. External Subroutines .. |
* .. External Subroutines .. |
* .. from BLAS |
* .. from BLAS |
EXTERNAL ZCOPY, ZROT, ZSWAP |
EXTERNAL ZCOPY, ZROT, ZSWAP, ZAXPY |
* .. from LAPACK |
* .. from LAPACK |
EXTERNAL ZLASCL, ZLASSQ, XERBLA |
EXTERNAL ZLASCL, ZLASSQ, XERBLA |
* .. |
* .. |