view release on metacpan or  search on metacpan

lib/App/boxmuller.pm  view on Meta::CPAN

package App::boxmuller;

use 5.006;
use strict;
use warnings;

=head1 NAME

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

=head1 VERSION

Version 0.24

=cut

our $VERSION = '0.24';

=head1 SYNOPSIS

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

boxmuller [B<--help> [ja|en] [opt] [nopod]] [B<--version>]

=head1 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.

=head1 OPTION

=over 4

=item -m N 

Population B<Mean (average)>. Default value is 0.


=item -d N 

Population B<Standard Deviation>. Default value is 1.

=item -v N 

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

=item -. N 

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

=item -g N 

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

=item -s N 

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

=item -L 

Outputs variables from the B<log normal distribution> instead of the normal distribution.

=item -1

Only output the random number without other secondary information.

=item -: 

Attaches serial number beginning from 1. 

=item -@ N 

Waiting time in B<seconds> for each output line, that can be spedicifed 6 digits after the decimal points