NAME

get_general_sv_gauss_random_matrix - Gets a general single variate Gaussian random matrix

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_general_sv_gauss_random_matrix
(
	Matrix **mpp,
	int num_rows,
	int num_cols,
	double mean,
	double stdev
);

DESCRIPTION

This routine gets a matrix of the specified dimensions, and fills it with gaussian random values with the specified mean and standard deviation. The routine kjb_rand() is used as the random number source (via the gauss_rand() function). The first argument is the adress of the target matrix. If the target matrix itself is null, then a matrix of the appropriate size is created. If the target matrix 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