Reclasser par fichier ASCII (ArcGIS Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence 3D 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 de type entier. Si les valeurs d’attribution en sortie dans le fichier ASCII sont des valeurs à virgule flottante, 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 définissant les valeurs uniques ou les plages à reclasser ainsi que les valeurs futures.

Les fichiers de classification ASCII prennent en charge les extensions .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 se voient attribuer la valeur NoData.

  • Désactivé : signifie que si un quelconque emplacement de cellule dans le raster en entrée contient une valeur qui n’est pas présente ou reclassée dans le fichier de classification, la valeur ne doit pas être modifiée et doit être enregistrée pour cet emplacement dans le raster en sortie. Il s’agit de l’option par défaut.
  • Activé : signifie que si un quelconque emplacement de cellule dans le raster en entrée contient une valeur qui n’est pas présente ou 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 définissant les valeurs uniques ou les plages à reclasser ainsi que les valeurs futures.

Les fichiers de classification ASCII prennent en charge les extensions .rmp, .txt et .asc.

File
missing_values
(Facultatif)

Indique si les valeurs manquantes dans le fichier de reclassement conservent leur valeur ou si elles se voient attribuer la valeur 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 reclassée dans le fichier de classification, la valeur ne doit pas être modifiée et 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 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")