Dendrograma (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.
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 archivos de firma. El archivo debe incluir un mínimo de dos clases. Puede reconocer un archivo de firma 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 la 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 puede 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
| 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 una 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.
| 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 |
Ejemplo de código
En este ejemplo se utiliza una 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", "")
En este ejemplo se utiliza una 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 = ""
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Dendrogram
Dendrogram(inSig, outDendro, "VARIANCE", lineLength)