NAME

boxmuller

VERSION

0.24 -- 2018-07-03

SYNOPSIS

boxmuller [-m mean] [-v variance | -d standard_deviation] [-g how_many_you_want] [-. digits_after_decimal_point] [-s random_seed] [-L(log normal)] [-@ seconds] [-1] [-:]

boxmuller [--help [ja|en] [opt] [nopod]] [--version]

DESCRIPTION

Generates Gaussian random variables by Box-Muller method. The used random seed and the sums of the generated numbers and the square of them are also provided to STDERR.

OPTION

-m N

Population Mean (average). Default value is 0.

-d N

Population Standard Deviation. Default value is 1.

-v N

Population Variance. Default value is 1. If -d is given, -v would be nullified.

-. N

The digits to be shown after the decimal point. Without this specification 14 digits after the decimal point may be shown.

-g N

How many numbers to be produced. Default value is 6. "Inf" (Infinity) can be given.

-s N

Random seed specification. The residual divided by 2**32 is essential.

-L

Outputs variables from the log normal distribution instead of the normal distribution.

-1

Only output the random number without other secondary information.

-:

Attaches serial number beginning from 1.

-@ N

Waiting time in seconds for each output line, that can be spedicifed 6 digits after the decimal points (microsecond).

--help

Print this online help manual of this command "boxmuller". Similar to "perldoc `which [-t] boxmuller` ".

--help opt

Only shows the option helps. It is easy to read when you are in very necessary.

--help ja

Shows Japanese online help manual.

--help nopod

Print this online manual using the code insdide this program without using the function of Perl POD.

--version

Version information output.

EXAMPLE

boxmuller

# Generates some random numbers from the stardard normal distribution.

boxmuller -m 10 -d 2 -g 12

# Generates 12 random numbers from the normal distribution with the population mean 10, the population variance 2.

boxmuller -L -m 3 -d 2

# Generates Log normal distribution. In this case the popular median is exp(3) = 20.09.

boxmuller -g Inf -@ 0.3

# Generate each random number every 0.3 seconds.

AUTHOR

Toshiyuki Shimono bin4tsv@gmail.com

HISTORY

This program has been made since 2016-07-07 (Thu) as a part of TSV hacking toolset for table data.