NAME

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 split_matrix_by_rows
(
	Matrix **target_1_mpp,
	Matrix **target_2_mpp,
	const Matrix *source_mp,
	const Int_vector *index_list_vp
);

DESCRIPTION

This routine splits the source matrix into two matrices pointed to by target_1_mpp and target_2_mpp. 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. The parameter index_list_vp is a list of row numbers in source_mp that should be copied to target_1_mpp. The remainder go into target_2_mpp.

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

Ranjini Swaminathan

DOCUMENTER