The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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:

  • Box-Muller transformation; for generation Normal realizations

  • Choleski's decomposition; for inverting matrices

  • A lemma mentioned e. g. in article from A. Azzalini: The skew-normal distribution and related multivariate families; for generating Skew-Normal realizations

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.