NAME

get_best_post_map - Finds the best post map between two matrices

SYNOPSIS

#include "n/n_fit.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_best_post_map
(
	Matrix **best_map_mpp,
	const Matrix *in_mp,
	const Matrix *out_mp
);

DESCRIPTION

This routine finds the matrix which, when used to post multiply the matrix pointed to by in_mp, gives the closest matrix in the least squares sense to the matrix pointed to by out_mp. Put differently, this routine calculates


  MIN { || AX - B ||   }, over all matrices, X
                    2

The map is put into the matrix pointed to by *best_map_mpp, which is created if it is NULL, resized if it is the wrong sized, and reused otherwise. The dimensions of *in_mp and *out_mp must be the same.

RETURNS

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

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER