NAME

find_in_matrix_as_vector - Finds elements in matrix (treated as 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 find_in_matrix_as_vector
(
	Int_vector **indices,
	const Matrix *mp,
	int (*predicate)(const Matrix *,int,int,void *),
	void *params
);

DESCRIPTION

This routine searches the matrix mp for elements which return 1 on the given predicate. That is, index k is inserted in *indices if and only if predicate(mp, i, j ...) returns 1, where k = j*mp->num_rows + i. In other words, matrix mp is treated as the vector formed by stacking its columns. *indices is an integer vector that holds element indices which fulfill the mentioned condition. *indices can then be used as input to the appropriate copy function. If *indices 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