Disponible avec une licence 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 signature peut se reconnaître 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
Dendrogram (in_signature_file, out_dendrogram_file, {distance_calculation}, {line_width})| 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. L'extension .gsg est obligatoire. | 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
Premier exemple d'utilisation de l'outil Dendogramme (fenêtre Python)
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", "")
Deuxième exemple d'utilisation de l'outil Dendogramme (script autonome)
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)
Environnements
Informations de licence
- ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst
- ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
- ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst