Modifier des signatures (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Met à jour un fichier de signatures en combinant, renumérotant et en supprimant les signatures de la classe.

Pour en savoir plus sur la fonction Modifier des signatures

Utilisation

  • L'outil Modifier des signatures permet de modifier un fichier de signatures, comme suit :

    • Combinaison des signatures d'un ensemble de classes
    • Renumérotation d'un identifiant de la classe de la signature
    • Suppression de signatures inutiles
  • 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).

  • Le fichier de signatures en entrée doit être un fichier au format ASCII. Ce fichier peut être le résultat que vous obtenez après avoir utilisé un outil Multivariés lorsque vous disposez des informations appropriées. Par exemple : Iso Cluster et Créer des signatures. Ce fichier doit avoir un minimum de deux classes. Ce type de fichier se reconnaît à son extension .gsg.

  • Le fichier de reclassement de signatures en entrée est un fichier ASCII composé de deux colonnes de valeurs par ligne, séparées par le signe deux points. La première colonne contient la valeur de l’ID de classe initial. La seconde colonne contient les nouveaux identifiants de classe à mettre à jour dans le fichier de signatures. Toutes les entrées figurant dans le fichier doivent être triées dans l'ordre croissant en fonction de la première colonne.

    Dans certains cas, certaines des classes que vous souhaitez peuvent être trop similaires les unes des autres statistiquement et l’affectation des cellules à des classes uniques peut ne pas s’avérer fiable. Par exemple, vous pouvez vouloir une classe de marécage et une classe distincte pour les marécages en forêt. Il est néanmoins difficile de distinguer ces deux classes. Dans ce cas, vous pouvez combiner la classe de marécage de forêt dans la classe de marécage plus générale. S’il n’existe aucune différence statistique entre les classes, vous pouvez en supprimer une puisqu’elles représentent toutes deux la même classe.

    Pour combiner un ensemble de classes, spécifiez le même identifiant de classe nouvelle comme deuxième valeur pour chaque identifiant de classe de cet ensemble. Un fichier de reclassement de signatures ne doit contenir que les classes que vous comptez modifier. Les classes qui ne figurent pas dans ce fichier ne sont pas modifiées. Pour supprimer une signature de classe, utilisez -9999 comme valeur pour la seconde colonne de cette classe. Vous pouvez également renuméroter un ID de classe en lui attribuant une valeur qui n'existe pas dans le fichier de signatures en entrée.

    Voici un exemple de fichier de reclassement de signatures en entrée :

    2 : 3
    4 : 11
    5 : -9999
    9 : 3

    Dans cet exemple, nous combinons les classes 2 et 9 avec la classe 3, la classe 4 avec la classe 11 et nous supprimons la classe 5.

  • Si le fichier de signatures en entrée désigne les noms des signatures de classes et que vous souhaitez combiner les signatures dans le fichier de classification en entrée, le nom associé à la valeur qui permet d'effectuer cette opération doit figurer dans le fichier de signatures en sortie.

  • 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 dont vous devez modifier les signatures.

Ils peuvent être de type entier ou à virgule flottante.

Raster Layer
Fichier de signatures en entrée

Fichier de signatures en entrée dans lequel vous pouvez modifier les signatures de classes.

L’extension .gsg est obligatoire.

File
Fichier de classification de signatures en entrée

Table de classification ASCII contenant les identifiants de classe à combiner, renuméroter ou supprimer.

L’extension peut être extension .rmp, .asc ou .txt. La valeur par défaut est .rmp.

File
Fichier de signatures en sortie

Fichier de signatures en sortie.

Une extension .gsg doit être spécifiée.

File
Intervalle d’échantillonnage
(Facultatif)

Intervalle à utiliser pour l’échantillonnage.

La valeur par défaut est 10.

Long

EditSignatures(in_raster_bands, in_signature_file, in_signature_remap_file, out_signature_file, {sample_interval})
NomExplicationType de données
in_raster_bands
[in_raster_band,...]

Canaux raster en entrée dont vous devez modifier les signatures.

Ils peuvent être de type entier ou à virgule flottante.

Raster Layer
in_signature_file

Fichier de signatures en entrée dans lequel vous pouvez modifier les signatures de classes.

L’extension .gsg est obligatoire.

File
in_signature_remap_file

Table de classification ASCII contenant les identifiants de classe à combiner, renuméroter ou supprimer.

L’extension peut être extension .rmp, .asc ou .txt. La valeur par défaut est .rmp.

File
out_signature_file

Fichier de signatures en sortie.

Une extension .gsg doit être spécifiée.

File
sample_interval
(Facultatif)

Intervalle à utiliser pour l’échantillonnage.

La valeur par défaut est 10.

Long

Exemple de code

Premier exemple d'utilisation de l'outil EditSignatures (fenêtre Python)

Cet exemple décrit la modification d'un fichier de signatures selon le fichier de classification en entrée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
EditSignatures("redl123", "c:/sapyexamples/data/zsamp12.gsg", 
               "c:/sapyexamples/data/zsamp7.rmp", 
               "c:/sapyexamples/output/redlremap.gsg", "")
Deuxième exemple d'utilisation de l'outil EditSignatures (script autonome)

Cet exemple décrit la modification d'un fichier de signatures selon le fichier de classification en entrée.

# Name: EditSignatures_Ex_02.py
# Description: Edits and updates a signature file by merging, renumbering, 
#    and deleting class signatures.
# 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 = "redl123"
oldSig = "c:/sapyexamples/data/zsamp12.gsg"
sigRemap = "c:/sapyexamples/data/zsamp7.rmp"
outNewSig = "c:/sapyexamples/output/redlsig.gsg"
interval = ""

# Execute EditSignatures
EditSignatures(inRaster, oldSig, sigRemap, outNewSig, interval)

Rubriques connexes