NAME

get_gauss_random_vector - Gets a Gaussian random vector

SYNOPSIS

#include "sample/sample_gauss.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int get_gauss_random_vector
(
	Vector **vp,
	int length
);

DESCRIPTION

This routine gets a matrix of the specified length, and fills it with Gaussian random values with mean 0.0 and variance 1.0. The routine kjb_rand() is used for the random stream. The first argument is the adress of the target vector. If the target vector itself is null, then a vector of the appropriate size is created. If the target vector is the wrong size, it is resized. Finally, if it is the right size, then the storage is recycled, as is.

RETURNS

NO_ERROR on success and ERROR on failure This routine will only fail if storage allocation fails.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER