Créer des signatures (Spatial Analyst)
Récapitulatif
Crée un fichier de signatures ASCII des classes définies par les données d'échantillonnage en entrée et un jeu de canaux raster.
Utilisation
-
Vous devez attribuer l'extension .gsg aux fichiers de signatures en sortie.
-
Les canaux raster en entrée et les rasters en entrée ou les données d'échantillonnage doivent avoir des étendues superposées. Les statistiques seront calculées uniquement pour la zone commune.
-
Le nombre minimal d'échantillons de classes dans les données d'échantillonnage est deux. Il n'existe aucun nombre maximal de classes.
-
Si vous comptez utiliser le fichier de signatures dans une analyse multivariée qui fait intervenir des matrices de covariance, notamment Classification de vraisemblance maximale et Probabilité de classe, vous devez utiliser des matrices de covariance. Ces informations sont générées lorsque vous sélectionnez l'option Calculer les matrices de covariance dans la boîte de dialogue ou que vous inscrivez COVARIANCE dans le script. Notez bien qu'il s'agit du paramètre par défaut. Reportez-vous à la rubrique Fonctionnement de l'outil Créer des signatures pour comparer les fichiers de signatures lorsque les matrices de covariance sont uniquement créées par rapport aux moyennes.
-
Vous ne devez rien modifier dans le fichier de signatures, sauf si vous souhaitez indiquer les noms des classes. Les statistiques dans le fichier doivent être créées et être modifiées uniquement à l'aide des outils Multivariés.
-
Les noms des classes dans le fichier de signatures en sortie sont facultatifs. Ils n'apparaissent qu'à titre consultatif. Vous pouvez les entrer dans le Champ d'échantillonnage ou les ajouter au fichier de signatures résultant à l'aide d'un éditeur de texte. Chaque nom de classe doit comprendre une chaîne unique qui n'excède pas 31 caractères alphanumériques.
-
Si l'entrée est une couche créée à partir d'un raster multicanal comportant plus de trois canaux, l'opération considérera tous les canaux associés au jeu de données source, et non pas seulement les trois canaux qui ont été chargés (symbolisés) par la couche.
Vous pouvez employer plusieurs méthodes pour spécifier un sous-ensemble de canaux à partir d'un raster multicanal en vue de l'utiliser en entrée dans l'outil.
- Si vous utilisez la boîte de dialogue de l'outil, accédez au raster multicanal en cliquant sur
le bouton Parcourir qui se trouve à côté de l'option Canaux raster en entrée, ouvrez le raster et sélectionnez les canaux de votre choix. - Si le raster multicanal est une couche dans la table des matières, vous pouvez utiliser l'outil Générer une couche raster pour créer une couche multicanal contenant uniquement les canaux souhaités.
- Vous pouvez également faire appel à l'option Canaux composites pour créer un jeu de données contenant uniquement les canaux souhaités et utiliser le jeu de données résultant en entrée dans l'outil.
- Dans Python, vous pouvez spécifier les canaux de votre choix sous forme de liste directement dans le paramètre de l'outil.
- Si vous utilisez la boîte de dialogue de l'outil, accédez au raster multicanal en cliquant sur
Syntaxe
| Paramètre | Explication | Type de données |
in_raster_bands [in_raster_band,...] |
Canaux raster en entrée pour lesquels les signatures seront créées. | Raster Layer |
in_sample_data |
Entrée délimitant le jeu d'échantillons de classes. Cette entrée peut être un raster d'entiers ou un jeu de données d'entité. | Raster Layer | Feature Layer |
out_signature_file |
Fichier de signatures en sortie. Une extension .gsg doit être spécifiée. | File |
compute_covariance (Facultatif) |
Indique si les matrices de covariance sont calculées en plus des moyennes.
| Boolean |
sample_field (Facultatif) |
Champ du raster en entrée ou données vectorielles d'échantillonnage pour attribuer des valeurs aux localisations échantillonnées (classes). Seuls les champs contenant des entiers ou des chaînes sont admis. Le nombre ou la chaîne spécifiés serviront de nom de classe dans le fichier de signatures en sortie. | Field |
Exemple de code
Cet exemple décrit la création d'un fichier de signatures pour les classes définies par des surfaces échantillonnées et des canaux raster en entrée.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
CreateSignatures("sb", "sbtrain", "c:/sapyexamples/output/rbsig.gsg",
"COVARIANCE", "")
Cet exemple décrit la création d'un fichier de signatures pour les classes définies par des surfaces échantillonnées et des canaux raster en entrée.
# Name: CreateSignatures_Ex_02.py
# Description: Creates an ASCII signature file of classes defined by input
# sample data and a set of raster bands.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "sb"
inSamples = "sbtrain"
outSig = "c:/sapyexamples/output/rbsig02.gsg"
sampField = ""
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute CreateSignatures
CreateSignatures(inRaster, inSamples, outSig, "COVARIANCE", sampField)