Dendrogramm (Spatial Analyst Tools)

Zusammenfassung

Erstellt ein Strukturdiagramm (Dendrogramm), das Attributentfernungen zwischen in regelmäßiger Folge zusammengeführten Klassen in einer Signaturdatei anzeigt.

Weitere Informationen zur Funktionsweise von "Dendrogramm"

Verwendung

Die Eingabe-Signaturdatei muss im vorgeschriebenen Format für Signaturdateien vorliegen. Signaturdateien können mit den Werkzeugen Iso-Cluster oder Signaturen erstellen erstellt werden. Die Datei muss mindestens zwei Klassen aufweisen. Eine Signaturdatei lässt sich an der Erweiterung .gsg erkennen.
Die Ausgabe von Dendrogramm ist eine ASCII-Textdatei. Die Datei besteht aus zwei Teilen: einer Tabelle und einem Diagramm.

Der erste Bestandteil ist eine Tabelle mit den Abständen zwischen Klassenpaaren, die in der Reihenfolge der Zusammenführung dargestellt sind. Der zweite Bestandteil ist eine grafische Darstellung der Klassen unter Verwendung von ASCII-Zeichen, die die Beziehungen und die Hierarchie der Zusammenführung veranschaulicht. Das Diagramm veranschaulicht die relativen Abstände zwischen Paaren zusammengeführter Klassen in der Signaturdatei, die auf statistisch ermittelten Ähnlichkeiten beruhen. Die Klassen selbst stellen Zellen-Cluster oder Zellen aus Trainingsgebieten dar, die dem zu untersuchenden Standort entnommen wurden.

Anhand der Auswertung des Diagramms und der Tabelle mit der Zuordnung können Sie das Potenzial für eine Zusammenführung von Klassen ermitteln.
Die Standarderweiterung für die Ausgabedatei lautet .txt. Es kann aber auch sein, dass sie .asc lautet.
Die Nähe zweier Klassen innerhalb einer Signaturdatei wird anhand der Attributentfernung gemessen.
Der für die Linienbreite eingegebene Wert legt die Breite des Diagramms auf der Grundlage der Zeichenanzahl fest. Der Standardwert von 78 ist zugleich die Mindestanzahl gültiger Zeichen. Werden niedrigere Werte eingegeben, wird der Standardwert 78 verwendet. Wenn Sie Werte angeben, die über dem Standardwert liegen, erhöht sich die Auflösung des Diagramms, was zu einer genaueren Interpolation der Entfernungen führen kann.
Damit die Darstellung des Dendrogramms aussagekräftig ist, sollte die ASCII-Datei mit einer nichtproportionalen Schriftart wie beispielsweise Courier angezeigt werden.

Beschriftung	Erläuterung	Datentyp
Eingabe-Signaturdatei	Eingabe-Signaturdatei, deren Klassensignaturen verwendet werden, um ein Dendrogramm zu erzeugen. Die Erweiterung `.gsg` ist erforderlich.	File
Ausgabe-Dendrogramm-Datei	Die Ausgabe-ASCII-Datei des Dendrogramms. Die Erweiterung kann .txt oder .asc sein.	File
Varianz in den Entfernungsberechnungen verwenden (Optional)	Gibt die Art und Weise an, in der die Entfernungen zwischen Klassen im multidimensionalen Attributraum definiert werden. Aktiviert—Die Entfernungen zwischen Klassen werden auf Grundlage der Varianzen und der euklidischen Entfernung zwischen den Mittelwerten ihrer Signaturen berechnet. Dies ist die Standardeinstellung. Deaktiviert—Die Entfernungen zwischen Klassen werden ausschließlich durch die euklidischen Entfernungen zwischen den Mittelwerten der Klassensignaturen berechnet.	Boolean
Linienstärke des Dendrogramms (Optional)	Legt die Breite des Dendrogramms als Anzahl der Zeichen in einer Zeile fest. Die Standardeinstellung ist 78.	Long

Dendrogram(in_signature_file, out_dendrogram_file, {distance_calculation}, {line_width})

Name	Erläuterung	Datentyp
in_signature_file	Eingabe-Signaturdatei, 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 multidimensionalen Attributraum definiert werden. `VARIANCE`—Die Entfernungen zwischen Klassen werden auf Grundlage der Varianzen und der euklidischen Entfernung zwischen den Mittelwerten ihrer Signaturen berechnet. Dies ist die Standardeinstellung. `MEAN_ONLY`—Die Entfernungen zwischen Klassen werden ausschließlich durch die euklidischen Entfernungen zwischen den Mittelwerten der Klassensignaturen berechnet.	Boolean
line_width (Optional)	Legt die Breite des Dendrogramms als Anzahl der Zeichen in einer Zeile fest. Die Standardeinstellung ist 78.	Long

Codebeispiel

Dendrogram Beispiel 1 (Python-Fenster)

In diesem Beispiel wird anhand einer eingegebenen Signaturdatei eine Dendrogramm-Ansicht erstellt.

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

Dendrogram Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird anhand einer eingegebenen Signaturdatei eine Dendrogramm-Ansicht erstellt.

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

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

Umgebungen

Aktueller Workspace, Scratch-Workspace

Lizenzierungsinformationen