在 Advanced 许可等级下可用。
摘要
使用您可以定义的分布创建随机值的栅格数据集。
用法
您可以将输出保存到 Esri Grid、IMG、TIFF 或任意地理数据库栅格数据集。
赋予输出栅格每个像元的值均通过随机数生成器和所选的分布类型得到。可供使用的随机数生成器有多个,而您希望使用的随机数生成器是在“环境设置”的随机数中进行设置的。随机数生成器根据生成器类型和种子值开启随机数流。这些数是随机确定的,并且值在 0 和 1 之间。各值之间相互独立。
在分配(或转换)输出栅格中的值时,随机数生成器可以使用多种分布类型。不同的分布类型通常会产生不同的结果,具体选择哪种分布将由栅格的最终用途决定。如果要通过随机栅格对某些自然现象建模,则所选分布类型应该能够尽可能好地表达这些现象发生的过程。
有关分布类型及如何使用这些分布类型的说明,请参阅用于分配随机值的分布法。
均匀分布、整数分布、正态分布和指数分布的处理时间与其各自的参数无关,而泊松分布、Gamma 分布、二项分布、几何分布和帕斯卡分布的处理时间则会因参数的不同相差很大。
若未能为像元大小参数提供值,则将为其计算出一个默认值。该值将根据范围的大小进行计算。
语法
CreateRandomRaster_management (out_path, out_name, {distribution}, {raster_extent}, {cellsize})
参数 | 说明 | 数据类型 |
out_path | 选择用于存储栅格数据集的文件夹或地理数据库。 | Workspace; Raster Catalog |
out_name | 需要时,为输出栅格数据集指定名称和扩展名。 以地理数据库形式存储栅格数据集时,请勿向栅格数据集的名称添加文件扩展名。 在地理数据库中将输出存储为 Esri Grid 栅格或栅格数据集时,不应向栅格数据集的名称添加文件扩展名。要以其中一个可用的文件栅格格式存储栅格数据集时,请指定 tif 扩展名以输出 TIFF 栅格,或为 ERDAS IMAGINE 栅格指定 .img。 将栅格数据集存储到 TIFF 文件或地理数据库栅格时,您可以指定压缩类型和压缩质量。 | String |
distribution (可选) | 指定要使用的随机值分布方法。
| String |
raster_extent (可选) | 设置输出栅格数据集的范围。 | Extent |
cellsize (可选) | 定义输出栅格数据集的空间分辨率。 | Double |
代码实例
CreateRandomRaster 示例 1(Python 窗口)
本例将基于定义的范围和像元大小创建随机值符合正态分布的输出栅格。
import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast",
"NORMAL 3.0", "0 0 500 500", 50)
CreateRandomRaster 示例 2(独立脚本)
本例将基于定义的范围和像元大小创建随机值符合泊松分布的输出栅格。
# Name: CreateRandomRaster_Ex_02.py
# Description: Creates a random raster dataset based on a
# user-specified distribution and extent.
# Requirements: None
# Import system modules
import arcpy
# Set local variables
outPath = "c:/output"
outFile = "randrast02"
distribution = "POISSON 6.4"
outExtent = "250 250 750 750"
cellSize = 25
# Execute CreateRandomRaster
arcpy.CreateRandomRaster_management(outPath, outFile, distribution,
outExtent, cellSize)