You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

sbdsqr.f 27 kB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863
  1. *> \brief \b SBDSQR
  2. *
  3. * =========== DOCUMENTATION ===========
  4. *
  5. * Online html documentation available at
  6. * http://www.netlib.org/lapack/explore-html/
  7. *
  8. *> \htmlonly
  9. *> Download SBDSQR + dependencies
  10. *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/sbdsqr.f">
  11. *> [TGZ]</a>
  12. *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/sbdsqr.f">
  13. *> [ZIP]</a>
  14. *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/sbdsqr.f">
  15. *> [TXT]</a>
  16. *> \endhtmlonly
  17. *
  18. * Definition:
  19. * ===========
  20. *
  21. * SUBROUTINE SBDSQR( UPLO, N, NCVT, NRU, NCC, D, E, VT, LDVT, U,
  22. * LDU, C, LDC, WORK, INFO )
  23. *
  24. * .. Scalar Arguments ..
  25. * CHARACTER UPLO
  26. * INTEGER INFO, LDC, LDU, LDVT, N, NCC, NCVT, NRU
  27. * ..
  28. * .. Array Arguments ..
  29. * REAL C( LDC, * ), D( * ), E( * ), U( LDU, * ),
  30. * $ VT( LDVT, * ), WORK( * )
  31. * ..
  32. *
  33. *
  34. *> \par Purpose:
  35. * =============
  36. *>
  37. *> \verbatim
  38. *>
  39. *> SBDSQR computes the singular values and, optionally, the right and/or
  40. *> left singular vectors from the singular value decomposition (SVD) of
  41. *> a real N-by-N (upper or lower) bidiagonal matrix B using the implicit
  42. *> zero-shift QR algorithm. The SVD of B has the form
  43. *>
  44. *> B = Q * S * P**T
  45. *>
  46. *> where S is the diagonal matrix of singular values, Q is an orthogonal
  47. *> matrix of left singular vectors, and P is an orthogonal matrix of
  48. *> right singular vectors. If left singular vectors are requested, this
  49. *> subroutine actually returns U*Q instead of Q, and, if right singular
  50. *> vectors are requested, this subroutine returns P**T*VT instead of
  51. *> P**T, for given real input matrices U and VT. When U and VT are the
  52. *> orthogonal matrices that reduce a general matrix A to bidiagonal
  53. *> form: A = U*B*VT, as computed by SGEBRD, then
  54. *>
  55. *> A = (U*Q) * S * (P**T*VT)
  56. *>
  57. *> is the SVD of A. Optionally, the subroutine may also compute Q**T*C
  58. *> for a given real input matrix C.
  59. *>
  60. *> See "Computing Small Singular Values of Bidiagonal Matrices With
  61. *> Guaranteed High Relative Accuracy," by J. Demmel and W. Kahan,
  62. *> LAPACK Working Note #3 (or SIAM J. Sci. Statist. Comput. vol. 11,
  63. *> no. 5, pp. 873-912, Sept 1990) and
  64. *> "Accurate singular values and differential qd algorithms," by
  65. *> B. Parlett and V. Fernando, Technical Report CPAM-554, Mathematics
  66. *> Department, University of California at Berkeley, July 1992
  67. *> for a detailed description of the algorithm.
  68. *> \endverbatim
  69. *
  70. * Arguments:
  71. * ==========
  72. *
  73. *> \param[in] UPLO
  74. *> \verbatim
  75. *> UPLO is CHARACTER*1
  76. *> = 'U': B is upper bidiagonal;
  77. *> = 'L': B is lower bidiagonal.
  78. *> \endverbatim
  79. *>
  80. *> \param[in] N
  81. *> \verbatim
  82. *> N is INTEGER
  83. *> The order of the matrix B. N >= 0.
  84. *> \endverbatim
  85. *>
  86. *> \param[in] NCVT
  87. *> \verbatim
  88. *> NCVT is INTEGER
  89. *> The number of columns of the matrix VT. NCVT >= 0.
  90. *> \endverbatim
  91. *>
  92. *> \param[in] NRU
  93. *> \verbatim
  94. *> NRU is INTEGER
  95. *> The number of rows of the matrix U. NRU >= 0.
  96. *> \endverbatim
  97. *>
  98. *> \param[in] NCC
  99. *> \verbatim
  100. *> NCC is INTEGER
  101. *> The number of columns of the matrix C. NCC >= 0.
  102. *> \endverbatim
  103. *>
  104. *> \param[in,out] D
  105. *> \verbatim
  106. *> D is REAL array, dimension (N)
  107. *> On entry, the n diagonal elements of the bidiagonal matrix B.
  108. *> On exit, if INFO=0, the singular values of B in decreasing
  109. *> order.
  110. *> \endverbatim
  111. *>
  112. *> \param[in,out] E
  113. *> \verbatim
  114. *> E is REAL array, dimension (N-1)
  115. *> On entry, the N-1 offdiagonal elements of the bidiagonal
  116. *> matrix B.
  117. *> On exit, if INFO = 0, E is destroyed; if INFO > 0, D and E
  118. *> will contain the diagonal and superdiagonal elements of a
  119. *> bidiagonal matrix orthogonally equivalent to the one given
  120. *> as input.
  121. *> \endverbatim
  122. *>
  123. *> \param[in,out] VT
  124. *> \verbatim
  125. *> VT is REAL array, dimension (LDVT, NCVT)
  126. *> On entry, an N-by-NCVT matrix VT.
  127. *> On exit, VT is overwritten by P**T * VT.
  128. *> Not referenced if NCVT = 0.
  129. *> \endverbatim
  130. *>
  131. *> \param[in] LDVT
  132. *> \verbatim
  133. *> LDVT is INTEGER
  134. *> The leading dimension of the array VT.
  135. *> LDVT >= max(1,N) if NCVT > 0; LDVT >= 1 if NCVT = 0.
  136. *> \endverbatim
  137. *>
  138. *> \param[in,out] U
  139. *> \verbatim
  140. *> U is REAL array, dimension (LDU, N)
  141. *> On entry, an NRU-by-N matrix U.
  142. *> On exit, U is overwritten by U * Q.
  143. *> Not referenced if NRU = 0.
  144. *> \endverbatim
  145. *>
  146. *> \param[in] LDU
  147. *> \verbatim
  148. *> LDU is INTEGER
  149. *> The leading dimension of the array U. LDU >= max(1,NRU).
  150. *> \endverbatim
  151. *>
  152. *> \param[in,out] C
  153. *> \verbatim
  154. *> C is REAL array, dimension (LDC, NCC)
  155. *> On entry, an N-by-NCC matrix C.
  156. *> On exit, C is overwritten by Q**T * C.
  157. *> Not referenced if NCC = 0.
  158. *> \endverbatim
  159. *>
  160. *> \param[in] LDC
  161. *> \verbatim
  162. *> LDC is INTEGER
  163. *> The leading dimension of the array C.
  164. *> LDC >= max(1,N) if NCC > 0; LDC >=1 if NCC = 0.
  165. *> \endverbatim
  166. *>
  167. *> \param[out] WORK
  168. *> \verbatim
  169. *> WORK is REAL array, dimension (4*N)
  170. *> \endverbatim
  171. *>
  172. *> \param[out] INFO
  173. *> \verbatim
  174. *> INFO is INTEGER
  175. *> = 0: successful exit
  176. *> < 0: If INFO = -i, the i-th argument had an illegal value
  177. *> > 0:
  178. *> if NCVT = NRU = NCC = 0,
  179. *> = 1, a split was marked by a positive value in E
  180. *> = 2, current block of Z not diagonalized after 30*N
  181. *> iterations (in inner while loop)
  182. *> = 3, termination criterion of outer while loop not met
  183. *> (program created more than N unreduced blocks)
  184. *> else NCVT = NRU = NCC = 0,
  185. *> the algorithm did not converge; D and E contain the
  186. *> elements of a bidiagonal matrix which is orthogonally
  187. *> similar to the input matrix B; if INFO = i, i
  188. *> elements of E have not converged to zero.
  189. *> \endverbatim
  190. *
  191. *> \par Internal Parameters:
  192. * =========================
  193. *>
  194. *> \verbatim
  195. *> TOLMUL REAL, default = max(10,min(100,EPS**(-1/8)))
  196. *> TOLMUL controls the convergence criterion of the QR loop.
  197. *> If it is positive, TOLMUL*EPS is the desired relative
  198. *> precision in the computed singular values.
  199. *> If it is negative, abs(TOLMUL*EPS*sigma_max) is the
  200. *> desired absolute accuracy in the computed singular
  201. *> values (corresponds to relative accuracy
  202. *> abs(TOLMUL*EPS) in the largest singular value.
  203. *> abs(TOLMUL) should be between 1 and 1/EPS, and preferably
  204. *> between 10 (for fast convergence) and .1/EPS
  205. *> (for there to be some accuracy in the results).
  206. *> Default is to lose at either one eighth or 2 of the
  207. *> available decimal digits in each computed singular value
  208. *> (whichever is smaller).
  209. *>
  210. *> MAXITR INTEGER, default = 6
  211. *> MAXITR controls the maximum number of passes of the
  212. *> algorithm through its inner loop. The algorithms stops
  213. *> (and so fails to converge) if the number of passes
  214. *> through the inner loop exceeds MAXITR*N**2.
  215. *> \endverbatim
  216. *
  217. *> \par Note:
  218. * ===========
  219. *>
  220. *> \verbatim
  221. *> Bug report from Cezary Dendek.
  222. *> On March 23rd 2017, the INTEGER variable MAXIT = MAXITR*N**2 is
  223. *> removed since it can overflow pretty easily (for N larger or equal
  224. *> than 18,919). We instead use MAXITDIVN = MAXITR*N.
  225. *> \endverbatim
  226. *
  227. * Authors:
  228. * ========
  229. *
  230. *> \author Univ. of Tennessee
  231. *> \author Univ. of California Berkeley
  232. *> \author Univ. of Colorado Denver
  233. *> \author NAG Ltd.
  234. *
  235. *> \ingroup auxOTHERcomputational
  236. *
  237. * =====================================================================
  238. SUBROUTINE SBDSQR( UPLO, N, NCVT, NRU, NCC, D, E, VT, LDVT, U,
  239. $ LDU, C, LDC, WORK, INFO )
  240. *
  241. * -- LAPACK computational routine --
  242. * -- LAPACK is a software package provided by Univ. of Tennessee, --
  243. * -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
  244. *
  245. * .. Scalar Arguments ..
  246. CHARACTER UPLO
  247. INTEGER INFO, LDC, LDU, LDVT, N, NCC, NCVT, NRU
  248. * ..
  249. * .. Array Arguments ..
  250. REAL C( LDC, * ), D( * ), E( * ), U( LDU, * ),
  251. $ VT( LDVT, * ), WORK( * )
  252. * ..
  253. *
  254. * =====================================================================
  255. *
  256. * .. Parameters ..
  257. REAL ZERO
  258. PARAMETER ( ZERO = 0.0E0 )
  259. REAL ONE
  260. PARAMETER ( ONE = 1.0E0 )
  261. REAL NEGONE
  262. PARAMETER ( NEGONE = -1.0E0 )
  263. REAL HNDRTH
  264. PARAMETER ( HNDRTH = 0.01E0 )
  265. REAL TEN
  266. PARAMETER ( TEN = 10.0E0 )
  267. REAL HNDRD
  268. PARAMETER ( HNDRD = 100.0E0 )
  269. REAL MEIGTH
  270. PARAMETER ( MEIGTH = -0.125E0 )
  271. INTEGER MAXITR
  272. PARAMETER ( MAXITR = 6 )
  273. * ..
  274. * .. Local Scalars ..
  275. LOGICAL LOWER, ROTATE
  276. INTEGER I, IDIR, ISUB, ITER, ITERDIVN, J, LL, LLL, M,
  277. $ MAXITDIVN, NM1, NM12, NM13, OLDLL, OLDM
  278. REAL ABSE, ABSS, COSL, COSR, CS, EPS, F, G, H, MU,
  279. $ OLDCS, OLDSN, R, SHIFT, SIGMN, SIGMX, SINL,
  280. $ SINR, SLL, SMAX, SMIN, SMINL, SMINOA,
  281. $ SN, THRESH, TOL, TOLMUL, UNFL
  282. * ..
  283. * .. External Functions ..
  284. LOGICAL LSAME
  285. REAL SLAMCH
  286. EXTERNAL LSAME, SLAMCH
  287. * ..
  288. * .. External Subroutines ..
  289. EXTERNAL SLARTG, SLAS2, SLASQ1, SLASR, SLASV2, SROT,
  290. $ SSCAL, SSWAP, XERBLA
  291. * ..
  292. * .. Intrinsic Functions ..
  293. INTRINSIC ABS, MAX, MIN, REAL, SIGN, SQRT
  294. * ..
  295. * .. Executable Statements ..
  296. *
  297. * Test the input parameters.
  298. *
  299. INFO = 0
  300. LOWER = LSAME( UPLO, 'L' )
  301. IF( .NOT.LSAME( UPLO, 'U' ) .AND. .NOT.LOWER ) THEN
  302. INFO = -1
  303. ELSE IF( N.LT.0 ) THEN
  304. INFO = -2
  305. ELSE IF( NCVT.LT.0 ) THEN
  306. INFO = -3
  307. ELSE IF( NRU.LT.0 ) THEN
  308. INFO = -4
  309. ELSE IF( NCC.LT.0 ) THEN
  310. INFO = -5
  311. ELSE IF( ( NCVT.EQ.0 .AND. LDVT.LT.1 ) .OR.
  312. $ ( NCVT.GT.0 .AND. LDVT.LT.MAX( 1, N ) ) ) THEN
  313. INFO = -9
  314. ELSE IF( LDU.LT.MAX( 1, NRU ) ) THEN
  315. INFO = -11
  316. ELSE IF( ( NCC.EQ.0 .AND. LDC.LT.1 ) .OR.
  317. $ ( NCC.GT.0 .AND. LDC.LT.MAX( 1, N ) ) ) THEN
  318. INFO = -13
  319. END IF
  320. IF( INFO.NE.0 ) THEN
  321. CALL XERBLA( 'SBDSQR', -INFO )
  322. RETURN
  323. END IF
  324. IF( N.EQ.0 )
  325. $ RETURN
  326. IF( N.EQ.1 )
  327. $ GO TO 160
  328. *
  329. * ROTATE is true if any singular vectors desired, false otherwise
  330. *
  331. ROTATE = ( NCVT.GT.0 ) .OR. ( NRU.GT.0 ) .OR. ( NCC.GT.0 )
  332. *
  333. * If no singular vectors desired, use qd algorithm
  334. *
  335. IF( .NOT.ROTATE ) THEN
  336. CALL SLASQ1( N, D, E, WORK, INFO )
  337. *
  338. * If INFO equals 2, dqds didn't finish, try to finish
  339. *
  340. IF( INFO .NE. 2 ) RETURN
  341. INFO = 0
  342. END IF
  343. *
  344. NM1 = N - 1
  345. NM12 = NM1 + NM1
  346. NM13 = NM12 + NM1
  347. IDIR = 0
  348. *
  349. * Get machine constants
  350. *
  351. EPS = SLAMCH( 'Epsilon' )
  352. UNFL = SLAMCH( 'Safe minimum' )
  353. *
  354. * If matrix lower bidiagonal, rotate to be upper bidiagonal
  355. * by applying Givens rotations on the left
  356. *
  357. IF( LOWER ) THEN
  358. DO 10 I = 1, N - 1
  359. CALL SLARTG( D( I ), E( I ), CS, SN, R )
  360. D( I ) = R
  361. E( I ) = SN*D( I+1 )
  362. D( I+1 ) = CS*D( I+1 )
  363. WORK( I ) = CS
  364. WORK( NM1+I ) = SN
  365. 10 CONTINUE
  366. *
  367. * Update singular vectors if desired
  368. *
  369. IF( NRU.GT.0 )
  370. $ CALL SLASR( 'R', 'V', 'F', NRU, N, WORK( 1 ), WORK( N ), U,
  371. $ LDU )
  372. IF( NCC.GT.0 )
  373. $ CALL SLASR( 'L', 'V', 'F', N, NCC, WORK( 1 ), WORK( N ), C,
  374. $ LDC )
  375. END IF
  376. *
  377. * Compute singular values to relative accuracy TOL
  378. * (By setting TOL to be negative, algorithm will compute
  379. * singular values to absolute accuracy ABS(TOL)*norm(input matrix))
  380. *
  381. TOLMUL = MAX( TEN, MIN( HNDRD, EPS**MEIGTH ) )
  382. TOL = TOLMUL*EPS
  383. *
  384. * Compute approximate maximum, minimum singular values
  385. *
  386. SMAX = ZERO
  387. DO 20 I = 1, N
  388. SMAX = MAX( SMAX, ABS( D( I ) ) )
  389. 20 CONTINUE
  390. DO 30 I = 1, N - 1
  391. SMAX = MAX( SMAX, ABS( E( I ) ) )
  392. 30 CONTINUE
  393. SMINL = ZERO
  394. IF( TOL.GE.ZERO ) THEN
  395. *
  396. * Relative accuracy desired
  397. *
  398. SMINOA = ABS( D( 1 ) )
  399. IF( SMINOA.EQ.ZERO )
  400. $ GO TO 50
  401. MU = SMINOA
  402. DO 40 I = 2, N
  403. MU = ABS( D( I ) )*( MU / ( MU+ABS( E( I-1 ) ) ) )
  404. SMINOA = MIN( SMINOA, MU )
  405. IF( SMINOA.EQ.ZERO )
  406. $ GO TO 50
  407. 40 CONTINUE
  408. 50 CONTINUE
  409. SMINOA = SMINOA / SQRT( REAL( N ) )
  410. THRESH = MAX( TOL*SMINOA, MAXITR*(N*(N*UNFL)) )
  411. ELSE
  412. *
  413. * Absolute accuracy desired
  414. *
  415. THRESH = MAX( ABS( TOL )*SMAX, MAXITR*(N*(N*UNFL)) )
  416. END IF
  417. *
  418. * Prepare for main iteration loop for the singular values
  419. * (MAXIT is the maximum number of passes through the inner
  420. * loop permitted before nonconvergence signalled.)
  421. *
  422. MAXITDIVN = MAXITR*N
  423. ITERDIVN = 0
  424. ITER = -1
  425. OLDLL = -1
  426. OLDM = -1
  427. *
  428. * M points to last element of unconverged part of matrix
  429. *
  430. M = N
  431. *
  432. * Begin main iteration loop
  433. *
  434. 60 CONTINUE
  435. *
  436. * Check for convergence or exceeding iteration count
  437. *
  438. IF( M.LE.1 )
  439. $ GO TO 160
  440. *
  441. IF( ITER.GE.N ) THEN
  442. ITER = ITER - N
  443. ITERDIVN = ITERDIVN + 1
  444. IF( ITERDIVN.GE.MAXITDIVN )
  445. $ GO TO 200
  446. END IF
  447. *
  448. * Find diagonal block of matrix to work on
  449. *
  450. IF( TOL.LT.ZERO .AND. ABS( D( M ) ).LE.THRESH )
  451. $ D( M ) = ZERO
  452. SMAX = ABS( D( M ) )
  453. SMIN = SMAX
  454. DO 70 LLL = 1, M - 1
  455. LL = M - LLL
  456. ABSS = ABS( D( LL ) )
  457. ABSE = ABS( E( LL ) )
  458. IF( TOL.LT.ZERO .AND. ABSS.LE.THRESH )
  459. $ D( LL ) = ZERO
  460. IF( ABSE.LE.THRESH )
  461. $ GO TO 80
  462. SMIN = MIN( SMIN, ABSS )
  463. SMAX = MAX( SMAX, ABSS, ABSE )
  464. 70 CONTINUE
  465. LL = 0
  466. GO TO 90
  467. 80 CONTINUE
  468. E( LL ) = ZERO
  469. *
  470. * Matrix splits since E(LL) = 0
  471. *
  472. IF( LL.EQ.M-1 ) THEN
  473. *
  474. * Convergence of bottom singular value, return to top of loop
  475. *
  476. M = M - 1
  477. GO TO 60
  478. END IF
  479. 90 CONTINUE
  480. LL = LL + 1
  481. *
  482. * E(LL) through E(M-1) are nonzero, E(LL-1) is zero
  483. *
  484. IF( LL.EQ.M-1 ) THEN
  485. *
  486. * 2 by 2 block, handle separately
  487. *
  488. CALL SLASV2( D( M-1 ), E( M-1 ), D( M ), SIGMN, SIGMX, SINR,
  489. $ COSR, SINL, COSL )
  490. D( M-1 ) = SIGMX
  491. E( M-1 ) = ZERO
  492. D( M ) = SIGMN
  493. *
  494. * Compute singular vectors, if desired
  495. *
  496. IF( NCVT.GT.0 )
  497. $ CALL SROT( NCVT, VT( M-1, 1 ), LDVT, VT( M, 1 ), LDVT, COSR,
  498. $ SINR )
  499. IF( NRU.GT.0 )
  500. $ CALL SROT( NRU, U( 1, M-1 ), 1, U( 1, M ), 1, COSL, SINL )
  501. IF( NCC.GT.0 )
  502. $ CALL SROT( NCC, C( M-1, 1 ), LDC, C( M, 1 ), LDC, COSL,
  503. $ SINL )
  504. M = M - 2
  505. GO TO 60
  506. END IF
  507. *
  508. * If working on new submatrix, choose shift direction
  509. * (from larger end diagonal element towards smaller)
  510. *
  511. IF( LL.GT.OLDM .OR. M.LT.OLDLL ) THEN
  512. IF( ABS( D( LL ) ).GE.ABS( D( M ) ) ) THEN
  513. *
  514. * Chase bulge from top (big end) to bottom (small end)
  515. *
  516. IDIR = 1
  517. ELSE
  518. *
  519. * Chase bulge from bottom (big end) to top (small end)
  520. *
  521. IDIR = 2
  522. END IF
  523. END IF
  524. *
  525. * Apply convergence tests
  526. *
  527. IF( IDIR.EQ.1 ) THEN
  528. *
  529. * Run convergence test in forward direction
  530. * First apply standard test to bottom of matrix
  531. *
  532. IF( ABS( E( M-1 ) ).LE.ABS( TOL )*ABS( D( M ) ) .OR.
  533. $ ( TOL.LT.ZERO .AND. ABS( E( M-1 ) ).LE.THRESH ) ) THEN
  534. E( M-1 ) = ZERO
  535. GO TO 60
  536. END IF
  537. *
  538. IF( TOL.GE.ZERO ) THEN
  539. *
  540. * If relative accuracy desired,
  541. * apply convergence criterion forward
  542. *
  543. MU = ABS( D( LL ) )
  544. SMINL = MU
  545. DO 100 LLL = LL, M - 1
  546. IF( ABS( E( LLL ) ).LE.TOL*MU ) THEN
  547. E( LLL ) = ZERO
  548. GO TO 60
  549. END IF
  550. MU = ABS( D( LLL+1 ) )*( MU / ( MU+ABS( E( LLL ) ) ) )
  551. SMINL = MIN( SMINL, MU )
  552. 100 CONTINUE
  553. END IF
  554. *
  555. ELSE
  556. *
  557. * Run convergence test in backward direction
  558. * First apply standard test to top of matrix
  559. *
  560. IF( ABS( E( LL ) ).LE.ABS( TOL )*ABS( D( LL ) ) .OR.
  561. $ ( TOL.LT.ZERO .AND. ABS( E( LL ) ).LE.THRESH ) ) THEN
  562. E( LL ) = ZERO
  563. GO TO 60
  564. END IF
  565. *
  566. IF( TOL.GE.ZERO ) THEN
  567. *
  568. * If relative accuracy desired,
  569. * apply convergence criterion backward
  570. *
  571. MU = ABS( D( M ) )
  572. SMINL = MU
  573. DO 110 LLL = M - 1, LL, -1
  574. IF( ABS( E( LLL ) ).LE.TOL*MU ) THEN
  575. E( LLL ) = ZERO
  576. GO TO 60
  577. END IF
  578. MU = ABS( D( LLL ) )*( MU / ( MU+ABS( E( LLL ) ) ) )
  579. SMINL = MIN( SMINL, MU )
  580. 110 CONTINUE
  581. END IF
  582. END IF
  583. OLDLL = LL
  584. OLDM = M
  585. *
  586. * Compute shift. First, test if shifting would ruin relative
  587. * accuracy, and if so set the shift to zero.
  588. *
  589. IF( TOL.GE.ZERO .AND. N*TOL*( SMINL / SMAX ).LE.
  590. $ MAX( EPS, HNDRTH*TOL ) ) THEN
  591. *
  592. * Use a zero shift to avoid loss of relative accuracy
  593. *
  594. SHIFT = ZERO
  595. ELSE
  596. *
  597. * Compute the shift from 2-by-2 block at end of matrix
  598. *
  599. IF( IDIR.EQ.1 ) THEN
  600. SLL = ABS( D( LL ) )
  601. CALL SLAS2( D( M-1 ), E( M-1 ), D( M ), SHIFT, R )
  602. ELSE
  603. SLL = ABS( D( M ) )
  604. CALL SLAS2( D( LL ), E( LL ), D( LL+1 ), SHIFT, R )
  605. END IF
  606. *
  607. * Test if shift negligible, and if so set to zero
  608. *
  609. IF( SLL.GT.ZERO ) THEN
  610. IF( ( SHIFT / SLL )**2.LT.EPS )
  611. $ SHIFT = ZERO
  612. END IF
  613. END IF
  614. *
  615. * Increment iteration count
  616. *
  617. ITER = ITER + M - LL
  618. *
  619. * If SHIFT = 0, do simplified QR iteration
  620. *
  621. IF( SHIFT.EQ.ZERO ) THEN
  622. IF( IDIR.EQ.1 ) THEN
  623. *
  624. * Chase bulge from top to bottom
  625. * Save cosines and sines for later singular vector updates
  626. *
  627. CS = ONE
  628. OLDCS = ONE
  629. DO 120 I = LL, M - 1
  630. CALL SLARTG( D( I )*CS, E( I ), CS, SN, R )
  631. IF( I.GT.LL )
  632. $ E( I-1 ) = OLDSN*R
  633. CALL SLARTG( OLDCS*R, D( I+1 )*SN, OLDCS, OLDSN, D( I ) )
  634. WORK( I-LL+1 ) = CS
  635. WORK( I-LL+1+NM1 ) = SN
  636. WORK( I-LL+1+NM12 ) = OLDCS
  637. WORK( I-LL+1+NM13 ) = OLDSN
  638. 120 CONTINUE
  639. H = D( M )*CS
  640. D( M ) = H*OLDCS
  641. E( M-1 ) = H*OLDSN
  642. *
  643. * Update singular vectors
  644. *
  645. IF( NCVT.GT.0 )
  646. $ CALL SLASR( 'L', 'V', 'F', M-LL+1, NCVT, WORK( 1 ),
  647. $ WORK( N ), VT( LL, 1 ), LDVT )
  648. IF( NRU.GT.0 )
  649. $ CALL SLASR( 'R', 'V', 'F', NRU, M-LL+1, WORK( NM12+1 ),
  650. $ WORK( NM13+1 ), U( 1, LL ), LDU )
  651. IF( NCC.GT.0 )
  652. $ CALL SLASR( 'L', 'V', 'F', M-LL+1, NCC, WORK( NM12+1 ),
  653. $ WORK( NM13+1 ), C( LL, 1 ), LDC )
  654. *
  655. * Test convergence
  656. *
  657. IF( ABS( E( M-1 ) ).LE.THRESH )
  658. $ E( M-1 ) = ZERO
  659. *
  660. ELSE
  661. *
  662. * Chase bulge from bottom to top
  663. * Save cosines and sines for later singular vector updates
  664. *
  665. CS = ONE
  666. OLDCS = ONE
  667. DO 130 I = M, LL + 1, -1
  668. CALL SLARTG( D( I )*CS, E( I-1 ), CS, SN, R )
  669. IF( I.LT.M )
  670. $ E( I ) = OLDSN*R
  671. CALL SLARTG( OLDCS*R, D( I-1 )*SN, OLDCS, OLDSN, D( I ) )
  672. WORK( I-LL ) = CS
  673. WORK( I-LL+NM1 ) = -SN
  674. WORK( I-LL+NM12 ) = OLDCS
  675. WORK( I-LL+NM13 ) = -OLDSN
  676. 130 CONTINUE
  677. H = D( LL )*CS
  678. D( LL ) = H*OLDCS
  679. E( LL ) = H*OLDSN
  680. *
  681. * Update singular vectors
  682. *
  683. IF( NCVT.GT.0 )
  684. $ CALL SLASR( 'L', 'V', 'B', M-LL+1, NCVT, WORK( NM12+1 ),
  685. $ WORK( NM13+1 ), VT( LL, 1 ), LDVT )
  686. IF( NRU.GT.0 )
  687. $ CALL SLASR( 'R', 'V', 'B', NRU, M-LL+1, WORK( 1 ),
  688. $ WORK( N ), U( 1, LL ), LDU )
  689. IF( NCC.GT.0 )
  690. $ CALL SLASR( 'L', 'V', 'B', M-LL+1, NCC, WORK( 1 ),
  691. $ WORK( N ), C( LL, 1 ), LDC )
  692. *
  693. * Test convergence
  694. *
  695. IF( ABS( E( LL ) ).LE.THRESH )
  696. $ E( LL ) = ZERO
  697. END IF
  698. ELSE
  699. *
  700. * Use nonzero shift
  701. *
  702. IF( IDIR.EQ.1 ) THEN
  703. *
  704. * Chase bulge from top to bottom
  705. * Save cosines and sines for later singular vector updates
  706. *
  707. F = ( ABS( D( LL ) )-SHIFT )*
  708. $ ( SIGN( ONE, D( LL ) )+SHIFT / D( LL ) )
  709. G = E( LL )
  710. DO 140 I = LL, M - 1
  711. CALL SLARTG( F, G, COSR, SINR, R )
  712. IF( I.GT.LL )
  713. $ E( I-1 ) = R
  714. F = COSR*D( I ) + SINR*E( I )
  715. E( I ) = COSR*E( I ) - SINR*D( I )
  716. G = SINR*D( I+1 )
  717. D( I+1 ) = COSR*D( I+1 )
  718. CALL SLARTG( F, G, COSL, SINL, R )
  719. D( I ) = R
  720. F = COSL*E( I ) + SINL*D( I+1 )
  721. D( I+1 ) = COSL*D( I+1 ) - SINL*E( I )
  722. IF( I.LT.M-1 ) THEN
  723. G = SINL*E( I+1 )
  724. E( I+1 ) = COSL*E( I+1 )
  725. END IF
  726. WORK( I-LL+1 ) = COSR
  727. WORK( I-LL+1+NM1 ) = SINR
  728. WORK( I-LL+1+NM12 ) = COSL
  729. WORK( I-LL+1+NM13 ) = SINL
  730. 140 CONTINUE
  731. E( M-1 ) = F
  732. *
  733. * Update singular vectors
  734. *
  735. IF( NCVT.GT.0 )
  736. $ CALL SLASR( 'L', 'V', 'F', M-LL+1, NCVT, WORK( 1 ),
  737. $ WORK( N ), VT( LL, 1 ), LDVT )
  738. IF( NRU.GT.0 )
  739. $ CALL SLASR( 'R', 'V', 'F', NRU, M-LL+1, WORK( NM12+1 ),
  740. $ WORK( NM13+1 ), U( 1, LL ), LDU )
  741. IF( NCC.GT.0 )
  742. $ CALL SLASR( 'L', 'V', 'F', M-LL+1, NCC, WORK( NM12+1 ),
  743. $ WORK( NM13+1 ), C( LL, 1 ), LDC )
  744. *
  745. * Test convergence
  746. *
  747. IF( ABS( E( M-1 ) ).LE.THRESH )
  748. $ E( M-1 ) = ZERO
  749. *
  750. ELSE
  751. *
  752. * Chase bulge from bottom to top
  753. * Save cosines and sines for later singular vector updates
  754. *
  755. F = ( ABS( D( M ) )-SHIFT )*( SIGN( ONE, D( M ) )+SHIFT /
  756. $ D( M ) )
  757. G = E( M-1 )
  758. DO 150 I = M, LL + 1, -1
  759. CALL SLARTG( F, G, COSR, SINR, R )
  760. IF( I.LT.M )
  761. $ E( I ) = R
  762. F = COSR*D( I ) + SINR*E( I-1 )
  763. E( I-1 ) = COSR*E( I-1 ) - SINR*D( I )
  764. G = SINR*D( I-1 )
  765. D( I-1 ) = COSR*D( I-1 )
  766. CALL SLARTG( F, G, COSL, SINL, R )
  767. D( I ) = R
  768. F = COSL*E( I-1 ) + SINL*D( I-1 )
  769. D( I-1 ) = COSL*D( I-1 ) - SINL*E( I-1 )
  770. IF( I.GT.LL+1 ) THEN
  771. G = SINL*E( I-2 )
  772. E( I-2 ) = COSL*E( I-2 )
  773. END IF
  774. WORK( I-LL ) = COSR
  775. WORK( I-LL+NM1 ) = -SINR
  776. WORK( I-LL+NM12 ) = COSL
  777. WORK( I-LL+NM13 ) = -SINL
  778. 150 CONTINUE
  779. E( LL ) = F
  780. *
  781. * Test convergence
  782. *
  783. IF( ABS( E( LL ) ).LE.THRESH )
  784. $ E( LL ) = ZERO
  785. *
  786. * Update singular vectors if desired
  787. *
  788. IF( NCVT.GT.0 )
  789. $ CALL SLASR( 'L', 'V', 'B', M-LL+1, NCVT, WORK( NM12+1 ),
  790. $ WORK( NM13+1 ), VT( LL, 1 ), LDVT )
  791. IF( NRU.GT.0 )
  792. $ CALL SLASR( 'R', 'V', 'B', NRU, M-LL+1, WORK( 1 ),
  793. $ WORK( N ), U( 1, LL ), LDU )
  794. IF( NCC.GT.0 )
  795. $ CALL SLASR( 'L', 'V', 'B', M-LL+1, NCC, WORK( 1 ),
  796. $ WORK( N ), C( LL, 1 ), LDC )
  797. END IF
  798. END IF
  799. *
  800. * QR iteration finished, go back and check convergence
  801. *
  802. GO TO 60
  803. *
  804. * All singular values converged, so make them positive
  805. *
  806. 160 CONTINUE
  807. DO 170 I = 1, N
  808. IF( D( I ).LT.ZERO ) THEN
  809. D( I ) = -D( I )
  810. *
  811. * Change sign of singular vectors, if desired
  812. *
  813. IF( NCVT.GT.0 )
  814. $ CALL SSCAL( NCVT, NEGONE, VT( I, 1 ), LDVT )
  815. END IF
  816. 170 CONTINUE
  817. *
  818. * Sort the singular values into decreasing order (insertion sort on
  819. * singular values, but only one transposition per singular vector)
  820. *
  821. DO 190 I = 1, N - 1
  822. *
  823. * Scan for smallest D(I)
  824. *
  825. ISUB = 1
  826. SMIN = D( 1 )
  827. DO 180 J = 2, N + 1 - I
  828. IF( D( J ).LE.SMIN ) THEN
  829. ISUB = J
  830. SMIN = D( J )
  831. END IF
  832. 180 CONTINUE
  833. IF( ISUB.NE.N+1-I ) THEN
  834. *
  835. * Swap singular values and vectors
  836. *
  837. D( ISUB ) = D( N+1-I )
  838. D( N+1-I ) = SMIN
  839. IF( NCVT.GT.0 )
  840. $ CALL SSWAP( NCVT, VT( ISUB, 1 ), LDVT, VT( N+1-I, 1 ),
  841. $ LDVT )
  842. IF( NRU.GT.0 )
  843. $ CALL SSWAP( NRU, U( 1, ISUB ), 1, U( 1, N+1-I ), 1 )
  844. IF( NCC.GT.0 )
  845. $ CALL SSWAP( NCC, C( ISUB, 1 ), LDC, C( N+1-I, 1 ), LDC )
  846. END IF
  847. 190 CONTINUE
  848. GO TO 220
  849. *
  850. * Maximum number of iterations exceeded, failure to converge
  851. *
  852. 200 CONTINUE
  853. INFO = 0
  854. DO 210 I = 1, N - 1
  855. IF( E( I ).NE.ZERO )
  856. $ INFO = INFO + 1
  857. 210 CONTINUE
  858. 220 CONTINUE
  859. RETURN
  860. *
  861. * End of SBDSQR
  862. *
  863. END