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

摘要

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

使用情况

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

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

    您可以设置以下属性:

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

参数

标注说明数据类型
输入栅格

具有要设置属性的栅格或镶嵌数据集。

Mosaic Layer ; Raster Layer
数据源类型
(可选)

指定镶嵌数据集内的影像类型。

  • 通用镶嵌数据集没有指定的数据类型。
  • 高程镶嵌数据集包含高程数据。
  • 专题镶嵌数据集包含具有离散值的专题数据,例如土地覆被。
  • 已处理已对镶嵌数据集进行了色彩校正。
  • 科学数据具有科学信息,并且在默认情况下将通过从蓝到红的色带来显示。
  • 矢量 UV此数据是包含矢量字段数据 U 和 V 分量的双波段栅格。
  • 量级和方向此数据是包含矢量字段数据量级和方向的双波段栅格。
  • 日期数据有日期信息,会以日期格式显示。
String
每个波段的统计数据
(可选)

最小值、最大值、平均值和标准差的波段和值。

Value Table
从文件导入统计数据
(可选)

包含统计数据的 .xml 文件。

File
NoData 值的波段
(可选)

每个波段的 NoData 值。 每个波段都可定义唯一的 NoData 值,也可为所有波段指定相同的值。

NoData 下拉箭头中选择波段,然后单击添加按钮将其添加到表中。 然后输入一个或多个值。 如果选择多个 NoData 值,则用空格分隔各值。

Value Table
关键属性
(可选)

本身支持的属性。 所用数据可能具有未包含在以下列表中的附加属性。 属性不区分大小写。

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • FlowDirection
  • Footprint
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • ReflectanceBias
  • ReflectanceGain
  • Segmented
  • SensorAzimuth
  • SensorElevation
  • SensorName
  • SolarIrradiance
  • SourceBandIndex
  • SunAzimuth
  • SunElevation
  • ThermalConstant_K1
  • ThermalConstant_K2
  • VerticalAccuracy
  • WavelengthMin
  • WavelengthMax
Value Table
多维信息
(可选)

栅格数据集的维度信息。 设置维度信息会将无维度栅格转换为多维栅格。

如果维度为时间,则维度名称必须为 StdTime。 时间的格式为年-月-日 (2021-10-01) 或年-月-日 T 时-分-秒 (2021-10-01T01:00:00)。

定义一个既有时间又有高程的变量,先添加时间变量;然后添加与 z 维度相同的变量。

Value Table

派生输出

标注说明数据类型
更新的栅格数据集

输出栅格数据集。

Raster Dataset

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties}, {multidimensional_info})
名称说明数据类型
in_raster

具有要设置属性的栅格或镶嵌数据集。

Mosaic Layer ; Raster Layer
data_type
(可选)

指定镶嵌数据集内的影像类型。

  • GENERIC镶嵌数据集没有指定的数据类型。
  • ELEVATION镶嵌数据集包含高程数据。
  • THEMATIC镶嵌数据集包含具有离散值的专题数据,例如土地覆被。
  • PROCESSED已对镶嵌数据集进行了色彩校正。
  • SCIENTIFIC数据具有科学信息,并且在默认情况下将通过从蓝到红的色带来显示。
  • VECTOR_UV此数据是包含矢量字段数据 U 和 V 分量的双波段栅格。
  • VECTOR_MAGDIR此数据是包含矢量字段数据量级和方向的双波段栅格。
  • DATE数据有日期信息,会以日期格式显示。
String
statistics
[[band_index, min, max, mean, std_dev],...]
(可选)

最小值、最大值、平均值和标准差的波段和值。

Value Table
stats_file
(可选)

包含统计数据的 .xml 文件。

File
nodata
[[band index, nodata_value],...]
(可选)

每个波段的 NoData 值。 每个波段都可定义唯一的 NoData 值,也可为所有波段指定相同的值。 如果要为选择的各波段定义多个 NoData 值,则各 NoData 值之间使用空格分隔符。

Value Table
key_properties
[key_properties,...]
(可选)

本身支持的属性。 所用数据可能具有未包含在以下列表中的附加属性。 属性不区分大小写。

  • AcquisitionDate
  • BandName
  • BlockName
  • CloudCover
  • DatasetTag
  • FlowDirection
  • Footprint
  • HighCellSize
  • LowCellSize
  • MinCellSize
  • MaxCellSize
  • OffNadir
  • ParentRasterType
  • ParentTemplate
  • PerspectiveX
  • PerspectiveY
  • PerspectiveZ
  • ProductName
  • RadianceBias
  • RadianceGain
  • ReflectanceBias
  • ReflectanceGain
  • Segmented
  • SensorAzimuth
  • SensorElevation
  • SensorName
  • SolarIrradiance
  • SourceBandIndex
  • SunAzimuth
  • SunElevation
  • ThermalConstant_K1
  • ThermalConstant_K2
  • VerticalAccuracy
  • WavelengthMin
  • WavelengthMax
Value Table
multidimensional_info
[multidimensional_info,...]
(可选)

栅格数据集的维度信息。 设置维度信息会将无维度栅格转换为多维栅格。

如果维度为时间,则维度名称必须为 StdTime。 时间的格式为年-月-日 (2021-10-01) 或年-月-日 T 时-分-秒 (2021-10-01T01:00:00)。

定义一个既有时间又有高程的变量,先添加时间变量;然后添加与 z 维度相同的变量。

Value Table

派生输出

名称说明数据类型
out_raster

输出栅格数据集。

Raster Dataset

代码示例

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