Reclasser par table (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence 3D Analyst.

Résumé

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 Calculer les statistiques de la boîte à outils Outils de gestion des données.

  • Les noms des champs de la table qui définissent la classification sont 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 valeurs en sortie).

  • Pour reclasser des valeurs individuelles, utilisez une table de classification simple de deux éléments. Le premier élément identifie la valeur à reclasser, le deuxième identifie la valeur à lui affecter. Définissez la même valeur dans Champ de la valeur d’arrivée et dans 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 avoir des éléments qui définissent le début et la fin de chaque plage, avec 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), et 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, une table INFO ou un fichier dbase.

  • Les valeurs des champs de départ et d'arrivée peuvent être des éléments numériques quelconques. Les valeurs d'attribution du champ en sortie doivent être des nombres entiers.

  • Les valeurs indiquées dans From value field (Champ de la valeur de départ) pour les tables .dbf, INFO et de géodatabase n'ont pas besoin d'être triées. Elles doivent en revanche être triées dans l'ordre croissant pour les tables basées sur un fichier texte. Dans les deux cas, les valeurs ne doivent pas se superposer.

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

Syntaxe

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

Raster en entrée à reclasser.

Raster Layer
in_remap_table

Table contenant des champs définissant les plages de valeurs à reclasser ainsi que leurs futures valeurs.

Table View
from_value_field

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

Il s'agit d'un champ numérique de la table de reclassification en entrée.

Field
to_value_field

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

Il s'agit d'un champ numérique de la table de reclassification en entrée.

Field
output_value_field

Champ contenant les valeurs entières que chaque plage doit adopter.

Il s'agit d'un champ entier de la table de reclassification 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

1er exemple de la commande 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")
2è exemple de la commande 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")

Informations de licence

  • Basic: Requiert Spatial Analyst ou 3D Analyst
  • Standard: Requiert Spatial Analyst ou 3D Analyst
  • Advanced: Requiert Spatial Analyst ou 3D Analyst

Rubriques connexes