创建常量栅格 (空间分析)

摘要

基于分析窗口的范围和像元大小创建值为常量的栅格。

插图

OutRas = CreateConstantRaster(2)

用法

• 创建常量栅格工具可将指定值分配到输出栅格的每个像元中。

• 常量值必须是数值。接受以科学记数法表示的值（例如，3.048e^-4）。

• 可能是由于以下这些常见原因要创建所有值均相同的栅格：

  • 在已设置掩膜环境中希望栅格在其他多种工具中能够标识所有未掩膜得像元（例如，以条件函数工具中的条件栅格形式）。
  • 希望来自掩膜或某些选择过程的输出栅格中的所有值都归类为一个值。
  • 希望在某个分析中对另一个栅格中的所有像元位置应用一个常量值 - 例如，在噪声污染栅格中的每个位置添加五个分贝。

语法

CreateConstantRaster (constant_value, {data_type}, {cell_size}, {extent})

参数	说明	数据类型
constant_value	用来创建输出栅格数据集的常量值。	Double
data_type (可选)	输出栅格数据集的数据类型。 INTEGER - 将创建整型栅格。 FLOAT - 将创建浮点型栅格。 如果指定的数据类型为 FLOAT，则输入常量值将仅精确到 7 位小数（单精度）。	String
cell_size (可选)	输出栅格数据集的像元大小。 如果专门进行设置，则是环境中的值。如果未进行专门设置，则该值为输出空间参考中环境范围的宽度或高度中的较小值除以 250。	Analysis Cell Size
extent (可选)	输出栅格数据集的范围。 范围是一个 Python 类。 在该工具中，其形式为：Extent(XMin, YMin, XMax, YMax) 其中 XMin 和 YMin 定义范围的左下坐标，XMax 和 YMax 定义右上坐标。 指定给坐标的地图单位与输出坐标系环境设置的地图单位相同。 如果专门进行设置，则范围将为环境中的值。如果未进行专门设置，默认值将为 0、0、250、250。	Extent

返回值

名称	说明	数据类型
out_raster	各像元均将具有指定常量值的输出栅格。	Raster

代码实例

CreateConstantRaster 示例 1（Python 窗口）

本示例将在定义的像元大小和范围内创建具有特定值的浮点型栅格。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outConstRaster = CreateConstantRaster(12.7, "FLOAT", 2, Extent(0, 0, 250, 250))
outConstRaster.save("C:/sapyexamples/output/outconst2")

CreateConstantRaster 示例 2（独立脚本）

本示例将在定义的像元大小和范围内创建具有特定值的整型栅格。

# Name: CreateConstantRaster_Ex_02.py
# Description: Creates a raster from a constant value
# Requirements: Spatial Analyst Extension

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

# Set local variables
constantValue = 12
cellSize = 2
outExtent = Extent(0, 0, 250, 250)

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

# Execute CreateConstantRaster
outConstRaster = CreateConstantRaster(constantValue, "FLOAT", cellSize,
                                      outExtent)

# Save the output 
outConstRaster.save("C:/sapyexamples/output/outconst")

环境

像元大小, 当前工作空间, 掩膜, 输出坐标系, 范围, 临时工作空间, 捕捉栅格

许可信息

ArcGIS for Desktop Basic: 需要 Spatial Analyst

ArcGIS for Desktop Standard: 需要 Spatial Analyst

ArcGIS for Desktop Advanced: 需要 Spatial Analyst