Dendrogramm (Spatial Analyst)—ArcGIS Pro

Mit der Spatial Analyst-Lizenz verfügbar.

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 "Dendrogramm"

Verwendung

Die Eingabe-Signaturdatei muss im vorgeschriebenen Signaturdateiformat vorliegen. Eine Signaturdatei kann mit den Werkzeugen Iso-Cluster bzw. Signaturen erstellen erstellt werden. Die Datei muss mindestens zwei Klassen aufweisen. Signaturdateien lassen sich an ihrer Erweiterung .gsg erkennen.
Die Ausgabe von Dendrogramm 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 zeigt 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 Paares 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 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.

Parameter

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 mehrdimensionalen Attributraum definiert werden. Aktiviert – Die Entfernungen zwischen Klassen werden auf Grundlage der Varianzen und der euklidischen Entfernung zwischen den Mittelwerten ihrer Signaturen berechnet. Nicht aktiviert – 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 mehrdimensionalen Attributraum definiert werden. VARIANCE— Die Entfernungen zwischen Klassen werden auf Grundlage der Varianzen und der euklidischen Entfernung zwischen den Mittelwerten ihrer Signaturen berechnet. 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

Dendrogramm – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird eine Eingabe-Signaturdatei zur Erstellung einer Dendrogramm-Ansicht verwendet.

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

Dendrogramm – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird eine Eingabe-Signaturdatei zur Erstellung einer Dendrogramm-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 = ""

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

Umgebungen

Aktueller Workspace, Scratch-Workspace

Lizenzinformationen

Basic: Erfordert Spatial Analyst
Standard: Erfordert Spatial Analyst
Advanced: Erfordert Spatial Analyst