Reclasser par table (ArcGIS Spatial Analyst)

Synthèse

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

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).

  • From value field (Champ de la valeur de départ), To value field (Champ de la valeur d’arrivée) et Output value field (Champ de la valeur en sortie) sont les noms de champ qui définissent la classification dans la table.

  • Pour reclasser des valeurs individuelles, utilisez une table de classification simple composée de deux éléments. Le premier élément identifie la valeur à reclasser, tandis que le deuxième identifie la valeur à lui affecter. Affectez les mêmes valeurs aux options To value field (Champ de la valeur d’arrivée) et From value field (Champ de la valeur de départ). La valeur à affecter à la sortie est Output value field (Champ de la valeur en sortie).

  • Pour reclasser des plages de valeurs, la table de classification doit comporter des éléments qui définissent le début et la fin de chaque plage, ainsi que la valeur à affecter à la plage. L’élément qui définit le début de la plage est From value field (Champ de la valeur de départ), tandis que la valeur qui définit la fin de la plage est To value field (Champ de la valeur d’arrivée). La valeur à affecter à la sortie est Output value field (Champ de la valeur en sortie).

  • La table de classification peut être une table de géodatabase, un fichier texte ou un fichier dbase.

  • Les valeurs dans les champs de départ et d’arrivée peuvent être n’importe quel élément numérique. Les valeurs d’affectation dans le champ en sortie doivent être des entiers.

  • Les valeurs situées dans From value field (Champ de la valeur de départ) pour .dbf et les tables de géodatabase n’ont pas besoin d’être triées. Pour les tables basées sur un fichier texte, elles doivent être triées par ordre croissant. Les valeurs ne doivent en aucun cas être superposées.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Raster en entrée à reclasser.

Raster Layer
Table de classification en entrée

Table contenant les champs qui définissent les plages de valeurs à reclasser et les valeurs qui seront générées.

Table View
Champ de la valeur de départ

Champ contenant la valeur de début pour chaque plage de valeurs à reclasser.

Champ numérique de la table de classification en entrée.

Field
Champ de la valeur d’arrivée

Champ contenant la valeur de fin pour chaque plage de valeurs à reclasser.

Champ numérique de la table de classification en entrée.

Field
Champ de la valeur en sortie

Champ contenant les valeurs entières qui doivent remplacer chaque plage.

Champ entier de la table de classification en entrée.

Field
Remplacer les valeurs manquantes par NoData
(Facultatif)

Indique si les valeurs manquantes dans la table 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 une table 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 une table 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

ReclassByTable(in_raster, in_remap_table, from_value_field, to_value_field, output_value_field, {missing_values})
NomExplicationType de données
in_raster

Raster en entrée à reclasser.

Raster Layer
in_remap_table

Table contenant les champs qui définissent les plages de valeurs à reclasser et les valeurs qui seront générées.

Table View
from_value_field

Champ contenant la valeur de début pour chaque plage de valeurs à reclasser.

Champ numérique de la table de classification en entrée.

Field
to_value_field

Champ contenant la valeur de fin pour chaque plage de valeurs à reclasser.

Champ numérique de la table de classification en entrée.

Field
output_value_field

Champ contenant les valeurs entières qui doivent remplacer chaque plage.

Champ entier de la table de classification en entrée.

Field
missing_values
(Facultatif)

Indique si les valeurs manquantes dans la table 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 une table 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 une table 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 ReclassByTable (fenêtre Python)

Cet exemple utilise une table de classification pour reclasser le raster en entrée.

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

Cet exemple utilise une table de classification pour reclasser le raster en entrée.

# Name: reclassbytable_example02.py
# Description: Reclassifies the values of the input raster using a remap table.
# 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"
inRemapTable = "remapslope"

# Execute Reclassify
outRaster = ReclassByTable(inRaster, inRemapTable,"FROM","TO","OUT","NODATA")

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