Dendrogramme (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

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.

Paramètres

ÉtiquetteExplicationType de données
Fichier de signature en entrée

Fichier de signatures en entrée dont les signatures de classes servent à créer un dendrogramme.

L’extension .gsg est obligatoire.

File
Fichier de dendrogramme en sortie

Fichier ASCII du dendrogramme en sortie.

Vous pouvez employer l'extension .txt ou .asc.

File
Utiliser la variance dans les calculs de distance
(Facultatif)

Indique la façon dont les distances entre des classes d'un espace attributaire multidimensionnel sont définies.

  • Activé : les distances entre les classes sont calculées à partir des variances et de la distance euclidienne entre les moyennes des signatures de classes.
  • Désactivé : les distances entre les classes sont déterminées uniquement par les distances euclidiennes entre les moyennes des signatures de classes.
Boolean
Largeur de ligne du dendrogramme
(Facultatif)

Définit la largeur du dendrogramme en nombre de caractères par ligne.

La valeur par défaut est 78.

Long

Dendrogram(in_signature_file, out_dendrogram_file, {distance_calculation}, {line_width})
NomExplicationType 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.

  • VARIANCE Les distances entre les classes sont calculées à partir des variances et de la distance euclidienne entre les moyennes des signatures de classes.
  • MEAN_ONLY Les distances entre les classes sont déterminées uniquement par les distances euclidiennes entre les moyennes des signatures de classes.
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 = ""

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

Rubriques connexes