NAME

fourier_convolve_image - Convolve an image with an arbitrary mask by using fourier transform.

SYNOPSIS

#include "m2/m2_ncc.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 fourier_convolve_image
(
	KJB_image **out_ipp,
	const KJB_image *in_ip,
	const Matrix *mask_mp
);

DESCRIPTION

This routine use the fourier transform method to convolve the image pointed to by in_mp with the mask mask_mp, putting the result into *out_ipp. When the size of the mask image is large, the routine is highly recommended when the image size is large. Unlike the routine 'convolve_image', 'fourier_convolve_image' deals with the boundary by padding 0, rather than by wrapping around the 'in_image'.

RETURNS

NO_ERROR on sucess and ERROR on failure.

DISCLAIMER

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

AUTHOR

Kyle Sime, Quanfu Fan and Kobus Barnard

DOCUMENTER

Kyle Simek, Quanfu Fan and Kobus Barnard