Reclasser par table (Spatial Analyst)
Récapitulatif
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 Champ de la valeur de départ, Champ de la valeur d'arrivée et 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 le même contenu dans "Champ de la valeur d'arrivée" et dans "Champ de la valeur de départ". La valeur à affecter à la sortie est celle du "Champ de la valeur d'arrivée".
-
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 le Champ de la valeur de départ, et la valeur qui définit la fin de la plage est le Champ de la valeur d'arrivée. La valeur à affecter à la sortie est celle du Champ de valeurs en sortie.
-
La table de classification peut être une table INFO, un fichier .dbf, une table Access ou un fichier texte.
-
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 du champ 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.
Syntaxe
| 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
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")
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")