Modifier des signatures (Outils Spatial Analyst)

Résumé

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

En savoir plus sur le fonctionnement de l’outil Modifier des signatures

Utilisation

L’outil Edit Signatures (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 multibande est spécifié comme l’un des éléments Input raster bands (Bandes raster en entrée) (in_raster_bands dans Python), toutes les bandes sont utilisées.

Pour traiter une sélection de bandes à partir d’un raster multibande, vous pouvez créer en premier un jeu de données raster composé de ces bandes spécifiques à l’aide de l’outil Bandes composites puis utiliser le résultat dans la liste Input raster bands (Bandes raster en entrée) (in_raster_bands dans Python).
The input signature file must be an ASCII signature file. The file can be the output of any Multivariate tool that produces the file containing the required statistical information—par exemple, Iso Cluster (Agrégat Iso) et Create Signatures (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 :

``<!--

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.
Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Etiqueter	Explication	Type de données
Bandes 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 `-->.rmp`, `.asc` or `.txt`. The default is `.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})

Nom	Explication	Type 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 `-->.rmp`, `.asc` or `.txt`. The default is `.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

Exemple 1 d’utilisation de la fonction -->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", "")

Exemple 2 d’utilisation de la fonction -->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 = ""

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

Environnements

Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Espace de travail courant, Etendue, Transformations géographiques, Masque, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture

Informations de licence