NAME

random_split_matrix_by_rows - Splits a matrix row-wise

SYNOPSIS

#include "m/m_mat_basic.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 random_split_matrix_by_rows
(
	Matrix **target_1_mpp,
	Matrix **target_2_mpp,
	const Matrix *source_mp,
	double fraction
);

DESCRIPTION

This routine splits the source matrix into two matrices pointed to by target_1_mpp and target_2_mpp, putting a randomly selected fraction "fraction" into the first matrix and the rest into the second matrix. If the matrix pointed to by target_1_mpp or target_2_mpp is NULL, then a matrix of the appropriate size is created. If it exists, but is the wrong size, then it is recycled. Otherwise, the storage is recycled. If the source matrix is NULL, then the target matrices becomes NULL also, and any storage associated with it is freed.

RETURNS

If the routine fails (due to storage allocation), then ERROR is returned with and error message being set. Otherwise NO_ERROR is returned.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

split_matrix_by_rows , get_matrix_transpose , create_matrix_copy , copy_matrix , select_matrix_cols , copy_matrix_block , ow_copy_matrix_block , copy_matrix_block_2 , ow_copy_matrix_block_2 , ow_copy_matrix , ow_copy_matrix_with_col_selection , copy_int_matrix_to_matrix , copy_matrix_to_int_matrix , get_random_matrix_row , get_matrix_row , ow_get_matrix_row , remove_matrix_row , put_matrix_row , copy_matrix_row , get_random_matrix_col , get_matrix_col , remove_matrix_col , put_matrix_col , copy_matrix_col , insert_zero_row_in_matrix , insert_zero_col_in_matrix , vector_is_matrix_row , stack_matrix_rows , unstack_matrix_rows , randomize_matrix_rows , pad_matrix_by_extending , get_matrix_trace , is_matrix_diagonal , nonnan_matrix