Create Random Raster (Spatial Analyst)

Summary

Creates a raster of random floating point values between 0.0 and 1.0 within the extent and cell size of the analysis window.

Illustration

Create Random Raster illustration
OutRas = CreateRandomRaster()
Note: This output is representative. The actual values will be different each time the tool is executed.

Usage

Syntax

CreateRandomRaster ({seed_value}, {cell_size}, {extent})
ParameterExplanationData Type
seed_value
(Optional)

A value to be used to reseed the random number generator.

This may be an integer or floating-point number. Rasters are not permitted as input.

The random number generator is automatically seeded with the current value of the system clock (seconds since January 1, 1970). The range of permissible values for the seed value is -231+1 to 231 (or -2,147,483,647 to 2,147,483,648).

Double
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 in_raster.

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 randomly distributed values with a range of 0.0 to 1.0

Raster

Code Sample

CreateRandomRaster example 1 (Python window)

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

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

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

# Name: CreateRandomRaster_Ex_02.py
# Description: Creates a raster of random floating point values
#              between 0 and 1
# Requirements: Spatial Analyst Extension
# Author: ESRI

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

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

# Set local variables
seedValue = 1
cellSize = 2
extent = Extent(0, 0, 150, 150)

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

# Execute CreateRandomRaster
outRandomRaster = CreateRandomRaster(seedValue, cellSize, extent) 

# Save the output 
outRandomRaster.save("C:/sapyexamples/output/outrand")

Environments

Related Topics

Licensing Information

ArcView: Requires Spatial Analyst
ArcEditor: Requires Spatial Analyst
ArcInfo: Requires Spatial Analyst

6/29/2011