FuzzyGaussian (arcpy.sa)

Summary

Defines a fuzzy membership function through a Gaussian or normal distribution based around a user-specified midpoint (which is assigned a membership of 1) with a defined spread decreasing to zero.

Discussion

The tool that uses the FuzzyGaussian object: Fuzzy Membership.

The equation for the fuzzy Gaussian function is:

Gaussian fuzzy function equation

The inputs to the equation are f1, the spread, and f2, the midpoint. Increasing the spread causes the fuzzy membership curve to become steeper.

The Gaussian function is useful if the membership is near a specific value.

The input values can be either integer or floating point positive values.

Gaussian is similar to the Near function but has a more narrow spread.

Fuzzy Gaussian graph
Variations of the fuzzy Gaussian membership function.

Syntax

FuzzyGaussian (midpoint, spread)
ParameterExplanationData Type
midpoint

The user-defined value with a fuzzy membership of 1.

The default is the midpoint of the range of values of the input raster.

Double
spread

Defines the spread of the Gaussian function. The spread generally ranges from 0.01 to 1, with the larger the value results in a steeper distribution around the midpoint.

(The default value is 0.1)

Double

Properties

PropertyExplanationData Type
midpoint
(Read and Write)

The user-defined value defining the midpoint for the membership function.

Double
spread
(Read and Write)

Defines the spread of the membership function. The larger the value results in a steeper distribution from the midpoint.

Double

Code Sample

FuzzyGaussian example 1 (Python window)

Demonstrates how to create a FuzzyGaussian class and use it in the FuzzyMembership tool within the Python window.

import arcpy
from arcpy.sa import *
from arcpy import env
env.workspace = "c:/sapyexamples/data"
outFzyMember = FuzzyMembership("as_std", FuzzyGaussian(12, 0.1))
outFzyMember.save("c:/sapyexamples/fzymemb")
FuzzyGaussian example 2 (stand-alone script)

Performs a FuzzyMembership using the FuzzyGaussian class.

# Name: FuzzyGaussian_Ex_02.py
# Description: Scales input raster data into values ranging from zero to one
#     indicating the strength of a membership in a set. 
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "as_std"

# Create the FuzzyGaussian algorithm object
midpoint = 10
spread = 0.2
myFuzzyAlgorithm = FuzzyGaussian(midpoint, spread)

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute FuzzyMembership
outFuzzyMember = FuzzyMembership(inRaster, myFuzzyAlgorithm)

# Save the output
outFuzzyMember.save("c:/sapyexamples/fzygauss")

Related Topics

3/7/2014