Créer des signatures (Spatial Analyst)

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.

Pour plus d'informations sur l'outil Créer des signatures

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

ÉtiquetteExplicationType 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.

  • Activé : les matrices de covariance et les moyennes de toutes les classes de données d'échantillonnage en entrée sont calculées. Il s’agit de l’option par défaut.
  • Désactivé : seules les moyennes de toutes les classes de données d'échantillonnage en entrée sont calculées.
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

CreateSignatures(in_raster_bands, in_sample_data, out_signature_file, {compute_covariance}, {sample_field})
NomExplicationType 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.

  • COVARIANCELes matrices de covariance et les moyennes de toutes les classes de l'entrée in_sample_data sont calculées. Il s’agit de l’option par défaut.
  • MEAN_ONLYSeules les moyennes de toutes les classes de l'entrée in_sample_data sont calculées.
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 = ""

# Execute CreateSignatures
CreateSignatures(inRaster, inSamples, outSig, "COVARIANCE", sampField)

Rubriques connexes