.TH "larnv" 3 "Wed Feb 7 2024 11:30:40" "Version 3.12.0" "LAPACK" \" -*- nroff -*-
.ad l
.nh
.SH NAME
larnv \- larnv: random vector
.SH SYNOPSIS
.br
.PP
.SS "Functions"

.in +1c
.ti -1c
.RI "subroutine \fBclarnv\fP (idist, iseed, n, x)"
.br
.RI "\fBCLARNV\fP returns a vector of random numbers from a uniform or normal distribution\&. "
.ti -1c
.RI "subroutine \fBdlarnv\fP (idist, iseed, n, x)"
.br
.RI "\fBDLARNV\fP returns a vector of random numbers from a uniform or normal distribution\&. "
.ti -1c
.RI "subroutine \fBslarnv\fP (idist, iseed, n, x)"
.br
.RI "\fBSLARNV\fP returns a vector of random numbers from a uniform or normal distribution\&. "
.ti -1c
.RI "subroutine \fBzlarnv\fP (idist, iseed, n, x)"
.br
.RI "\fBZLARNV\fP returns a vector of random numbers from a uniform or normal distribution\&. "
.in -1c
.SH "Detailed Description"
.PP 

.SH "Function Documentation"
.PP 
.SS "subroutine clarnv (integer idist, integer, dimension( 4 ) iseed, integer n, complex, dimension( * ) x)"

.PP
\fBCLARNV\fP returns a vector of random numbers from a uniform or normal distribution\&.  
.PP
\fBPurpose:\fP
.RS 4

.PP
.nf
 CLARNV returns a vector of n random complex numbers from a uniform or
 normal distribution\&.
.fi
.PP
 
.RE
.PP
\fBParameters\fP
.RS 4
\fIIDIST\fP 
.PP
.nf
          IDIST is INTEGER
          Specifies the distribution of the random numbers:
          = 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:  uniformly distributed on the disc abs(z) < 1
          = 5:  uniformly distributed on the circle abs(z) = 1
.fi
.PP
.br
\fIISEED\fP 
.PP
.nf
          ISEED is INTEGER array, dimension (4)
          On entry, the seed of the random number generator; the array
          elements must be between 0 and 4095, and ISEED(4) must be
          odd\&.
          On exit, the seed is updated\&.
.fi
.PP
.br
\fIN\fP 
.PP
.nf
          N is INTEGER
          The number of random numbers to be generated\&.
.fi
.PP
.br
\fIX\fP 
.PP
.nf
          X is COMPLEX array, dimension (N)
          The generated random numbers\&.
.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
\fBFurther Details:\fP
.RS 4

.PP
.nf
  This routine calls the auxiliary routine SLARUV to generate random
  real numbers from a uniform (0,1) distribution, in batches of up to
  128 using vectorisable code\&. The Box-Muller method is used to
  transform numbers from a uniform to a normal distribution\&.
.fi
.PP
 
.RE
.PP

.SS "subroutine dlarnv (integer idist, integer, dimension( 4 ) iseed, integer n, double precision, dimension( * ) x)"

.PP
\fBDLARNV\fP returns a vector of random numbers from a uniform or normal distribution\&.  
.PP
\fBPurpose:\fP
.RS 4

.PP
.nf
 DLARNV returns a vector of n random real numbers from a uniform or
 normal distribution\&.
.fi
.PP
 
.RE
.PP
\fBParameters\fP
.RS 4
\fIIDIST\fP 
.PP
.nf
          IDIST is INTEGER
          Specifies the distribution of the random numbers:
          = 1:  uniform (0,1)
          = 2:  uniform (-1,1)
          = 3:  normal (0,1)
.fi
.PP
.br
\fIISEED\fP 
.PP
.nf
          ISEED is INTEGER array, dimension (4)
          On entry, the seed of the random number generator; the array
          elements must be between 0 and 4095, and ISEED(4) must be
          odd\&.
          On exit, the seed is updated\&.
.fi
.PP
.br
\fIN\fP 
.PP
.nf
          N is INTEGER
          The number of random numbers to be generated\&.
.fi
.PP
.br
\fIX\fP 
.PP
.nf
          X is DOUBLE PRECISION array, dimension (N)
          The generated random numbers\&.
.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
\fBFurther Details:\fP
.RS 4

.PP
.nf
  This routine calls the auxiliary routine DLARUV to generate random
  real numbers from a uniform (0,1) distribution, in batches of up to
  128 using vectorisable code\&. The Box-Muller method is used to
  transform numbers from a uniform to a normal distribution\&.
.fi
.PP
 
.RE
.PP

.SS "subroutine slarnv (integer idist, integer, dimension( 4 ) iseed, integer n, real, dimension( * ) x)"

.PP
\fBSLARNV\fP returns a vector of random numbers from a uniform or normal distribution\&.  
.PP
\fBPurpose:\fP
.RS 4

.PP
.nf
 SLARNV returns a vector of n random real numbers from a uniform or
 normal distribution\&.
.fi
.PP
 
.RE
.PP
\fBParameters\fP
.RS 4
\fIIDIST\fP 
.PP
.nf
          IDIST is INTEGER
          Specifies the distribution of the random numbers:
          = 1:  uniform (0,1)
          = 2:  uniform (-1,1)
          = 3:  normal (0,1)
.fi
.PP
.br
\fIISEED\fP 
.PP
.nf
          ISEED is INTEGER array, dimension (4)
          On entry, the seed of the random number generator; the array
          elements must be between 0 and 4095, and ISEED(4) must be
          odd\&.
          On exit, the seed is updated\&.
.fi
.PP
.br
\fIN\fP 
.PP
.nf
          N is INTEGER
          The number of random numbers to be generated\&.
.fi
.PP
.br
\fIX\fP 
.PP
.nf
          X is REAL array, dimension (N)
          The generated random numbers\&.
.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
\fBFurther Details:\fP
.RS 4

.PP
.nf
  This routine calls the auxiliary routine SLARUV to generate random
  real numbers from a uniform (0,1) distribution, in batches of up to
  128 using vectorisable code\&. The Box-Muller method is used to
  transform numbers from a uniform to a normal distribution\&.
.fi
.PP
 
.RE
.PP

.SS "subroutine zlarnv (integer idist, integer, dimension( 4 ) iseed, integer n, complex*16, dimension( * ) x)"

.PP
\fBZLARNV\fP returns a vector of random numbers from a uniform or normal distribution\&.  
.PP
\fBPurpose:\fP
.RS 4

.PP
.nf
 ZLARNV returns a vector of n random complex numbers from a uniform or
 normal distribution\&.
.fi
.PP
 
.RE
.PP
\fBParameters\fP
.RS 4
\fIIDIST\fP 
.PP
.nf
          IDIST is INTEGER
          Specifies the distribution of the random numbers:
          = 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:  uniformly distributed on the disc abs(z) < 1
          = 5:  uniformly distributed on the circle abs(z) = 1
.fi
.PP
.br
\fIISEED\fP 
.PP
.nf
          ISEED is INTEGER array, dimension (4)
          On entry, the seed of the random number generator; the array
          elements must be between 0 and 4095, and ISEED(4) must be
          odd\&.
          On exit, the seed is updated\&.
.fi
.PP
.br
\fIN\fP 
.PP
.nf
          N is INTEGER
          The number of random numbers to be generated\&.
.fi
.PP
.br
\fIX\fP 
.PP
.nf
          X is COMPLEX*16 array, dimension (N)
          The generated random numbers\&.
.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
\fBFurther Details:\fP
.RS 4

.PP
.nf
  This routine calls the auxiliary routine DLARUV to generate random
  real numbers from a uniform (0,1) distribution, in batches of up to
  128 using vectorisable code\&. The Box-Muller method is used to
  transform numbers from a uniform to a normal distribution\&.
.fi
.PP
 
.RE
.PP

.SH "Author"
.PP 
Generated automatically by Doxygen for LAPACK from the source code\&.