树状图 (空间分析)

摘要

构造可显示特征文件中连续合并类之间的属性距离的树示意图（树状图）。

了解有关“树状图”工作原理的详细信息

用法

• 输入特征文件必须采用预定的特征文件格式。特征文件可使用 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 (可选)	指定多维属性空间中各类之间的距离的定义方式。 VARIANCE — 各类之间的距离将根据其特征平均值之间的方差和欧氏距离来进行计算。 MEAN_ONLY — 各类之间的距离仅由类特征平均值之间的欧氏距离决定。	Boolean
line_width (可选)	通过行字符数设置树状图宽度。 默认值为 78。	Long

代码实例

Dendrogram 示例 1（Python 窗口）

本例将采用输入特征文件创建“树状图”视图。

import arcpy
from arcpy.sa import *
Dendrogram("c:/sapyexamples/data/zsamp12.gsg", 
           "c:/sapyexamples/output/z12dendro.txt", "VARIANCE", "")

Dendrogram 示例 2（独立脚本）

本例将采用输入特征文件创建“树状图”视图。

# 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 = ""

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Dendrogram
Dendrogram(inSig, outDendro, "VARIANCE", lineLength)

环境

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

许可信息

ArcGIS for Desktop Basic: 需要 Spatial Analyst

ArcGIS for Desktop Standard: 需要 Spatial Analyst

ArcGIS for Desktop Advanced: 需要 Spatial Analyst