创建随机栅格 (数据管理)

在 Advanced 许可等级下可用。

描述

使用您可以定义的分布创建随机值的栅格数据集。

使用方法

• 您可以将输出保存到 Esri Grid、CRF、IMG、TIFF 或任意地理数据库栅格数据集。

• 赋予输出栅格每个像元的值均通过随机数生成器和所选的分布类型得到。可供使用的随机数生成器有多个，可在“环境设置”的随机数中设置您希望使用的随机数生成器。随机数生成器根据生成器类型和种子值开启随机数流。这些数是随机确定的且值在 0 到 1 之间。每个值都独立于其他值。

  在分配（或转换）输出栅格中的值时，随机数生成器可以使用多种分布类型。不同的分布类型通常会产生不同的结果，具体选择哪种分布将由栅格的最终用途决定。如果要通过随机栅格对某些自然现象建模，则所选分布类型应该能够尽可能好地表达这些现象发生的过程。

  有关分布类型及如何使用这些分布类型的说明，请参阅用于分配随机值的分布法。

• 均匀分布、整数分布、正态分布和指数分布的处理时间与其各自的参数无关，而泊松分布、Gamma 分布、二项分布、几何分布和帕斯卡分布的处理时间则会因参数的不同相差很大。

• 若未能为像元大小参数提供值，则将为其计算出一个默认值。该值将根据范围的大小进行计算。

• 在工具对话框中，输出范围参数中显示的值位于地图坐标系中。在工具执行期间，如果在环境设置中指定了输出坐标系，则会将范围投影到该坐标系。

语法

CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize})

参数	说明	数据类型
out_path	选择用于存储栅格数据集的文件夹或地理数据库。	Workspace
out_name	指定输出栅格数据集的名称和扩展名（需要时）。 将栅格数据集存储到地理数据库时，请勿向栅格数据集的名称添加文件扩展名。 要在地理数据库中以 Esri Grid 栅格或栅格数据集形式存储输出，则不应向栅格数据集的名称添加文件扩展名。要以其中一个可用的文件栅格格式存储栅格数据集，请指定 tif 扩展名以输出 TIFF 栅格，或为 ERDAS IMAGINE 栅格指定 .img。 将栅格数据集存储到 TIFF 文件或地理数据库栅格时，您可以指定压缩类型和压缩质量。	String
distribution （可选）	指定要使用的随机值分布方法。 UNIFORM {最小值}，{最大值} - 已定义范围的均匀分布。{最小值} 的默认值为 0.0，{最大值} 的默认值为 1.0。这两个值均为双精度型。 INTEGER {最小值}，{最大值} - 已定义范围的整数分布。{最小值} 的默认值为 1，{最大值} 的默认值为 10。这两个值均为长整型。 NORMAL {平均值}，{标准差} - 已定义 {平均值} 和 {标准差} 的正态分布。{平均值} 的默认值为 0.0，{标准差} 的默认值为 1.0。这两个值均为双精度型。 EXPONENTIAL {平均值} - 已定义 {平均值} 的指数分布。默认值为 1.0。该值为双精度型。 POISSON {平均值} - 已定义 {平均值} 的泊松分布。默认值为 1.0。该值为双精度型。 GAMMA {Alpha}，{Beta} - 已定义 {Alpha} 和 {Beta} 值的 Gamma 分布。{Alpha} 和 {Beta} 的默认值都是 1.0。这两个值均为双精度型。 BINOMIAL {N}，{概率} - 已定义 {N} 和 {概率} 的二项分布。{N} 是长整型，默认值是 10。{概率} 是双精度型，默认值是 0.5。 GEOMETRIC {概率} - 已定义 {概率} 的几何分布。默认值为 0.5。该值为双精度型。 NEGATIVE BINOMIAL {r}，{概率} - 已定义 {r} 和 {概率} 的帕斯卡分布。{r} 是双精度型，默认值是 10.0。{概率} 是双精度型，默认值是 0.5。	String
raster_extent （可选）	设置输出栅格数据集的范围。	Extent
cellsize （可选）	定义输出栅格数据集的空间分辨率。	Double

派生输出

名称	说明	数据类型
out_raster_dataset	输出栅格数据集。	栅格数据集

代码示例

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)

环境

范围, 输出坐标系, 金字塔

许可信息

• Basic: 需要 3D Analyst 或 Spatial Analyst
• Standard: 需要 3D Analyst 或 Spatial Analyst
• Advanced: 是