设置栅格属性 (Data Management)

摘要

设置栅格数据集或镶嵌数据集的某些属性，例如数据类型、统计数据和 NoData 值。

了解有关栅格统计数据和属性的详细信息

用法

• 此工具可用于定义栅格或镶嵌数据集的统计数据。通常，如果不希望让 ArcGIS 计算这些数据，则可使用此工具。可以设置的统计数据包括每个波段的最小值、最大值、标准差和平均值。可以从 XML 文件中读取这些统计数据。可通过从其他栅格或镶嵌数据集中导出统计数据来创建此 XML 文件，方法如下：

  1. 在目录 窗口中，右键单击包含要导出的统计数据的栅格或镶嵌数据集，然后选择属性。
  2. 向下滚动到包含统计数据属性的行。
  3. 在值列中，展开选项下拉菜单。
  4. 单击将统计数据导出为 XML。

• 可以使用此工具设置的属性可确定 ArcMap 中的默认渲染设置，以及其他工具使用的统计数据。

  可以设置的属性包括：

  • 数据源类型：此属性定义像元值是表示高程数据还是分类数据，或者该值是否已由其他方法处理且显示数据时不需要拉伸。
  • 每个波段的统计数据：对于每个波段，均可定义最小值、最大值、平均值和标准差值。
  • NoData 值的波段：对于每个波段，均可定义 NoData 值。

• 这些属性也可以在属性 窗口中设置，具体方法是：在目录 窗口中右键单击栅格，然后选择属性；或者在 ArcMap 中右键单击栅格图层，然后选择属性。设置栅格属性工具可用于在地理处理模型或 Python 中设置这些属性。

语法

SetRasterProperties_management (in_raster, {data_type}, {statistics}, {stats_file}, {nodata})

参数	说明	数据类型
in_raster	输入栅格数据集或镶嵌数据集。	Mosaic Layer ; Raster Layer
data_type (可选)	此数据集所包含的数据的类型。 这些设置用于控制数据集渲染时所应用的符号系统。 GENERIC —此类数据是不适用于任何其他数据源类型的栅格。ArcGIS 会尝试使用最合适的渲染器显示此类数据。 ELEVATION —数据为高程数据。显示此类数据时将应用最小值 - 最大值拉伸。 THEMATIC —数据为分类数据；因此不需要使用拉伸。此类数据可能应使用色彩映射表或唯一值渲染器显示。 PROCESSED —数据已进行了增强处理；因此，显示此数据集时不需要应用拉伸。	String
statistics [[band_index, min, max, mean, std_dev],...] (可选)	输入波段号、最小统计值、最大统计值、平均统计值和标准差值。	Value Table
stats_file (可选)	包含统计数据的 XML 文件。可通过从其他栅格或镶嵌数据集中导出统计数据来创建此文件。	File
nodata [[band index, nodata_value],...] (可选)	为每个波段或所有波段定义值。每个波段都可定义唯一的 NoData 值，也可为所有波段指定相同的值。如果要为选择的各波段定义多个 NoData 值，则在 bands_for_nodata_value 参数的各 NoData 值之间使用空格分隔符。	Value Table

代码实例

SetRasterProperties 示例 1（Python 窗口）

这是 SetRasterProperties 的 Python 示例。

import arcpy
arcpy.SetRasterProperties_management("\\cpu\data\srtm.tif", "ELEVATION", 
                                     "1 50 400 5 28" , "#" , "#")

SetRasterProperties 示例 2（独立脚本）

这是 SetRasterProperties 的 Python 脚本示例。

#Set raster dataset type and statistics

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.SetRasterProperties_management("srtmraster.tif", "ELEVATION", 
                                         "1 50 400 5 28", "#", "#")

环境

当前工作空间

许可信息

ArcGIS for Desktop Basic:是

ArcGIS for Desktop Standard:是

ArcGIS for Desktop Advanced:是