Home

Quick Links

Software Manual
GitHub
API Reference

Documentation Versions

Latest Release
Dev
8.3.0
8.2.0
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0
USGS

ISIS Application Documentation


gauss

Printer Friendly View | TOC | Home

Filter a cube through a kernel using Gaussian weight

Overview Parameters Example 1 Example 2

Description

This program calculates weight based on the bell-shaped Gaussian curve. The weight is then applied to an image kernel in such a way as to create a filter that will move a weighted average through the image. The end result is a blurred image with reduced detail and noise. The Gaussian function that determines the weight for all of the values in the kernel is as follows
                                                  /   x^2+y^2   \
                                               - |  -----------  |
                G(x,y) =           1              \ 2(STDDEV)^2 /
      			    --------------- e^
			    2(pi)(STDDEV)^2
  
This formula creates a kernel that then runs through the image. The center of the kernel is at (0,0). This means that a 3x3 boxcar will be of the form
        The kernel coordinates
  (-2,-2) (-1,-2) (0,-2) (1,-2) (2,-2)
  (-2,-1) (-1,-1) (0,-1) (1,-1)	(2,-1)
  (-2, 0) (-1, 0) (0, 0) (1, 0) (2, 0)
  (-2, 1) (-1, 1) (0, 1) (1, 1) (2, 1)
  (-2, 2) (-1, 2) (0, 2) (1, 2) (2, 2)

          The kernel values (approx)
       1   4   7   4   1
       4   16  26  16  4
       7   26  41  26  7     x 1/273
       4   16  26  16  4
       1   4   7   4   1
  

Categories


Related Objects and Documents

Applications


History

Drew Davidson2004-08-05 Original version
Drew Davidson2004-08-06 Added application test
Drew Davidson2004-08-16 Added examples
Drew Davidson2005-06-27 Fixed bug in boxcar size
Brendan George2006-09-21 Documentation fixes
Kaitlyn Lee2018-02-15 Removed the cout that was outputting e to the terminal. Fixes #5198.

U.S. Department of the Interior | U.S. Geological Survey
ISIS | Privacy & Disclaimers | Astrogeology Research Program
To contact us, please post comments and questions on the USGS Astrogeology Discussion Board
To report a bug, or suggest a feature go to: ISIS Github
File Modified: 02/21/2025 19:28:10
X

Files: FROM


Description

Use this parameter to select the filename. All bands within the file will be filtered.

Type cube
File Mode input
Filter *.cub
Close Window
X

Files: TO


Description

This file will contain the results of the filter, a blurred version of the input file.

Type cube
File Mode output
Close Window
X

boxcar: SIZE


Description

This is the user specified size of the boxcar that will move through the image. The boxcar must be square, so the default value of 3 will result in a 3 x 3 boxcar. A value of five would result in a 5 x 5 boxcar moving through the image.

Type integer
Default 3
Odd This value must be an odd number
Close Window
X

Standard Deviation: STDDEV


Description

At the most basic level, standard deviation can be thought of in this context as the intensity of the blur being applied to the image. The higher this value, the more noise and detail will be removed. At a deeper level, standard deviation is described as the average distance from any single measurement of a set to the mean of that set.

Type double
Default 1.0
Minimum 0 (exclusive)
Close Window