DIPlib Documentation - ©1995-2008 Quantitative Imaging Group, Delft University of Technology.

Gauss

Gaussian Filter

SYNOPSIS

#include "dip_linear.h"

dip_Error dip_Gauss ( in, out, boundary, process, sigmas, order, truncation )

DATA TYPES

binary, integer, float

FUNCTION

Finite impulse response implementation of a Gaussian convolution filter and Gaussian derivative convolution filters. The Gaussian kernel is cut off at truncation times the sigma of the filter (in each dimension). The sum of the Gaussian's coefficients is normalised to one.

A truncation smaller than zero indicates that the global preferred truncation ought to be used. Both the process and the order parameter may be zero. If process is zero all dimensions are processed. If order is zero no derivatives are taken.

ARGUMENTS

Data typeNameDescription
dip_ImageinInput
dip_ImageoutOutput
dip_BoundaryArrayboundaryBoundary conditions
dip_BooleanArrayprocess (0)Dimensions to process
dip_FloatArraysigmasSigma of Gaussian
dip_IntegerArrayorder (0)Order of Derivative along each dimension
dip_floattruncation (<0)Truncation of Gaussian

LIMITATIONS

The order of the derivative is limited to the interval 0-3. Sigmas considerably smaller than 1.0 will yield nonsensical results.

SEE ALSO

See sections 9.4, "Smoothing operations", and 9.5, "Derivative-based operations", in "Fundamentals of Image Processing".

General information about convolution

GaussFT, GaussIIR, Derivative

DIPlib on-line documentation | Function reference | Global function index