樹状図（Dendrogram） (Spatial Analyst)
使用法
-
入力シグネチャ ファイルは、既定のシグネチャ ファイル形式である必要があります。シグネチャ ファイルは、[ISO クラスタ（Iso Cluster）] または [シグネチャの作成（Create Signatures）] ツールを使用して作成できます。ファイルには、最低 2 つのクラスが必要です。シグネチャ ファイル拡張子は「.gsg」です。
-
[樹状図（Dendrogram）] の出力は、ASCII テキスト ファイルです。ファイルには、テーブルとグラフの 2 つのコンポーネントがあります。
最初のコンポーネントは、クラスの組の距離テーブルで、マージの順番で存在します。2 番目のコンポーネントは、クラスの ASCII 文字を使用したグラフィックス表現で、マージの関係と階層を示します。グラフは、シグネチャ ファイル内でマージされたクラスの組の相対的な距離を示し、統計的に判断された類似性に基づいています。クラス自体は、解析地域から抽出したトレーニング サンプルからのセルのクラスタまたはセルを表します。
グラフと関連テーブルを解析することで、クラスのマージの効果を判断できます。
-
出力テキスト ファイルのデフォルトの拡張子は、「.txt」です。また、「.asc」も使用できます。
-
シグネチャ ファイル内にあるクラスの組の近接は、属性距離によって計測されます。
-
ライン幅に入力した値は、文字数に基づくグラフの幅を指定します。デフォルト値の 78 は、最小有効文字数でもあります。これより小さい数値が入力された場合は、デフォルト値の 78 が適用されます。デフォルト値より大きな値が指定された場合、グラフの解像度が上がり、距離の内挿の精度が高まります。
-
樹状図の表示を意味あるものにするには、ASCII ファイルを Courier などの非プロポーショナル フォントで表示する必要があります。
構文
| パラメータ | 説明 | データ タイプ |
in_signature_file |
樹状図の作成に使用するクラス シグネチャのある入力シグネチャ ファイル 「.gsg」という拡張子が必須です。 | File |
out_dendrogram_file |
出力樹状図の ASCII ファイル。 使用できる拡張子は、「.txt」または「.asc」です。 | File |
distance_calculation (オプション) |
多次元属性空間におけるクラス間の距離の定義方法を指定します。
| Boolean |
line_width (オプション) |
樹状図の幅を、ライン上の文字数で設定します。 デフォルトは 78 です。 | Long |
コードのサンプル
次の例では、入力シグネチャ ファイルを使って Dendrogram（樹状図）のビューを作成しています。
import arcpy
from arcpy.sa import *
Dendrogram("c:/sapyexamples/data/zsamp12.gsg",
"c:/sapyexamples/output/z12dendro.txt", "VARIANCE", "")
次の例では、入力シグネチャ ファイルを使って Dendrogram（樹状図）のビューを作成しています。
# 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)