Reclasser par fichier ASCII (ArcGIS Spatial Analyst)

Synthèse

Reclasse (ou modifie) les valeurs des cellules en entrée d'un raster en utilisant un fichier de classification ASCII.

En savoir plus sur le fonctionnement de l’outil Reclasser par fichier ASCII

Utilisation

  • Le raster en entrée doit présenter des statistiques valides. Si les statistiques n’existent pas, elles peuvent être créées à l’aide de l’outil Calculate Statistics (Calculer les statistiques ) de la boîte à outils Data Management (Gestion des données).

  • Le raster en sortie est toujours un entier. Si les valeurs d’affectation en sortie dans le fichier ASCII sont des virgules flottantes, un message d’erreur est renvoyé et le programme s’arrête.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Raster en entrée à reclasser.

Raster Layer
Fichier de classification ASCII en entrée

Fichier de classification ASCII qui définit les valeurs ou plages uniques à reclasser et les valeurs qui seront générées.

Les extensions autorisées pour les fichiers de classification ASCII sont .rmp, .txt et .asc.

File
Remplacer les valeurs manquantes par NoData
(Facultatif)

Indique si les valeurs manquantes dans le fichier de reclassement conservent leur valeur ou si elles sont appariées à NoData.

  • Désactivée - Signifie que si un quelconque emplacement de cellule dans le raster en entrée contient une valeur qui n’est pas présente ou qui n’est pas reclassée dans le fichier de classification, la valeur ne peut pas être modifiée et elle doit être enregistrée pour cet emplacement dans le raster en sortie. Il s’agit de l’option par défaut.
  • Activée - Signifie que si un quelconque emplacement de cellule dans le raster en entrée contient une valeur qui n’est pas présente ou qui n’est pas reclassée dans le fichier de classification, la valeur sera reclassée en NoData pour cet emplacement dans le raster en sortie.
Boolean

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie reclassé.

La sortie est toujours un nombre entier.

Raster

ReclassByASCIIFile(in_raster, in_remap_file, {missing_values})
NomExplicationType de données
in_raster

Raster en entrée à reclasser.

Raster Layer
in_remap_file

Fichier de classification ASCII qui définit les valeurs ou plages uniques à reclasser et les valeurs qui seront générées.

Les extensions autorisées pour les fichiers de classification ASCII sont .rmp, .txt et .asc.

File
missing_values
(Facultatif)

Indique si les valeurs manquantes dans le fichier de reclassement conservent leur valeur ou si elles sont appariées à NoData.

  • DATASignifie que si un quelconque emplacement de cellule dans le raster en entrée contient une valeur qui n’est pas présente ou qui n’est pas reclassée dans le fichier de classification, la valeur ne peut pas être modifiée et elle doit être enregistrée pour cet emplacement dans le raster en sortie. Il s’agit de l’option par défaut.
  • NODATASignifie que si un quelconque emplacement de cellule dans le raster en entrée contient une valeur qui n’est pas présente ou qui n’est pas reclassée dans le fichier de classification, la valeur sera reclassée en NoData pour cet emplacement dans le raster en sortie.
Boolean

Valeur renvoyée

NomExplicationType de données
out_raster

Raster en sortie reclassé.

La sortie est toujours un nombre entier.

Raster

Exemple de code

Exemple 1 d’utilisation de la fonction ReclassByASCIIFile (fenêtre Python)

Cet exemple utilise un fichier de classification ASCII pour reclasser le raster en entrée.

import arcpy
from arcpy.sa import *
from arcpy import env  
env.workspace = "C:/sapyexamples/data"
outReclass = ReclassByASCIIFile("slope","remapslope.rmp")
outReclass.save("C:/sapyexamples/output/recslope")
Exemple 2 d’utilisation de la fonction ReclassByASCIIFile (script autonome)

Cet exemple utilise un fichier de classification ASCII pour reclasser le raster en entrée.

# Name: reclassbyasciifile_example02.py
# Description: Reclassifies  values of the input raster using an ASCII remap file
# 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 = "slope"
inRemapFile = "remapslope.rmp"

# Execute Reclassify
outRaster = ReclassByASCIIFile(inRaster, inRemapFile)

# Save the output 
outRaster.save("C:/sapyexamples/output/recslope")