NAME

copy_matrix_to_int_matrix - Copies a matrix to an integer matrix

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 copy_matrix_to_int_matrix
(
	Int_matrix **target_mpp,
	const Matrix *source_mp
);

DESCRIPTION

This routine copies the matrix source_mp to the integer matrix pointed to by target_mpp. It is thus used mostly for caching conversion results for performance. If the matrix pointed to by target_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 matrix becomes NULL also, and any storage associated with it is freed.

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

Kobus Barnard

DOCUMENTER