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

描述

在栅格或镶嵌数据集中设置数据类型、统计数据和 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: 是