NAME

find_in_matrix - Finds elements in a matrix.

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
(
	Int_matrix **elems,
	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, *elems at i,j is 1 if and only if predicate(mp, i, j, ...) returns 1. *elems is an binary matrix whose elements are 1 whenever the said condition is met. *elems can be used with some of the copy with selection routines. 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