返回顶部

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

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

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

使用情况

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

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

    您可以设置以下属性：

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

参数

对话框Python

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

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

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

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

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

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

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

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

File
NoData 值的波段
(可选)

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

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

Value Table
关键属性
(可选)

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

  • 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
  • Variable
  • 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—此数据是包含矢量字段数据量级和方向的双波段栅格。
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
  • Variable
  • 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", "#", "#")

环境

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

特殊情况

许可信息

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

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息