Create Normal Raster (Spatial Analyst)

License Level:BasicStandardAdvanced

Summary

Creates a raster of random values with a normal (gaussian) distribution within the extent and cell size of the analysis window.

Illustration

Create Normal Raster illustration
OutRas = CreateNormalRaster(1, 0 0 4 4)
Note: This output is representative. The actual values will be different each time the tool is executed.

Usage

Syntax

CreateNormalRaster ({cell_size}, {extent})
ParameterExplanationData Type
cell_size
(Optional)

The cell size for the output raster dataset.

This is the value in the environment if specifically set. If not specifically set, it is the shorter of the width or height of the environment extent in the output spatial reference, divided by 250.

Analysis Cell Size
extent
(Optional)

The extent for the output raster dataset.

The Extent is a Python class.

In this tool it is in the form of: Extent(XMin, YMin, XMax, YMax)

  • where XMin and YMin define the lower-left coordinate of the extent, with XMax and YMax defining the upper-right coordinate.

The coordinates are specified in the same map units as the Output coordinate system environment setting.

The extent will be the value in the environment if specifically set. If not specifically set, the default is 0, 0, 250, 250.

Extent

Return Value

NameExplanationData Type
out_raster

The output raster of normally distributed values with a mean of 0.0 and a standard deviation of 1.0.

Raster

Code Sample

CreateNormalRaster example 1 (Python window)

This sample creates an output raster of normally distributed values at the defined cell size and extent.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNormalRaster = CreateNormalRaster(2, Extent(0, 0, 150, 150))
outNormalRaster.save("C:/sapyexamples/output/outnormal")
CreateNormalRaster example 2 (stand-alone script)

This sample creates an output raster of normally distributed values at the defined cell size and extent.

# Name: CreateNormalRaster_Ex_02.py
# Description: Creates a raster of random values from a normal distribution
# 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
cellSize = 2
extent = Extent(0, 0, 150, 150)

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

# Execute CreateNormalRaster
outNormalRaster = CreateNormalRaster(cellSize, extent) 

# Save the output 
outNormalRaster.save("C:/sapyexamples/output/outnormraster")

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Requires Spatial Analyst
ArcGIS for Desktop Standard: Requires Spatial Analyst
ArcGIS for Desktop Advanced: Requires Spatial Analyst
4/10/2014