Jiří Václavík > Math-Random-SkewNormal-0.01 > Math::Random::SkewNormal

Download:
Math-Random-SkewNormal-0.01.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  1
View/Report Bugs
Module Version: 0.01   Source  

NAME ^

Math::Random::SkewNormal - Handy, easy-to-use Skew-Normal random number generator

SYNOPSIS ^

  use Math::Random::SkewNormal;
  
  $skewness = 1;
  $delta    = [0, 0];
  $omega    = [[1, 0], [0, 1]];

  # following functions generate realizations:
  generate_sn($skewness)            # SkewNormal(0,1,$skewness)
  generate_sn_multi($delta, $omega) # SkewNormal_n($delta, $omega)

DESCRIPTION ^

This module transforms uniformly spaced random variable realizations into realizations that follow the Skew-Normal (SN) Probability Density Function (PDF).

We accept following definition of the Skew-Normal Distribution:

1-dimensional SN is determined by PDF: f(x,a) = 2 phi(x) Phi(a x), where phi is the PDF and Phi is the CDF of Normal distribution
Let X = (X_0, ..., X_k) follows distribution N_k+1 (0, Omega*), where Omega* is the matrix of the form:
       [   1   delta ]
       [ delta Omega ]

Omega is a matrix and delta is a vector. Then (X_1, ..., X_n)|(X_0 > 0) follows n-dimensional Skew Normal distribution.

ALGORITHM ^

We use following algorithms:

FUNCTIONS ^

generate_sn

Returns realization of SN(0,1, a), where a is the only parameter. The meaning of a is "skewness" (see definition above).

generate_sn_multi

Returns realization of centralized n-dimensional Skew-Normal distribution.

1st parameter is correlation matrix of the form [[row_1], [row_2], ..., [row_n]], for example [[1, 0], [0, 1]] for 2-dimensional unit matrix.

2nd parameter is delta vector of the form [delta_1, ..., delta_n], e. g. [0, 1].

SEE ALSO ^

Math::Random, Math::Random::Cauchy,

The examples in examples/ subdirectory of this distribution contains example of generated data with histogram.

The scripts in bin/ directory of this distribution contains tools for generating realizations on command line.

AUTHOR ^

Jiri Vaclavik, <my name dot my last name at gmail dot com>

COPYRIGHT AND LICENSE ^

Copyright (C) 2011 by Jiri Vaclavik

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: