The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
App-boxmuller-0.24
River stage zero No dependents
/ App::boxmuller

NAME

App::boxmuller - Provides the command which produces Gaussian distributed random numbers, as well as log-normal distributed numbers.

VERSION

Version 0.24

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.

EXPORT

  Nothing would be exported.

BUGS

Please report any bugs or feature requests to bug-app-boxmuller at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=App-boxmuller. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc App::boxmuller

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2018 "Toshiyuki Shimono".

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.