NAME

rms_matrix_difference - Returns the RMS difference between two matrices

SYNOPSIS

#include "m/m_mat_metric.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 


double rms_matrix_difference
(
	const Matrix *first_mp,
	const Matrix *second_mp
);

DESCRIPTION

This routine calculates the RMS difference of all the elements of two dimension compatable matrices. This in turn is simply the Frobenius difference normalized by the square root of the number of elements. To support test program, if both matrices are NULL, the different is zero.

RETURNS

The distance between the two matrices or a negative number if there is an error (not very likely--currently impossible). Note that sending in matrices with incompatable dimensions is regarded as a bug. (See set_bug(3)).

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER