PseudoRandomStream (math-base 1.0.0 API)

All Known Subinterfaces:

PseudoRandom, SplittablePseudoRandom

All Known Implementing Classes:

AbstractRng64, Interleaved4Stc64, Lcg64Xor1024Mix, MersenneTwister64, Sfc64, SplitMix64, Stc64, XorShift1024Star, XorShift128Plus, XorShift64Star, XorShiftRot256PlusPlus, XorShiftRot256StarStar
```
public interface PseudoRandomStream
```
Each method that returns a stream produces a stream of values each of which is chosen in the same manner as for a method that returns a single pseudorandomly chosen value.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`DoubleStream`	`beta(double alpha, double beta)` Returns an effectively unlimited stream of pseudorandomly chosen Beta-distributed variates with shape parameters `alpha` and `beta`.
`DoubleStream`	`beta(long streamSize, double alpha, double beta)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen Beta-distributed variates with shape parameters `alpha` and `beta`.
`DoubleStream`	`cauchy(double location, double scale)` Returns an effectively unlimited stream of pseudorandomly chosen Cauchy-distributed variates with location parameter `location` and scale parameter `scale`.
`DoubleStream`	`cauchy(long streamSize, double location, double scale)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen Cauchy-distributed variates with location parameter `location` and scale parameter `scale`.
`DoubleStream`	`chiSquare(double k)` Returns an effectively unlimited stream of pseudorandomly chosen Chi-squared distributed variates with `k` degrees of freedom.
`DoubleStream`	`chiSquare(long streamSize, double k)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen Chi-squared distributed variates with `k` degrees of freedom.
`DoubleStream`	`doubles()` Returns an effectively unlimited stream of pseudorandomly chosen `double` values.
`DoubleStream`	`doubles(double min, double max)` Returns an effectively unlimited stream of pseudorandomly chosen `double` values, where each value is between the specified min (inclusive) and the specified max (inclusive).
`DoubleStream`	`doubles(long streamSize)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen `double` values.
`DoubleStream`	`doubles(long streamSize, double min, double max)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen `double` values, where each value is between the specified min (inclusive) and the specified max (inclusive).
`DoubleStream`	`exponential(double lambda)` Returns an effectively unlimited stream of pseudorandomly chosen exponentially distributed variates with rate parameter `lambda`.
`DoubleStream`	`exponential(long streamSize, double lambda)` Returns a stream producing the given `streamSize` number of exponentially distributed variates with rate parameter `lambda`.
`DoubleStream`	`gamma(double k, double theta)` Returns an effectively unlimited stream of pseudorandomly chosen Gamma-distributed variates with shape parameter `k` and scale parameter `theta`.
`DoubleStream`	`gamma(long streamSize, double k, double theta)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen Gamma-distributed variates with shape parameter `k` and scale parameter `theta`.
`IntStream`	`ints()` Returns an effectively unlimited stream of pseudorandomly chosen `int` values.
`IntStream`	`ints(int min, int max)` Returns an effectively unlimited stream of pseudorandomly chosen `int` values, where each value is between the specified min (inclusive) and the specified max (inclusive).
`IntStream`	`ints(long streamSize)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen `int` values.
`IntStream`	`ints(long streamSize, int min, int max)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen `int` values, where each value is between the specified min (inclusive) and the specified max (inclusive).
`DoubleStream`	`logNormal(double mu, double sigma)` Returns an effectively unlimited stream of pseudorandomly chosen Log-normal variates whose natural logarithm has expectation `mu` and standard deviation `sigma`.
`DoubleStream`	`logNormal(long streamSize, double mu, double sigma)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen Log-normal variates whose natural logarithm has expectation `mu` and standard deviation `sigma`.
`LongStream`	`longs()` Returns an effectively unlimited stream of pseudorandomly chosen `long` values.
`LongStream`	`longs(long streamSize)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen `long` values.
`LongStream`	`longs(long min, long max)` Returns an effectively unlimited stream of pseudorandomly chosen `long` values, where each value is between the specified min (inclusive) and the specified max (inclusive).
`LongStream`	`longs(long streamSize, long min, long max)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen `long` values, where each value is between the specified min (inclusive) and the specified max (inclusive).
`DoubleStream`	`normal(double mu, double sigma)` Returns an effectively unlimited stream of pseudorandomly chosen normal variates with expectation `mu` and standard deviation `sigma`.
`DoubleStream`	`normal(long streamSize, double mu, double sigma)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen normal variates with expectation `mu` and standard deviation `sigma`.
`DoubleStream`	`studentT(double df)` Returns an effectively unlimited stream of pseudorandomly chosen StudentT distributed variates with `df` degrees of freedom.
`DoubleStream`	`studentT(long streamSize, double df)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen StudentT distributed variates with `df` degrees of freedom.
`DoubleStream`	`weibull(double scale, double shape)` Returns an effectively unlimited stream of pseudorandomly chosen Weibull distributed variates with parameters `scale` and `shape`.
`DoubleStream`	`weibull(long streamSize, double scale, double shape)` Returns a stream producing the given `streamSize` number of pseudorandomly chosen Weibull distributed variates with parameters `scale` and `shape`.

- Method Detail
  - ints
```
IntStream ints()
```
    Returns an effectively unlimited stream of pseudorandomly chosen int values.
    
    Returns:
    
    a stream of pseudorandomly chosen int values
  - ints
```
IntStream ints(long streamSize)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen int values.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    Returns:
    
    a stream of pseudorandomly chosen int values
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero
  - ints
```
IntStream ints(long streamSize,
               int min,
               int max)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen int values, where each value is between the specified min (inclusive) and the specified max (inclusive).
    
    Parameters:
    
    streamSize - the number of values to generate
    
    min - the smallest value that can be produced
    
    max - the largest value that can be produced
    
    Returns:
    
    a stream of pseudorandomly chosen int values, each between the specified min (inclusive) and the specified max (inclusive)
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or min is greater than max
  - ints
```
IntStream ints(int min,
               int max)
```
    Returns an effectively unlimited stream of pseudorandomly chosen int values, where each value is between the specified min (inclusive) and the specified max (inclusive).
    
    Parameters:
    
    min - the smallest value that can be produced
    
    max - the largest value that can be produced
    
    Returns:
    
    a stream of pseudorandomly chosen int values, each between the specified min (inclusive) and the specified max (inclusive)
    
    Throws:
    
    IllegalArgumentException - if min is greater than max
  - longs
```
LongStream longs()
```
    Returns an effectively unlimited stream of pseudorandomly chosen long values.
    
    Returns:
    
    a stream of pseudorandomly chosen long values
  - longs
```
LongStream longs(long streamSize)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen long values.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    Returns:
    
    a stream of pseudorandomly chosen long values
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero
  - longs
```
LongStream longs(long streamSize,
                 long min,
                 long max)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen long values, where each value is between the specified min (inclusive) and the specified max (inclusive).
    
    Parameters:
    
    streamSize - the number of values to generate
    
    min - the smallest value that can be produced
    
    max - the largest value that can be produced
    
    Returns:
    
    a stream of pseudorandomly chosen long values, each between the specified min (inclusive) and the specified max (inclusive)
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or min is greater than max
  - longs
```
LongStream longs(long min,
                 long max)
```
    Returns an effectively unlimited stream of pseudorandomly chosen long values, where each value is between the specified min (inclusive) and the specified max (inclusive).
    
    Parameters:
    
    min - the smallest value that can be produced
    
    max - the largest value that can be produced
    
    Returns:
    
    a stream of pseudorandomly chosen long values, each between the specified min (inclusive) and the specified max (inclusive)
    
    Throws:
    
    IllegalArgumentException - if min is greater than max
  - doubles
```
DoubleStream doubles()
```
    Returns an effectively unlimited stream of pseudorandomly chosen double values.
    
    Returns:
    
    a stream of pseudorandomly chosen double values
  - doubles
```
DoubleStream doubles(long streamSize)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen double values.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    Returns:
    
    a stream of pseudorandomly chosen double values
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero
  - doubles
```
DoubleStream doubles(long streamSize,
                     double min,
                     double max)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen double values, where each value is between the specified min (inclusive) and the specified max (inclusive).
    
    Parameters:
    
    streamSize - the number of values to generate
    
    min - the smallest value that can be produced
    
    max - the largest value that can be produced
    
    Returns:
    
    a stream of pseudorandomly chosen double values, each between the specified min and the specified max
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or min is not finite, or max is not finite, or min is greater than max
  - doubles
```
DoubleStream doubles(double min,
                     double max)
```
    Returns an effectively unlimited stream of pseudorandomly chosen double values, where each value is between the specified min (inclusive) and the specified max (inclusive).
    
    Parameters:
    
    min - the smallest value that can be produced
    
    max - the largest value that can be produced
    
    Returns:
    
    a stream of pseudorandomly chosen double values, each between the specified min and the specified max
    
    Throws:
    
    IllegalArgumentException - if min is not finite, or max is not finite, or min is greater than max
  - normal
```
DoubleStream normal(double mu,
                    double sigma)
```
    Returns an effectively unlimited stream of pseudorandomly chosen normal variates with expectation mu and standard deviation sigma.
    
    Parameters:
    
    mu - the expectation of the normal variate
    
    sigma - the standard deviation of the normal variate
    
    Returns:
    
    a stream of pseudorandomly chosen normal variates with the specified expecation and standard deviation
    
    Throws:
    
    IllegalArgumentException - if sigma is not greater than zero
  - normal
```
DoubleStream normal(long streamSize,
                    double mu,
                    double sigma)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen normal variates with expectation mu and standard deviation sigma.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    mu - the expectation of the normal variate
    
    sigma - the standard deviation of the normal variate
    
    Returns:
    
    a stream of pseudorandomly chosen normal variates with the specified expecation and standard deviation
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or sigma is not greater than zero
  - cauchy
```
DoubleStream cauchy(double location,
                    double scale)
```
    Returns an effectively unlimited stream of pseudorandomly chosen Cauchy-distributed variates with location parameter location and scale parameter scale.
    
    Parameters:
    
    location - the location parameter of the Cauchy distribution
    
    scale - the scale parameter of the Cauchy distribution
    
    Returns:
    
    a stream of pseudorandomly chosen Cauchy-distributed variates with the specified location and scale
    
    Throws:
    
    IllegalArgumentException - if scale is not greater than zero
  - cauchy
```
DoubleStream cauchy(long streamSize,
                    double location,
                    double scale)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen Cauchy-distributed variates with location parameter location and scale parameter scale.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    location - the location parameter of the Cauchy distribution
    
    scale - the scale parameter of the Cauchy distribution
    
    Returns:
    
    a stream of pseudorandomly chosen Cauchy-distributed variates with the specified location and scale
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or scale is not greater than zero
  - exponential
```
DoubleStream exponential(double lambda)
```
    Returns an effectively unlimited stream of pseudorandomly chosen exponentially distributed variates with rate parameter lambda.
    
    Parameters:
    
    lambda - the rate parameter lambda of the Exponential distribution
    
    Returns:
    
    a stream of pseudorandomly chosen exponentially distributed variates with parameter lambda
    
    Throws:
    
    IllegalArgumentException - if lambda is not greater than zero
  - exponential
```
DoubleStream exponential(long streamSize,
                         double lambda)
```
    Returns a stream producing the given streamSize number of exponentially distributed variates with rate parameter lambda.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    lambda - the rate parameter lambda of the Exponential distribution
    
    Returns:
    
    a stream of pseudorandomly chosen exponentially distributed variates with parameter lambda
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or lambda is not greater than zero
  - gamma
```
DoubleStream gamma(double k,
                   double theta)
```
    Returns an effectively unlimited stream of pseudorandomly chosen Gamma-distributed variates with shape parameter k and scale parameter theta.
    
    Parameters:
    
    k - the shape parameter of the Gamma distribution
    
    theta - the scale parameter of the Gamma distribution
    
    Returns:
    
    a stream of pseudorandomly chosen Gamma-distributed variates with with shape parameter k and scale parameter theta
    
    Throws:
    
    IllegalArgumentException - if k is not greater than zero, or theta is not greater than zero
  - gamma
```
DoubleStream gamma(long streamSize,
                   double k,
                   double theta)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen Gamma-distributed variates with shape parameter k and scale parameter theta.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    k - the shape parameter of the Gamma distribution
    
    theta - the scale parameter of the Gamma distribution
    
    Returns:
    
    a stream of pseudorandomly chosen Gamma-distributed variates with with shape parameter k and scale parameter theta
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or k is not greater than zero, or theta is not greater than zero
  - beta
```
DoubleStream beta(double alpha,
                  double beta)
```
    Returns an effectively unlimited stream of pseudorandomly chosen Beta-distributed variates with shape parameters alpha and beta.
    
    Parameters:
    
    alpha - the shape parameter alpha of the Beta distribution
    
    beta - the shape parameter beta of the Beta distribution
    
    Returns:
    
    a stream of pseudorandomly chosen Beta-distributed variates with shape parameters alpha and beta
    
    Throws:
    
    IllegalArgumentException - if alpha is not greater than zero, or beta is not greater than zero
  - beta
```
DoubleStream beta(long streamSize,
                  double alpha,
                  double beta)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen Beta-distributed variates with shape parameters alpha and beta.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    alpha - the shape parameter alpha of the Beta distribution
    
    beta - the shape parameter beta of the Beta distribution
    
    Returns:
    
    a stream of pseudorandomly chosen Beta-distributed variates with shape parameters alpha and beta
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or alpha is not greater than zero, or beta is not greater than zero
  - chiSquare
```
DoubleStream chiSquare(double k)
```
    Returns an effectively unlimited stream of pseudorandomly chosen Chi-squared distributed variates with k degrees of freedom.
    
    Parameters:
    
    k - the number of degrees of freedom
    
    Returns:
    
    a stream of pseudorandomly chosen Chi-squared distributed variates with k degrees of freedom
    
    Throws:
    
    IllegalArgumentException - if k is not greater than zero
  - chiSquare
```
DoubleStream chiSquare(long streamSize,
                       double k)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen Chi-squared distributed variates with k degrees of freedom.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    k - the number of degrees of freedom
    
    Returns:
    
    a stream of pseudorandomly chosen Chi-squared distributed variates with k degrees of freedom
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or k is not greater than zero
  - logNormal
```
DoubleStream logNormal(double mu,
                       double sigma)
```
    Returns an effectively unlimited stream of pseudorandomly chosen Log-normal variates whose natural logarithm has expectation mu and standard deviation sigma.
    
    Parameters:
    
    mu - the expectation of the natural logarithm of the Log-normal variate
    
    sigma - the standard deviation of the natural logarithm of the Log-normal variate
    
    Returns:
    
    a stream of pseudorandomly chosen Log-normal variates whose natural logarithm has the specified expecation and standard deviation
    
    Throws:
    
    IllegalArgumentException - if sigma is not greater than zero
  - logNormal
```
DoubleStream logNormal(long streamSize,
                       double mu,
                       double sigma)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen Log-normal variates whose natural logarithm has expectation mu and standard deviation sigma.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    mu - the expectation of the natural logarithm of the Log-normal variate
    
    sigma - the standard deviation of the natural logarithm of the Log-normal variate
    
    Returns:
    
    a stream of pseudorandomly chosen Log-normal variates whose natural logarithm has the specified expecation and standard deviation
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or sigma is not greater than zero
  - studentT
```
DoubleStream studentT(double df)
```
    Returns an effectively unlimited stream of pseudorandomly chosen StudentT distributed variates with df degrees of freedom.
    
    Parameters:
    
    df - degrees of freedom
    
    Returns:
    
    a stream of pseudorandomly chosen StudentT distributed variates with df degrees of freedom
    
    Throws:
    
    IllegalArgumentException - if df is not greater than zero
  - studentT
```
DoubleStream studentT(long streamSize,
                      double df)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen StudentT distributed variates with df degrees of freedom.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    df - degrees of freedom
    
    Returns:
    
    a stream of pseudorandomly chosen StudentT distributed variates with df degrees of freedom
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or df is not greater than zero
  - weibull
```
DoubleStream weibull(double scale,
                     double shape)
```
    Returns an effectively unlimited stream of pseudorandomly chosen Weibull distributed variates with parameters scale and shape.
    
    Parameters:
    
    scale - the scale parameter of the Weibull distribution
    
    shape - the shape parameter of the Weibull distribution
    
    Returns:
    
    a stream of pseudorandomly chosen Weibull distributed variates with parameters scale and shape
    
    Throws:
    
    IllegalArgumentException - if scale and shape are not greater than zero
  - weibull
```
DoubleStream weibull(long streamSize,
                     double scale,
                     double shape)
```
    Returns a stream producing the given streamSize number of pseudorandomly chosen Weibull distributed variates with parameters scale and shape.
    
    Parameters:
    
    streamSize - the number of values to generate
    
    scale - the scale parameter of the Weibull distribution
    
    shape - the shape parameter of the Weibull distribution
    
    Returns:
    
    a stream of pseudorandomly chosen Weibull distributed variates with parameters scale and shape
    
    Throws:
    
    IllegalArgumentException - if streamSize is less than zero, or scale and shape are not greater than zero

Interface PseudoRandomStream

Method Summary

Method Detail

ints

ints

ints

ints

longs

longs

longs

longs

doubles

doubles

doubles

doubles

normal

normal

cauchy

cauchy

exponential

exponential

gamma

gamma

beta

beta

chiSquare

chiSquare

logNormal

logNormal

studentT

studentT

weibull

weibull