1ZLACON(1)           LAPACK auxiliary routine (version 3.2)           ZLACON(1)
2
3
4

NAME

6       ZLACON - estimates the 1-norm of a square, complex matrix A
7

SYNOPSIS

9       SUBROUTINE ZLACON( N, V, X, EST, KASE )
10
11           INTEGER        KASE, N
12
13           DOUBLE         PRECISION EST
14
15           COMPLEX*16     V( N ), X( N )
16

PURPOSE

18       ZLACON  estimates  the  1-norm  of a square, complex matrix A.  Reverse
19       communication is used for evaluating matrix-vector products.
20

ARGUMENTS

22       N      (input) INTEGER
23              The order of the matrix.  N >= 1.
24
25       V      (workspace) COMPLEX*16 array, dimension (N)
26              On the final return, V = A*W,  where  EST =  norm(V)/norm(W)  (W
27              is not returned).
28
29       X      (input/output) COMPLEX*16 array, dimension (N)
30              On  an  intermediate  return,  X should be overwritten by A * X,
31              if KASE=1, A' * X,  if KASE=2, where A' is the conjugate  trans‐
32              pose  of  A,  and  ZLACON  must  be re-called with all the other
33              parameters unchanged.
34
35       EST    (input/output) DOUBLE PRECISION
36              On entry with KASE = 1  or  2  and  JUMP  =  3,  EST  should  be
37              unchanged  from the previous call to ZLACON.  On exit, EST is an
38              estimate (a lower bound) for norm(A).
39
40       KASE   (input/output) INTEGER
41              On the initial call to ZLACON, KASE should be 0.  On an interme‐
42              diate  return,  KASE will be 1 or 2, indicating whether X should
43              be overwritten by A * X  or A' * X.  On the  final  return  from
44              ZLACON, KASE will again be 0.
45

FURTHER DETAILS

47       Contributed by Nick Higham, University of Manchester.
48       Originally named CONEST, dated March 16, 1988.
49       Reference: N.J. Higham, "FORTRAN codes for estimating the one-norm of a
50       real or complex matrix, with applications to condition estimation", ACM
51       Trans.  Math.  Soft., vol. 14, no. 4, pp. 381-396, December 1988.  Last
52       modified:  April, 1999
53
54
55
56 LAPACK auxiliary routine (versionNo3v.e2m)ber 2008                       ZLACON(1)