RandomNumberGenerator

Summary

Determines the type and seed that will be used to create random numbers between 0 and 1 for all tools that utilize random numbers, for example, CreateRandomRaster, CreateRandomPoints, and the ArcGIS.Rand() function.

Returned from the randomGenerator environment.

Method Overview

MethodExplanation
exportToString ()

Exports the object to its string representation.

loadFromString (string)

Restore the object using its string representation. The exportToString method can be used to create a string representation.

Methods

exportToString ()
Return Value
Data TypeExplanation
String

The string representation of the object.

loadFromString (string)
ParameterExplanationData Type
string

The string representation of the object.

String

Code Sample

RandomNumberGenerator example

Demonstrate how to create a random number generator object.

import arcpy
from arcpy import env

# Cannot create RandomNumberGenerator object directly,
#   but is returned from CreateRandomValueGenerator function.
#
#   CreateRandomValueGenerator takes 2 arguments, seed and distribution method.
#   The distribution method options are ACM599, 
#   MERSENNE_TWISTER, STANDARD_C.
#
#   The gen variable is a randomNumberGenerator object that is assigned to
#   the randomGenerator environments setting.
#
env.randomGenerator = arcpy.CreateRandomValueGenerator(20, "STANDARD_C")

# Calculate a random number using the ArcGIS.Rand() function
#
result = arcpy.CalculateValue_management("arcgis.rand('normal 0.0 10.0')")

# Get the value from the result object and print it to the Python window.
#
val = float(result.getOutput(0))
print val

Related Topics


10/28/2011