| Étiquette | Explication | Type de données |
Canaux raster en entrée | Canaux raster en entrée pour lesquels les signatures seront créées. Ils peuvent être de type entier ou à virgule flottante. | Raster Layer |
Données d’échantillonnage de raster ou d’entité en entrée | 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 |
Fichier de signatures en sortie | Fichier de signatures en sortie. Une extension .gsg doit être spécifiée. | File |
Calculer les matrices de covariance (Facultatif) | Indique si les matrices de covariance sont calculées en plus des moyennes.
| Boolean |
Champ d’échantillonnage (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 |
Disponible avec une licence Spatial Analyst.
Synthèse
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
Lorsqu’un raster multicanal est spécifié comme l’un des canaux raster en entrée (Input raster bands) (in_raster_bands dans Python), tous les canaux sont utilisés.
Pour traiter une sélection de canaux à partir d’un raster multicanal, vous pouvez créer en premier un jeu de données raster composé de ces canaux spécifiques à l’aide de l’outil Canaux composites et utilisez le résultat dans la liste des canaux raster en entrée (Input raster bands) (in_raster_bands dans Python).
Vous devez utiliser l’extension .gsg pour les fichiers de signature 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 l’option Calculer les matrices de covariance est activée dans la boîte de dialogue ou que l’option COVARIANCE est spécifiée 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.
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.
Paramètres
CreateSignatures(in_raster_bands, in_sample_data, out_signature_file, {compute_covariance}, {sample_field})| Nom | 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
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 = ""
# Execute CreateSignatures
CreateSignatures(inRaster, inSamples, outSig, "COVARIANCE", sampField)Environnements
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?