| 标注 | 说明 | 数据类型 |
输入特征文件 | 其类特征可用于生成树状图的输入特征文件。 需要使用 .gsg 扩展名。 | File |
输出树状图文件 | 输出树状图 ASCII 文件。 扩展名可以是 .txt 或 .asc。 | File |
在距离计算中使用方差 (可选) | 指定多维属性空间中各类之间的距离的定义方式。
| Boolean |
树状图的线宽度 (可选) | 通过行字符数设置树状图宽度。 默认值为 78。 | Long |
需要 Spatial Analyst 许可。
使用情况
输入特征文件必须采用预定的特征文件格式。特征文件可使用 Iso 聚类或创建特征工具来创建。该文件必须至少包含两个类。可通过 .gsg 扩展名来识别特征文件。
树状图的输出是一个 ASCII 文本文件。该文件包含两部分：表和图形。
第一部分是以合并顺序显示各类对之间距离的表。第二部分是使用类的 ASCII 字符的图形表达，用来演示合并关系和等级。图形说明了特征文件中合并类对之间的相对距离，这些距离均基于统计得到的相似度。这些类本身表示像元簇或提取自研究区域的训练样本中的像元。
通过分析图形和关联表，可确定合并类的可能性。
输出文本文件的默认扩展名为 .txt。此外还可以使用 .asc。
特征文件中某对类的邻近程度可通过属性距离来测量。
输入的行宽度值将根据字符数指定图形宽度。默认值 78 同时还是最小的有效字符数。如果输入的数值小于此值，则将应用默认值 78。如果指定值大于此默认值，则图形分辨率将提高，这可能会实现更精确的距离插值。
要使树状图的显示内容具有意义，应采用非比例字体（如 Courier）来显示 ASCII 文件。
参数
Dendrogram(in_signature_file, out_dendrogram_file, {distance_calculation}, {line_width})| 名称 | 说明 | 数据类型 |
in_signature_file | 其类特征可用于生成树状图的输入特征文件。 需要使用 .gsg 扩展名。 | File |
out_dendrogram_file | 输出树状图 ASCII 文件。 扩展名可以是 .txt 或 .asc。 | File |
distance_calculation (可选) | 指定多维属性空间中各类之间的距离的定义方式。
| Boolean |
line_width (可选) | 通过行字符数设置树状图宽度。 默认值为 78。 | Long |
代码示例
本例将采用输入特征文件创建“树状图”视图。
import arcpy
from arcpy.sa import *
Dendrogram("c:/sapyexamples/data/zsamp12.gsg",
"c:/sapyexamples/output/z12dendro.txt", "VARIANCE", "")本例将采用输入特征文件创建“树状图”视图。
# Name: Dendrogram_Ex_02.py
# Description: Constructs a tree diagram showing attribute distances between
# sequentially merged classes in a signature file.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set local variables
inSig = "c:/sapyexamples/data/zsamp12.gsg"
outDendro = "c:/sapyexamples/output/z12dend.txt"
lineLength = ""
# Execute Dendrogram
Dendrogram(inSig, outDendro, "VARIANCE", lineLength)