.TH CLACON 1 "November 2006" " LAPACK auxiliary routine (version 3.1) " " LAPACK auxiliary routine (version 3.1) "
.SH NAME
CLACON - the 1-norm of a square, complex matrix A
.SH SYNOPSIS
.TP 19
SUBROUTINE CLACON(
N, V, X, EST, KASE )
.TP 19
.ti +4
INTEGER
KASE, N
.TP 19
.ti +4
REAL
EST
.TP 19
.ti +4
COMPLEX
V( N ), X( N )
.SH PURPOSE
CLACON estimates the 1-norm of a square, complex matrix A.
Reverse communication is used for evaluating matrix-vector products.
.SH ARGUMENTS
.TP 7
N (input) INTEGER
The order of the matrix. N >= 1.
.TP 7
V (workspace) COMPLEX array, dimension (N)
On the final return, V = A*W, where EST = norm(V)/norm(W)
(W is not returned).
.TP 7
X (input/output) COMPLEX array, dimension (N)
On an intermediate return, X should be overwritten by
A * X, if KASE=1,
A\(aq * X, if KASE=2,
where A\(aq is the conjugate transpose of A, and CLACON must be
re-called with all the other parameters unchanged.
.TP 7
EST (input/output) REAL
On entry with KASE = 1 or 2 and JUMP = 3, EST should be
unchanged from the previous call to CLACON.
On exit, EST is an estimate (a lower bound) for norm(A).
.TP 7
KASE (input/output) INTEGER
On the initial call to CLACON, KASE should be 0.
On an intermediate return, KASE will be 1 or 2, indicating
whether X should be overwritten by A * X or A\(aq * X.
On the final return from CLACON, KASE will again be 0.
.SH FURTHER DETAILS
Contributed by Nick Higham, University of Manchester.
.br
Originally named CONEST, dated March 16, 1988.
.br
Reference: N.J. Higham, "FORTRAN codes for estimating the one-norm of
a real or complex matrix, with applications to condition estimation",
ACM Trans. Math. Soft., vol. 14, no. 4, pp. 381-396, December 1988.
Last modified: April, 1999
.br