Dendrogram (Spatial Analyst)
Zusammenfassung
Erstellt ein Strukturdiagramm (Dendrogramm), das Attributentfernungen zwischen in regelmäßiger Folge zusammengeführten Klassen in einer Signaturdatei anzeigt.
Weitere Informationen zur Funktionsweise des Werkzeugs "Dendrogram"
Verwendung
-
Die Eingabesignaturdatei muss im vorgeschriebenen Signaturdateiformat vorliegen. Eine Signaturdatei kann mit den Werkzeugen Iso Cluster bzw. Create Signatures erstellt werden. Die Datei muss mindestens zwei Klassen aufweisen. Signaturdateien lassen sich an ihrer Erweiterung .gsg erkennen.
-
Die Ausgabe von Dendrogram ist eine ASCII-Textdatei. Die Datei verfügt über zwei Komponenten: eine Tabelle und ein Diagramm.
Die erste Komponente ist eine Tabelle von Entfernungen zwischen Paaren von Klassen, die in der Reihenfolge für die Zusammenführung dargestellt werden. Die zweite Komponente ist eine grafische Darstellung mit ASCII-Zeichen der Klassen, die die Beziehungen und die Hierarchie der Zusammenführung veranschaulicht. Das Diagramm illustriert relative Entfernungen zwischen Paaren zusammengeführter Klassen in der Signaturdatei, die auf statistisch ermittelten Ähnlichkeiten basieren. Die Klassen selbst stellen Cluster von Zellen oder Zellen aus Trainingsgebieten dar, die aus dem Untersuchungsgebiet extrahiert wurden.
Durch Analysieren von Diagramm und zugehöriger Tabelle können Sie das Potenzial der Klassenzusammenführung bestimmen.
-
Die Standarderweiterung für die Ausgabetextdatei ist .txt. Es kann jedoch auch .asc verwendet werden.
-
Die Nähe eines Paars von Klassen innerhalb einer Signaturdatei wird anhand der Attributentfernung gemessen.
-
Der für die Zeilenbreite eingegebene Wert gibt die Breite des Diagramms auf der Grundlage der Anzahl der Zeichen an. Der Standardwert 78 ist gleichzeitig die auch die zulässige Mindestanzahl an Zeichen. Wenn kleinere Werte eingegeben werden, wird der Standardwert 78 angewendet. Bei Eingabe von höheren Werten als dem Standardwert, erhöht sich die Auflösung des Diagramms, wodurch möglicherweise eine genauere Interpolation der Entfernungen bewirkt wird.
-
Um eine aussagekräftige Dendrogramm-Anzeige zu bewirken, sollte die ASCII-Datei mit einer nichtproportionalen Schriftart, z. B. Courier, angezeigt werden.
Syntax
| Parameter | Erläuterung | Datentyp |
in_signature_file |
Eingabesignaturdatei, deren Klassensignaturen verwendet werden, um ein Dendrogramm zu erzeugen. Die Erweiterung .gsg ist erforderlich. | File |
out_dendrogram_file |
Die Ausgabe-ASCII-Datei des Dendrogramms. Die Erweiterung kann .txt oder .asc sein. | File |
distance_calculation (optional) |
Gibt die Art und Weise an, in der die Entfernungen zwischen Klassen im mehrdimensionalem Attributraum definiert werden.
| Boolean |
line_width (optional) |
Legt die Breite des Dendrogramms als Anzahl der Zeichen in einer Zeile fest. Die Standardeinstellung ist 78. | Long |
Codebeispiel
In diesem Beispiel wird eine Eingabesignaturdatei zur Erstellung einer Dendrogram-Ansicht verwendet.
import arcpy
from arcpy.sa import *
Dendrogram("c:/sapyexamples/data/zsamp12.gsg",
"c:/sapyexamples/output/z12dendro.txt", "VARIANCE", "")
In diesem Beispiel wird eine Eingabesignaturdatei zur Erstellung einer Dendrogram-Ansicht verwendet.
# 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)