ArcMap

设置栅格属性

描述

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

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

使用方法

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

    此 XML 文件可通过从其他栅格或镶嵌数据集中导出统计数据来创建，如下所示：

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

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

    可以设置的属性包括：

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

相关主题