LAPACK  3.4.2
LAPACK: Linear Algebra PACKage
 All Files Functions Groups
slantp.f
Go to the documentation of this file.
1 *> \brief \b SLANTP returns the value of the 1-norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a triangular matrix supplied in packed form.
2 *
3 * =========== DOCUMENTATION ===========
4 *
5 * Online html documentation available at
6 * http://www.netlib.org/lapack/explore-html/
7 *
8 *> \htmlonly
9 *> Download SLANTP + dependencies
10 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/slantp.f">
11 *> [TGZ]</a>
12 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/slantp.f">
13 *> [ZIP]</a>
14 *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/slantp.f">
15 *> [TXT]</a>
16 *> \endhtmlonly
17 *
18 * Definition:
19 * ===========
20 *
21 * REAL FUNCTION SLANTP( NORM, UPLO, DIAG, N, AP, WORK )
22 *
23 * .. Scalar Arguments ..
24 * CHARACTER DIAG, NORM, UPLO
25 * INTEGER N
26 * ..
27 * .. Array Arguments ..
28 * REAL AP( * ), WORK( * )
29 * ..
30 *
31 *
32 *> \par Purpose:
33 * =============
34 *>
35 *> \verbatim
36 *>
37 *> SLANTP returns the value of the one norm, or the Frobenius norm, or
38 *> the infinity norm, or the element of largest absolute value of a
39 *> triangular matrix A, supplied in packed form.
40 *> \endverbatim
41 *>
42 *> \return SLANTP
43 *> \verbatim
44 *>
45 *> SLANTP = ( max(abs(A(i,j))), NORM = 'M' or 'm'
46 *> (
47 *> ( norm1(A), NORM = '1', 'O' or 'o'
48 *> (
49 *> ( normI(A), NORM = 'I' or 'i'
50 *> (
51 *> ( normF(A), NORM = 'F', 'f', 'E' or 'e'
52 *>
53 *> where norm1 denotes the one norm of a matrix (maximum column sum),
54 *> normI denotes the infinity norm of a matrix (maximum row sum) and
55 *> normF denotes the Frobenius norm of a matrix (square root of sum of
56 *> squares). Note that max(abs(A(i,j))) is not a consistent matrix norm.
57 *> \endverbatim
58 *
59 * Arguments:
60 * ==========
61 *
62 *> \param[in] NORM
63 *> \verbatim
64 *> NORM is CHARACTER*1
65 *> Specifies the value to be returned in SLANTP as described
66 *> above.
67 *> \endverbatim
68 *>
69 *> \param[in] UPLO
70 *> \verbatim
71 *> UPLO is CHARACTER*1
72 *> Specifies whether the matrix A is upper or lower triangular.
73 *> = 'U': Upper triangular
74 *> = 'L': Lower triangular
75 *> \endverbatim
76 *>
77 *> \param[in] DIAG
78 *> \verbatim
79 *> DIAG is CHARACTER*1
80 *> Specifies whether or not the matrix A is unit triangular.
81 *> = 'N': Non-unit triangular
82 *> = 'U': Unit triangular
83 *> \endverbatim
84 *>
85 *> \param[in] N
86 *> \verbatim
87 *> N is INTEGER
88 *> The order of the matrix A. N >= 0. When N = 0, SLANTP is
89 *> set to zero.
90 *> \endverbatim
91 *>
92 *> \param[in] AP
93 *> \verbatim
94 *> AP is REAL array, dimension (N*(N+1)/2)
95 *> The upper or lower triangular matrix A, packed columnwise in
96 *> a linear array. The j-th column of A is stored in the array
97 *> AP as follows:
98 *> if UPLO = 'U', AP(i + (j-1)*j/2) = A(i,j) for 1<=i<=j;
99 *> if UPLO = 'L', AP(i + (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
100 *> Note that when DIAG = 'U', the elements of the array AP
101 *> corresponding to the diagonal elements of the matrix A are
102 *> not referenced, but are assumed to be one.
103 *> \endverbatim
104 *>
105 *> \param[out] WORK
106 *> \verbatim
107 *> WORK is REAL array, dimension (MAX(1,LWORK)),
108 *> where LWORK >= N when NORM = 'I'; otherwise, WORK is not
109 *> referenced.
110 *> \endverbatim
111 *
112 * Authors:
113 * ========
114 *
115 *> \author Univ. of Tennessee
116 *> \author Univ. of California Berkeley
117 *> \author Univ. of Colorado Denver
118 *> \author NAG Ltd.
119 *
120 *> \date September 2012
121 *
122 *> \ingroup realOTHERauxiliary
123 *
124 * =====================================================================
125  REAL FUNCTION slantp( NORM, UPLO, DIAG, N, AP, WORK )
126 *
127 * -- LAPACK auxiliary routine (version 3.4.2) --
128 * -- LAPACK is a software package provided by Univ. of Tennessee, --
129 * -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
130 * September 2012
131 *
132 * .. Scalar Arguments ..
133  CHARACTER diag, norm, uplo
134  INTEGER n
135 * ..
136 * .. Array Arguments ..
137  REAL ap( * ), work( * )
138 * ..
139 *
140 * =====================================================================
141 *
142 * .. Parameters ..
143  REAL one, zero
144  parameter( one = 1.0e+0, zero = 0.0e+0 )
145 * ..
146 * .. Local Scalars ..
147  LOGICAL udiag
148  INTEGER i, j, k
149  REAL scale, sum, value
150 * ..
151 * .. External Subroutines ..
152  EXTERNAL slassq
153 * ..
154 * .. External Functions ..
155  LOGICAL lsame, sisnan
156  EXTERNAL lsame, sisnan
157 * ..
158 * .. Intrinsic Functions ..
159  INTRINSIC abs, sqrt
160 * ..
161 * .. Executable Statements ..
162 *
163  IF( n.EQ.0 ) THEN
164  value = zero
165  ELSE IF( lsame( norm, 'M' ) ) THEN
166 *
167 * Find max(abs(A(i,j))).
168 *
169  k = 1
170  IF( lsame( diag, 'U' ) ) THEN
171  value = one
172  IF( lsame( uplo, 'U' ) ) THEN
173  DO 20 j = 1, n
174  DO 10 i = k, k + j - 2
175  sum = abs( ap( i ) )
176  IF( value .LT. sum .OR. sisnan( sum ) ) value = sum
177  10 continue
178  k = k + j
179  20 continue
180  ELSE
181  DO 40 j = 1, n
182  DO 30 i = k + 1, k + n - j
183  sum = abs( ap( i ) )
184  IF( value .LT. sum .OR. sisnan( sum ) ) value = sum
185  30 continue
186  k = k + n - j + 1
187  40 continue
188  END IF
189  ELSE
190  value = zero
191  IF( lsame( uplo, 'U' ) ) THEN
192  DO 60 j = 1, n
193  DO 50 i = k, k + j - 1
194  sum = abs( ap( i ) )
195  IF( value .LT. sum .OR. sisnan( sum ) ) value = sum
196  50 continue
197  k = k + j
198  60 continue
199  ELSE
200  DO 80 j = 1, n
201  DO 70 i = k, k + n - j
202  sum = abs( ap( i ) )
203  IF( value .LT. sum .OR. sisnan( sum ) ) value = sum
204  70 continue
205  k = k + n - j + 1
206  80 continue
207  END IF
208  END IF
209  ELSE IF( ( lsame( norm, 'O' ) ) .OR. ( norm.EQ.'1' ) ) THEN
210 *
211 * Find norm1(A).
212 *
213  value = zero
214  k = 1
215  udiag = lsame( diag, 'U' )
216  IF( lsame( uplo, 'U' ) ) THEN
217  DO 110 j = 1, n
218  IF( udiag ) THEN
219  sum = one
220  DO 90 i = k, k + j - 2
221  sum = sum + abs( ap( i ) )
222  90 continue
223  ELSE
224  sum = zero
225  DO 100 i = k, k + j - 1
226  sum = sum + abs( ap( i ) )
227  100 continue
228  END IF
229  k = k + j
230  IF( value .LT. sum .OR. sisnan( sum ) ) value = sum
231  110 continue
232  ELSE
233  DO 140 j = 1, n
234  IF( udiag ) THEN
235  sum = one
236  DO 120 i = k + 1, k + n - j
237  sum = sum + abs( ap( i ) )
238  120 continue
239  ELSE
240  sum = zero
241  DO 130 i = k, k + n - j
242  sum = sum + abs( ap( i ) )
243  130 continue
244  END IF
245  k = k + n - j + 1
246  IF( value .LT. sum .OR. sisnan( sum ) ) value = sum
247  140 continue
248  END IF
249  ELSE IF( lsame( norm, 'I' ) ) THEN
250 *
251 * Find normI(A).
252 *
253  k = 1
254  IF( lsame( uplo, 'U' ) ) THEN
255  IF( lsame( diag, 'U' ) ) THEN
256  DO 150 i = 1, n
257  work( i ) = one
258  150 continue
259  DO 170 j = 1, n
260  DO 160 i = 1, j - 1
261  work( i ) = work( i ) + abs( ap( k ) )
262  k = k + 1
263  160 continue
264  k = k + 1
265  170 continue
266  ELSE
267  DO 180 i = 1, n
268  work( i ) = zero
269  180 continue
270  DO 200 j = 1, n
271  DO 190 i = 1, j
272  work( i ) = work( i ) + abs( ap( k ) )
273  k = k + 1
274  190 continue
275  200 continue
276  END IF
277  ELSE
278  IF( lsame( diag, 'U' ) ) THEN
279  DO 210 i = 1, n
280  work( i ) = one
281  210 continue
282  DO 230 j = 1, n
283  k = k + 1
284  DO 220 i = j + 1, n
285  work( i ) = work( i ) + abs( ap( k ) )
286  k = k + 1
287  220 continue
288  230 continue
289  ELSE
290  DO 240 i = 1, n
291  work( i ) = zero
292  240 continue
293  DO 260 j = 1, n
294  DO 250 i = j, n
295  work( i ) = work( i ) + abs( ap( k ) )
296  k = k + 1
297  250 continue
298  260 continue
299  END IF
300  END IF
301  value = zero
302  DO 270 i = 1, n
303  sum = work( i )
304  IF( value .LT. sum .OR. sisnan( sum ) ) value = sum
305  270 continue
306  ELSE IF( ( lsame( norm, 'F' ) ) .OR. ( lsame( norm, 'E' ) ) ) THEN
307 *
308 * Find normF(A).
309 *
310  IF( lsame( uplo, 'U' ) ) THEN
311  IF( lsame( diag, 'U' ) ) THEN
312  scale = one
313  sum = n
314  k = 2
315  DO 280 j = 2, n
316  CALL slassq( j-1, ap( k ), 1, scale, sum )
317  k = k + j
318  280 continue
319  ELSE
320  scale = zero
321  sum = one
322  k = 1
323  DO 290 j = 1, n
324  CALL slassq( j, ap( k ), 1, scale, sum )
325  k = k + j
326  290 continue
327  END IF
328  ELSE
329  IF( lsame( diag, 'U' ) ) THEN
330  scale = one
331  sum = n
332  k = 2
333  DO 300 j = 1, n - 1
334  CALL slassq( n-j, ap( k ), 1, scale, sum )
335  k = k + n - j + 1
336  300 continue
337  ELSE
338  scale = zero
339  sum = one
340  k = 1
341  DO 310 j = 1, n
342  CALL slassq( n-j+1, ap( k ), 1, scale, sum )
343  k = k + n - j + 1
344  310 continue
345  END IF
346  END IF
347  value = scale*sqrt( sum )
348  END IF
349 *
350  slantp = value
351  return
352 *
353 * End of SLANTP
354 *
355  END