Dendrogramme (Spatial Analyst)
Récapitulatif
Crée un diagramme (dendogramme) affichant les distances attributaires entre des classes combinées séquentiellement dans un fichier de signatures.
Pour en savoir plus sur le fonctionnement de l'outil Dendrogramme
Utilisation
-
Le fichier de signatures en entrée doit correspondre au format prédéfini. Vous pouvez créer un fichier de signatures avec les outils Iso cluster ou Créer des signatures. Ce fichier doit avoir un minimum de deux classes. Un fichier de signatures peut être identifié par son extension .gsg.
-
La sortie de Dendrogramme est un fichier texte ASCII. Ce fichier comprend deux éléments : une table et un graphique.
Le premier élément est une table de distances entre paires de classes, présentées dans la séquence pour la combinaison. Le deuxième élément est une représentation graphique à l'aide de caractères ASCII des classes qui montrent les relations et la hiérarchie de la fusion. Le diagramme illustre des distances relatives entre paires de classes combinées dans le fichier de signatures, basées sur les ressemblances déterminées statistiquement. Les classes elles-mêmes représentent des agrégats de cellules ou de cellules d'échantillons d'apprentissage extraites du site étudié.
En analysant le diagramme et la table associée, vous pouvez déterminer la possibilité de la combinaison de classes.
-
L'extension par défaut du fichier texte en sortie est .txt. Vous pouvez également choisir l'extension .asc.
-
La proximité d'une paire de classes dans un fichier de signatures dépend de la distance attributaire.
-
La valeur que vous attribuez à une largeur de ligne régit la largeur du diagramme, selon le nombre de caractères. Par défaut, 78 est également le nombre minimal de caractères autorisé. Si vous saisissez des nombres inférieurs, la valeur 78 s'applique. Lorsque vous indiquez une valeur plus élevée que la valeur par défaut, vous augmentez la résolution du diagramme. Vous pouvez donc obtenir une interpolation plus précise des distances.
-
Pour que l'affichage du dendrogramme soit significatif, le fichier ASCII doit s'afficher avec une police de type Courrier.
Syntaxe
| Paramètre | Explication | Type de données |
in_signature_file |
Fichier de signatures en entrée dont les signatures de classes servent à créer un dendrogramme. Une extension .gsg est requise. | File |
out_dendrogram_file |
Fichier ASCII du dendrogramme en sortie. Vous pouvez employer l'extension .txt ou .asc. | File |
distance_calculation (Facultatif) |
Indique la façon dont les distances entre des classes d'un espace attributaire multidimensionnel sont définies.
| Boolean |
line_width (Facultatif) |
Définit la largeur du dendrogramme en nombre de caractères par ligne. La valeur par défaut est 78. | Long |
Exemple de code
Dans cet exemple, nous prenons un fichier de signatures pour créer un dendogramme.
import arcpy
from arcpy.sa import *
Dendrogram("c:/sapyexamples/data/zsamp12.gsg",
"c:/sapyexamples/output/z12dendro.txt", "VARIANCE", "")
Dans cet exemple, nous prenons un fichier de signatures pour créer un dendogramme.
# 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)