Disponible avec une licence Spatial Analyst.
Résumé
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 prend en compte 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
en regard de Canaux raster en entrée, ouvrez le raster, puis sélectionnez les canaux souhaités. - 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 le bouton
Pour plus d'informations sur les environnements de géotraitement qui s'appliquent à cet outil, reportez-vous à la rubrique Environnements d'analyse et Spatial Analyst.
Syntaxe
CreateSignatures (in_raster_bands, in_sample_data, out_signature_file, {compute_covariance}, {sample_field})| 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. Ils peuvent être de type entier ou à virgule flottante. | 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
Premier exemple d'utilisation de l'outil CreateSignatures (fenêtre Python)
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", "")
Deuxième exemple d'utilisation de l'outil CreateSignatures (script autonome)
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)
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst