顶帽变换 (Spatial Analyst 工具)
汇总
用法
输出栅格代表在每个像元位置检测到的空间结构的高度或深度。
分析类型 参数值指定了要检测的空间结构类型。 其包含两个选项：山脊 或山谷 。 山脊 分析类型用于检测高于周围环境的空间结构。 山谷 分析类型用于检测低于周围环境的空间结构。
邻域 参数值决定了用于分析的窗口形状和大小。 通常可以检测到大小或宽度小于该邻域的空间结构。
可用的邻域形状包括圆形、矩形和不规则形。 不规则邻域选项是使用内核文件定义的自定义邻域。
核文件是一个 ASCII 文本文件，用于指定邻域的值和形状。 可以使用任何纯文本编辑器来创建此文件。 文件的扩展名必须是 .txt，且文件名中没有空格。
当输出栅格格式为 .crf 时，此工具支持金字塔 栅格存储环境。 默认情况下，将在输出中创建金字塔。 对于任何其他输出格式，不支持此环境，并且不会创建金字塔。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst 。
参数
标注
说明
数据类型
输入表面栅格
输入表面栅格。
Raster Layer
邻域
（可选）
顶帽变换计算中将使用的处理像元周围的像元。 有多种预定义邻域类型可供选择，也可以定义自定义核。
选择邻域类型后，可设置其他参数来完全定义形状、大小和测量单位。 默认邻域为半径为 3 个像元的圆形。
以下为可用邻域类型的形式：
圆形 ，半径 ，单位类型
具有给定半径的圆形邻域。 最小半径为 1 个像元，最大值为 2047 个像元。 默认半径为 3 个像元。
矩形 ，高度 ，宽度 ，单位类型
由宽度和高度定义的矩形邻域。 宽度或高度的最小值为 1 个像元，最大值为 4096 个像元。 默认设置是宽度和高度为 3 个像元的正方形。
不规则 ，核文件
带有通过已识别核文本文件设置的规范的自定义邻域。 核宽度或高度的最小值为 1 个像元，最大值为 4096 个像元。
对于圆形和矩形邻域类型，参数的距离单位能够以像元 单位或地图 单位进行指定。 默认设置为“像元”单位。
对于不规则邻域类型，核文件中的第一行将以像元数来定义邻域的宽度和高度。 后续各行将指示如何处理与核中该位置相对应的输入值。 核文件中的值为 0 表示相应位置将不包括在计算中。 值为 1 表示相应的输入像元将包括在计算中。
Neighborhood
分析类型
（可选）
指定将要检测的对象类型。
String
返回值
标注
说明
数据类型
输出栅格
输出栅格。
输出栅格的像元值表示在每个像元位置检测到的对象的高度或深度，具体取决于分析类型。 当分析类型 参数指定为山脊 选项时，输出值表示在每个像元位置检测到的对象的高度。 当分析类型 参数指定为山谷 选项时，输出值表示在每个像元位置检测到的对象的深度。
Raster
TopHatTransform(in_raster, {neighborhood}, {analysis_type})
名称
说明
数据类型
in_raster
输入表面栅格。
Raster Layer
neighborhood
（可选）
顶帽变换计算中将使用的处理像元周围的像元。 有多种预定义邻域类型可供选择，也可以定义自定义核。
选择邻域类型后，可设置其他参数来完全定义形状、大小和测量单位。 默认邻域为半径为 3 个像元的圆形。
邻域的形状将由 NeighborhoodNbrCircleNbrRectangleNbrIrregular
以下为可用邻域类型的形式：
NbrCircle({radius}, {units}
具有给定半径的圆形邻域。 最小半径为 1 个像元，最大值为 2047 个像元。 默认半径为 3 个像元。
NbrRectangle({width}, {height}, {units})
由宽度和高度定义的矩形邻域。 宽度或高度的最小值为 1 个像元，最大值为 4096 个像元。 默认设置是宽度和高度为 3 个像元的正方形。
NbrIrregular(inKernelFile)
带有通过已识别核文本文件设置的规范的自定义邻域。 核宽度或高度的最小值为 1 个像元，最大值为 4096 个像元。
对于不规则邻域类型，核文件中的第一行将以像元数来定义邻域的宽度和高度。 后续各行将指示如何处理与核中该位置相对应的输入值。 核文件中的值为 0 表示相应位置将不包括在计算中。 值为 1 表示相应的输入像元将包括在计算中。
Neighborhood
analysis_type
（可选）
指定将要检测的对象类型。
String
返回值
名称
说明
数据类型
out_raster
输出栅格。
输出栅格的像元值表示在每个像元位置检测到的对象的高度或深度，具体取决于分析类型。 当 analysis_type 参数指定为 RIDGE 选项时，输出值表示在每个像元位置检测到的对象的高度。 当 analysis_type 参数指定为 VALLEY 选项时，输出值表示在每个像元位置检测到的对象的深度。
Raster
代码示例
TopHatTransform 示例 1（Python 窗口）
本示例使用山谷分析类型为输入栅格计算高帽变换。
from arcpy.sa import *
outRas = TopHatTransform('elevation.tif', "Circle 3 CELL", 'VALLEY')
outRas.save("C:/sapyexamples/output/thtout01.tif")
TopHatTransform 示例 2（独立脚本）
本示例使用山脊分析类型为输入栅格计算顶帽变换。
# Name: TopHatTransform_standalone.py
# Description: Calculates the top hat transform.
# Requirements: Spatial Analyst extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "elevation.tif"
inNeighborhood = "Circle 90 Map"
inAnalysisType = "RIDGE"
# Run the tool
outRas = TopHatTransform(inRaster, inNeighborhood, inAnalysisType)
# Save the output
outRas.save("C:/sapyexamples/output/thtout02.tif")
环境
自动提交 , 像元大小 , 像元大小投影方法 , 压缩 , 当前工作空间 , 范围 , 地理变换 , 掩膜 , 输出配置关键字 , 输出坐标系 , 临时工作空间 , 捕捉栅格 , 分块大小
许可信息
基本: 需要 Spatial Analyst
标准: 需要 Spatial Analyst
高级: 需要 Spatial Analyst