NAME

get_matrix_vector_from_matrix_2 - Constructs a matrix from a matrix vector

SYNOPSIS

#include "m/m_mat_vector.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_matrix_vector_from_matrix_2
(
	Matrix_vector **mvpp,
	const Matrix *mp,
	int block_size
);

DESCRIPTION

This routine takes a matrix of N rows and puts each block_size rows into a matrix_vector of N/block_size matrices, each one having block_size rows. If there are rows left over (i.e., the number of rows in the matrix is not divisible by block_size, then the extra rows are ignored. The first argument is the adress of the target matrix vector. If the target matrix vector is null, then a matrix vector of the appropriate size is created. If the target matrix vector is the wrong size, it is resized. Finally, if it is the right size, then the storage is recycled, as is. If the matrix mp is NULL, then the target matrix beomes NULL as well.

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