.TH "TESTING/MATGEN/clatm1.f" 3 "Version 3.12.0" "LAPACK" \" -*- nroff -*-
.ad l
.nh
.SH NAME
TESTING/MATGEN/clatm1.f
.SH SYNOPSIS
.br
.PP
.SS "Functions/Subroutines"

.in +1c
.ti -1c
.RI "subroutine \fBclatm1\fP (mode, cond, irsign, idist, iseed, d, n, info)"
.br
.RI "\fBCLATM1\fP "
.in -1c
.SH "Function/Subroutine Documentation"
.PP 
.SS "subroutine clatm1 (integer mode, real cond, integer irsign, integer idist, integer, dimension( 4 ) iseed, complex, dimension( * ) d, integer n, integer info)"

.PP
\fBCLATM1\fP 
.PP
\fBPurpose:\fP
.RS 4

.PP
.nf
    CLATM1 computes the entries of D(1\&.\&.N) as specified by
    MODE, COND and IRSIGN\&. IDIST and ISEED determine the generation
    of random numbers\&. CLATM1 is called by CLATMR to generate
    random test matrices for LAPACK programs\&.
.fi
.PP
 
.RE
.PP
\fBParameters\fP
.RS 4
\fIMODE\fP 
.PP
.nf
          MODE is INTEGER
           On entry describes how D is to be computed:
           MODE = 0 means do not change D\&.
           MODE = 1 sets D(1)=1 and D(2:N)=1\&.0/COND
           MODE = 2 sets D(1:N-1)=1 and D(N)=1\&.0/COND
           MODE = 3 sets D(I)=COND**(-(I-1)/(N-1))
           MODE = 4 sets D(i)=1 - (i-1)/(N-1)*(1 - 1/COND)
           MODE = 5 sets D to random numbers in the range
                    ( 1/COND , 1 ) such that their logarithms
                    are uniformly distributed\&.
           MODE = 6 set D to random numbers from same distribution
                    as the rest of the matrix\&.
           MODE < 0 has the same meaning as ABS(MODE), except that
              the order of the elements of D is reversed\&.
           Thus if MODE is positive, D has entries ranging from
              1 to 1/COND, if negative, from 1/COND to 1,
           Not modified\&.
.fi
.PP
.br
\fICOND\fP 
.PP
.nf
          COND is REAL
           On entry, used as described under MODE above\&.
           If used, it must be >= 1\&. Not modified\&.
.fi
.PP
.br
\fIIRSIGN\fP 
.PP
.nf
          IRSIGN is INTEGER
           On entry, if MODE neither -6, 0 nor 6, determines sign of
           entries of D
           0 => leave entries of D unchanged
           1 => multiply each entry of D by random complex number
                uniformly distributed with absolute value 1
.fi
.PP
.br
\fIIDIST\fP 
.PP
.nf
          IDIST is INTEGER
           On entry, IDIST specifies the type of distribution to be
           used to generate a random matrix \&.
           1 => real and imaginary parts each UNIFORM( 0, 1 )
           2 => real and imaginary parts each UNIFORM( -1, 1 )
           3 => real and imaginary parts each NORMAL( 0, 1 )
           4 => complex number uniform in DISK( 0, 1 )
           Not modified\&.
.fi
.PP
.br
\fIISEED\fP 
.PP
.nf
          ISEED is INTEGER array, dimension ( 4 )
           On entry ISEED specifies the seed of the random number
           generator\&. The random number generator uses a
           linear congruential sequence limited to small
           integers, and so should produce machine independent
           random numbers\&. The values of ISEED are changed on
           exit, and can be used in the next call to CLATM1
           to continue the same random number sequence\&.
           Changed on exit\&.
.fi
.PP
.br
\fID\fP 
.PP
.nf
          D is COMPLEX array, dimension ( N )
           Array to be computed according to MODE, COND and IRSIGN\&.
           May be changed on exit if MODE is nonzero\&.
.fi
.PP
.br
\fIN\fP 
.PP
.nf
          N is INTEGER
           Number of entries of D\&. Not modified\&.
.fi
.PP
.br
\fIINFO\fP 
.PP
.nf
          INFO is INTEGER
            0  => normal termination
           -1  => if MODE not in range -6 to 6
           -2  => if MODE neither -6, 0 nor 6, and
                  IRSIGN neither 0 nor 1
           -3  => if MODE neither -6, 0 nor 6 and COND less than 1
           -4  => if MODE equals 6 or -6 and IDIST not in range 1 to 4
           -7  => if N negative
.fi
.PP
 
.RE
.PP
\fBAuthor\fP
.RS 4
Univ\&. of Tennessee 
.PP
Univ\&. of California Berkeley 
.PP
Univ\&. of Colorado Denver 
.PP
NAG Ltd\&. 
.RE
.PP

.PP
Definition at line \fB136\fP of file \fBclatm1\&.f\fP\&.
.SH "Author"
.PP 
Generated automatically by Doxygen for LAPACK from the source code\&.