NAME

get_2D_gaussian_dx_mask - Constructs a 2D Gaussian mask with partial derivative in the x-direction.

SYNOPSIS

#include "m/m_convolve.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_2D_gaussian_dx_mask
(
	Matrix **mask_mpp,
	int num_rows,
	int num_cols,
	double row_sigma,
	double col_sigma
);

PARAMETERS

Matrix **mask_mpp: Output gaussian smoothing mask.
int num_rows: Number of rows in mask.
int num_cols: Number of cols in mask.
double row_sigma: Standard deviation in row direction in bin units.
double col_sigma: Standard deviation in column direction bin units.

DESCRIPTION

This routine constructs a 2D Gaussian mask combined with a partial derivative in the x-direction, putting the result into *out_mpp. If the size of the mask is odd, then the center of the Gaussian is in the center of the mask. If it is even, the the center is as thought the mask was one larger. If you want a have a mask which contains most of the Gaussian (excluded values are close to zero), then you need to make the mask size at least 6 times sigma. Regardless of the size and sigma, the mask is normalized so that its sum 1. If *out_vpp is NULL, then a vector of the appropriate size is created, if it is the wrong size, then it is resized, and if it is the right size, the storage is recycled.

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