在 Advanced 许可等级下可用。
使用您定义的分布创建随机值的栅格数据集。
您可以将输出保存到 Esri Grid、CRF、IMG、TIFF 或任意地理数据库栅格数据集。
赋予输出栅格每个像元的值均通过随机数生成器和所选的分布类型得到。有以下几种随机数生成器。查看随机数生成器环境，以确定要使用的环境。随机数生成器根据生成器类型和种子值开启随机数流。这些数是随机确定的且值在 0 到 1 之间。每个值都独立于其他值。
在分配（或转换）输出栅格中的值时，随机数生成器可以使用多种分布类型。不同的分布类型通常会产生不同的结果，具体使用哪种分布将由栅格的最终用途决定。如果要通过随机栅格对某一自然现象建模，则所选分布类型应该能够尽可能好地表达这些现象发生的过程。
有关分布类型及通常如何使用这些分布类型的说明，请参阅用于分配随机值的分布法。
均匀分布、整数分布、正态分布和指数分布的处理时间与其各自的参数无关，而泊松分布、Gamma 分布、二项分布、几何分布和帕斯卡分布的处理时间则会因参数的不同相差很大。
若未能为像元大小参数提供值，则将为其计算出一个默认值。该值将根据范围的大小进行计算。
在工具对话框中，输出范围参数中的值位于地图坐标系中。在工具执行期间，如果在环境设置中指定了输出坐标系，则会将范围投影到该坐标系。
| 标注 | 说明 | 数据类型 |
输出位置 | 存储输出栅格数据集的文件夹以及地理数据库。 | Workspace |
具有扩展名的栅格数据集名称 | 要创建的栅格数据集的名称和格式。 要将输出存储为地理数据库中的栅格数据集，请勿在栅格数据集名称中添加文件扩展名。 对于基于文件的栅格，使用相应扩展名来指定要创建的格式，如下所示：
| String |
分布 (可选) | 指定要使用的随机值分布方法。 每种类型都有一个或两个设置来控制分布。
要编辑默认值，请单击表中的值，然后输入新值。 | String |
输出范围 (可选) | 输出栅格数据集的范围。
| Extent |
像元大小 (可选) | 输出栅格数据集的空间分辨率。 | Double |
构建栅格属性表 (可选) | 指定该工具是否将无条件地为输出栅格构建栅格属性表，其中所选分布将生成整数输出栅格。 如果输出栅格为浮点，则此参数无效。
| Boolean |
| 标注 | 说明 | 数据类型 |
| 输出栅格数据集 | 输出栅格数据集。 | 栅格数据集 |
- 范围基于活动地图或场景。 仅在存在活动地图时，才可使用此选项。
- 范围将基于在地图或场景上绘制的矩形。 此选项将在工程地理数据库中创建要素类并将图层添加至地图。 该要素类的坐标系将与地图相同。
- 范围基于活动地图图层。 使用下拉列表选择可用图层，或使用
- 图层中所有要素的范围。
- 图层中选定要素的范围。
- 图层中可见要素的范围。
- 范围基于现有数据集。
- 可在剪贴板中复制和粘贴范围。
- 将范围坐标和坐标系复制到剪贴板。
- 将范围重置为默认值。arcpy.management.CreateRandomRaster(out_path, out_name, {distribution}, {raster_extent}, {cellsize}, {build_rat})| 名称 | 说明 | 数据类型 |
out_path | 存储输出栅格数据集的文件夹以及地理数据库。 | Workspace |
out_name | 要创建的栅格数据集的名称和格式。 要将输出存储为地理数据库中的栅格数据集，请勿在栅格数据集名称中添加文件扩展名。 对于基于文件的栅格，使用相应扩展名来指定要创建的格式，如下所示：
| String |
distribution (可选) | 指定要使用的随机值分布方法。 每种类型都有一个或两个设置来控制分布。
| String |
raster_extent (可选) | 输出栅格数据集的范围。
| Extent |
cellsize (可选) | 输出栅格数据集的空间分辨率。 | Double |
build_rat (可选) | 指定该工具是否将无条件地为输出栅格构建栅格属性表，其中所选分布将生成整数输出栅格。 如果输出栅格为浮点，则此参数无效。
| Boolean |
| 名称 | 说明 | 数据类型 |
| out_raster_dataset | 输出栅格数据集。 | 栅格数据集 |
本例将基于定义的范围和像元大小创建随机值符合正态分布的输出栅格。
import arcpy
arcpy.CreateRandomRaster_management("c:/output", "randrast",
"NORMAL 3.0", "0 0 500 500", 50)本例将基于定义的范围和像元大小创建随机值符合泊松分布的输出栅格。
# 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)