NAME

get_matrix_as_vector_with_selection - Copies selected elements of a matrix (treated as a vector).

SYNOPSIS

#include "m/m_find.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_as_vector_with_selection
(
	Vector **target_vpp,
	const Matrix *source_mp,
	const Int_vector *elems
);

DESCRIPTION

This routine copies the elements (specified in the integer vector elems) of matrix source_mp into vector *target_vpp. The Matrix is treated as a vector, where the columns are concatenated. Naturally, every element of elems must be between 0 and (source_mp->num_rows - 1)*(source_mp->num_cols - 1), inclusive. If elems is NULL, the whole matrix is copied into *target_vpp. If *target_vpp is NULL, it is created; if it is the wrong size, it is resized; finally, if it is the right size, the storage is recycled, as is.

RETURNS

NO_ERROR on success, and ERROR on failure, with an error being set.

DISCLAIMER

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

AUTHOR

Ernesto Brau

DOCUMENTER