设置栅格属性 (数据管理)

描述

在栅格或镶嵌数据集中设置数据类型、统计数据和 NoData 值。

使用方法

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

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

  可以设置的属性包括：

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

语法

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties})

参数	说明	数据类型
in_raster	要设置其属性的栅格数据集或镶嵌数据集。	Mosaic Layer ; Raster Layer
data_type （可选）	镶嵌数据集中的影像类型。 GENERIC — 镶嵌数据集没有指定的数据类型。 ELEVATION — 镶嵌数据集包含高程数据。 THEMATIC —专题数据具有离散值，例如土地覆被。 PROCESSED —镶嵌数据集的色彩已得到平衡。 SCIENTIFIC —数据具有科学信息，并且在默认情况下将通过从蓝到红的色带来显示。 VECTOR_UV —此数据是包含矢量字段数据的 U 和 V 组件的双波段栅格。 VECTOR_MAGDIR —此数据是包含矢量字段数据的量级和方向的双波段栅格。	String
statistics [[band_index, min, max, mean, std_dev],...] （可选）	为最小值、最大值、平均值和标准差指定波段和值。	Value Table
stats_file （可选）	包含统计数据的 .xml 文件。	File
nodata [[band index, nodata_value],...] （可选）	为每个波段指定 NoData 值。每个波段都可定义唯一的 NoData 值，也可为所有波段指定相同的值。如果要为选择的各波段定义多个 NoData 值，则在 bands_for_nodata_value 参数的各 NoData 值之间使用空格分隔符。	Value Table
key_properties [key_properties,...] （可选）	本身支持的属性如下。您的数据可能具有未包含在该列表中的附加属性。所有属性均不区分大小写。 AcquisitionDate BandName BlockName CloudCover DatasetTag Dimensions FlowDirection Footprint HighCellSize LowCellSize MinCellSize MaxCellSize OffNadir ParentRasterType ParentTemplate PerspectiveX PerspectiveY PerspectiveZ ProductName RadianceBias RadianceGain ReflectanceBias RefelctanceGain Segmented SensorAzimuth SensorElevation SensorName SolarIrradiance SourceBandIndex StdPressure StdPressure_Max StdTemperature StdTemperature_Max StdTime StdTime_Max StdZ StdZ_max SunAzimuth SunElevation ThermalConstant_K1 ThermalConstant_K2 变量 VerticalAccuracy WavelengthMin WavelengthMax	Value Table

派生输出

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

代码示例

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", "#", "#")

环境

当前工作空间, 临时工作空间

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是