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ètre | Explication | Type 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.
| Boolean |
Valeur renvoyée
Nom | Explication | Type 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Reclassify
outRaster = ReclassByTable(inRaster, inRemapTable,"FROM","TO","OUT","NODATA")
# Save the output
outRaster.save("C:/sapyexamples/output/recslope")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst ou 3D Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst ou 3D Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst ou 3D Analyst