Dendrograma (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Construye un diagrama de árbol (dendrograma) que muestra las distancias de los atributos entre clases fusionadas secuencialmente en un archivo de firma.

Más información sobre cómo funciona Dendrograma

Uso

• El archivo de firma de entrada debe tener el formato de archivo de firma prescrito. Puede crear un archivo de firma con las herramientas Cluster ISO o Crear firmas. El archivo debe incluir un mínimo de dos clases. Un archivo de firma se puede reconocer por la extensión .gsg.

• El resultado del Dendrograma es un archivo de texto ASCII. El archivo tiene dos componentes: una tabla y un gráfico.

  El primer componente es una tabla de distancias entre pares de clases, presentadas en la secuencia para fusión. El segundo componente es una representación gráfica de las clases, hecha con caracteres ASCII, que demuestra las relaciones y la jerarquía de la fusión. El gráfico ilustra las distancias relativas entre los pares de clases fusionadas en el archivo de firma, las cuales están basadas en similitudes determinadas estadísticamente. Las clases en sí mismas representan clusters de celdas o celdas de muestras de capacitación extraídas del sitio de estudio.

  Si analiza el gráfico y la tabla asociada, puede determinar el potencial de las clases fusionadas.

• La extensión predeterminada para el archivo de texto de salida es .txt. También pude ser .asc.

• La proximidad de un par de clases dentro de un archivo de firma se calcula mediante la distancia de atributos.

• El valor introducido para el ancho de la línea especifica el ancho del gráfico según la cantidad de caracteres. El valor predeterminado de 78 también es la cantidad mínima de caracteres válida. Si introduce cantidades menores a ésta, se aplicará el valor predeterminado de 78. Si especifica valores mayores al predeterminado, la resolución del gráfico aumentará y podrá proporcionar una interpolación más exacta de las distancias.

• Para que la visualización del dendrograma sea significativa, el archivo ASCII debe visualizarse con una fuente no proporcional, como Courier.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
in_signature_file	El archivo de firma de entrada cuyas firmas de clase se utilizan para generar un dendrograma. Se requiere la extensión .gsg.	File
out_dendrogram_file	El archivo ASCII de dendrograma de salida. La extensión puede ser .txt o .asc.	File
distance_calculation (Opcional)	Especifica la forma en que se definen las distancias entre clases en un espacio de atributos multidimensionales. VARIANCE — Las distancias entre clases se calcularán según las varianzas y la distancia Euclidiana entre los valores medios de sus firmas. MEAN_ONLY — Las distancias entre clases se determinarán mediante las distancias Euclidianas entre los valores medios de las firmas de clase, solamente.	Boolean
line_width (Opcional)	Establece el ancho del dendrograma según la cantidad de caracteres en una línea. El valor predeterminado es 78.	Long

Muestra de código

Ejemplo 1 de Dendrograma (ventana de Python)

En este ejemplo se utiliza un archivo de firma de entrada y se crea una vista de Dendrograma.

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

Ejemplo 2 de Dendrograma (secuencia de comandos independiente)

En este ejemplo se utiliza un archivo de firma de entrada y se crea una vista de Dendrograma.

# 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)

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal

Información de licenciamiento

• Basic: Requiere Spatial Analyst
• Standard: Requiere Spatial Analyst
• Advanced: Requiere Spatial Analyst