NAME

get_random_matrix_2 - Gets a random matrix

SYNOPSIS

#include "m/m_matrix.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_random_matrix_2
(
	Matrix **target_mpp,
	int num_rows,
	int num_cols
);

DESCRIPTION

This routine gets a matrix of the specified dimensions, and fills it with random values between 0.0 and 1.0. The routine kjb_rand_2 is used. 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.

NOTE

This routine is exactly the same as get_random_matrix(), except that the alternative random stream kjb_rand_2() is used.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER