Dendrogramme (Outils Spatial Analyst)

Résumé

Crée un diagramme (dendogramme) affichant les distances attributaires entre des classes combinées séquentiellement dans un fichier de signatures.

En savoir plus sur le fonctionnement du dendrogramme

Utilisation

Le fichier de signatures en entrée doit être dans le format de fichier de signatures prescrit. Un fichier de signatures peut être créé avec les outils Iso Cluster (Agrégat ISO) ou Create Signatures (Créer des signatures). Ce fichier doit avoir un minimum de deux classes. Un fichier de signatures se reconnaît à son extension .gsg.
La sortie de Dendrogram (Dendrogramme) est un fichier texte ASCII. Le fichier possède deux composants : un tableau et un diagramme.

Le premier composant consiste en un tableau des distances entre paires de classes, présenté dans la séquence de fusion. Le second composant consiste en une représentation graphique utilisant les caractères ASCII des classes et illustrant les relations et la hiérarchie de la fusion. Le graphique illustre les distances relatives entre les paires de classes fusionnées dans le fichier de signatures, qui sont basées sur des similarités déterminées statistiquement. Les classes elles-mêmes représentent des agrégats de cellules ou des cellules provenant d’échantillons d’apprentissage extraits du site d’étude.

En analysant le diagramme et la table associée, vous pouvez déterminer le potentiel de fusion des classes.
L’extension par défaut du fichier texte en sortie est .txt. Elle peut également être .asc.
La proximité d’une paire de classes dans un fichier signatures est mesurée par la distance d’attribut.
La valeur saisie pour la largeur de ligne spécifie la largeur du diagramme en fonction du nombre de caractères. La valeur par défaut de 78 est également le nombre minimum valide de caractères. Si des nombres inférieurs sont saisis, la valeur par défaut de 78 est appliquée. Lors de la spécification de valeurs supérieures à la valeur par défaut, la résolution du diagramme augmente, ce qui peut permettre une interpolation plus précise des distances.
Pour donner un sens à l’affichage du dendrogramme, le fichier ASCII doit être affiché dans une police non proportionnelle telle que Courier.

Etiqueter	Explication	Type de données
Fichier de signatures en entrée	Fichier de signatures en entrée dont les signatures de classes sont utilisées pour produire un dendrogramme. L’extension `.gsg` est obligatoire.	File
Fichier de dendrogramme en sortie	Fichier ASCII de dendrogramme en sortie. L’extension peut être .txt ou .asc.	File
Utiliser la variance dans les calculs de distance (Facultatif)	Spécifie la façon dont sont définies les distances entre les classes dans un espace attributaire multidimensionnel. Activé—Les distances entre les classes sont calculées à partir des variances et de la distance euclidienne entre les moyennes de leurs signatures. Il s’agit de l’option par défaut. Décoché—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})

Nom	Explication	Type de données
in_signature_file	Fichier de signatures en entrée dont les signatures de classes sont utilisées pour produire un dendrogramme. L’extension `.gsg` est obligatoire.	File
out_dendrogram_file	Fichier ASCII de dendrogramme en sortie. L’extension peut être .txt ou .asc.	File
distance_calculation (Facultatif)	Spécifie la façon dont sont définies les distances entre les classes dans un espace attributaire multidimensionnel. `VARIANCE`—Les distances entre les classes sont calculées à partir des variances et de la distance euclidienne entre les moyennes de leurs signatures. Il s’agit de l’option par défaut. `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

Dendrogram Exemple 1 (fenêtre Python)

Cet exemple utilise un fichier de signatures en entrée et crée une vue dendrogramme.

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

Dendrogram Exemple 2 (script autonome)

Cet exemple utilise un fichier de signatures en entrée et crée une vue dendrogramme.

# 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 = ""

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

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence