Disponible avec une licence Spatial Analyst.
Résumé
Reclasse (ou modifie) les valeurs d'un raster.
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.
Si une plage de valeurs doit être reclassifiée, les plages ne doivent pas se superposer, sauf au niveau de la limite de deux plages en entrée. En cas de superposition, la limite supérieure de la plage en entrée la plus basse est inclusive et la limite inférieure de la plage en entrée la plus élevée est exclusive.
Par exemple, si deux plages sont définies, par exemple pour reclassifier les valeurs 1 à 5 en 100 et les valeurs 5 à 100 en 200, une valeur en entrée inférieure ou égale à 5 se verra attribuer la valeur 100 dans la sortie, et une valeur en entrée qui est supérieure à 5 (par exemple 5,01) se verra attribuée la valeur 200.
Dans l'outil, vous pouvez utiliser l'option Enregistrer pour enregistrer la table de classification sous forme de table INFO et l'utiliser ultérieurement.
Utilisez l'option Charger pour recharger les tables de classification créées précédemment avec le bouton Enregistrer.
Il est recommandé de charger uniquement les tables enregistrées via l'outil Reclassification. Le format de la table est spécifique et doit contenir les champs FROM, TO, OUT et MAPPING.
Si le raster en entrée contient une table attributaire, elle servira à créer la table de reclassification initiale. Si le raster en entrée ne contient pas de table attributaire, une table de reclassification sera créée en appliquant tout d'abord des paramètres d'environnement de géotraitement concernant l'étendue, la taille de cellule et la numérisation du raster.
Lorsque le raster en entrée est une couche de la table des matières, la table de reclassification par défaut importe les valeurs uniques ou les valeurs de borne classées telles que spécifiées par la symbologie de couche. Sinon, la table de reclassification utilise par défaut les bornes naturelles avec neuf classes.
Une fois que la table de classification de la reclassification a été modifiée, elle ne sera pas mise à jour si un nouveau raster en entrée est sélectionné. Si la reclassification n'est pas adaptée au nouveau raster, procédez comme suit pour réinitialiser une nouvelle reclassification :
- Modifiez ou sélectionnez un champ pour le champ de reclassement afin d'invoquer une nouvelle reclassification par défaut.
- Sélectionnez et supprimez les entrées de classification et ajoutez manuellement les nouvelles valeurs.
- Sélectionnez les options de classification ou de valeurs uniques pour générer une nouvelle reclassification.
Cet outil est doté d'un contrôle de précision qui gère la façon dont sont traitées les décimales.
Lorsque vous rédigez un script et que le raster en sortie est consigné dans un dossier, il le sera au format TIFF.
Les formats de raster en entrée avec des valeurs de cellules double précision (64 bits) sont pris en charge.
Lorsque vous utilisez l'outil Reclassification dans le cadre d'un modèle
- Si l'entrée de l'outil correspond à des données dérivées d'un outil qui n'a pas encore été exécuté, le paramètre de classification de l'outil Reclassification sera vide jusqu'à ce que l'outil précédent soit exécuté et le modèle validé. Pour éviter cette situation, exécutez toujours les outils précédents avant de connecter leurs variables en sortie en tant qu'entrée de l'outil Reclassification. Vous pouvez aussi créer une table de reclassification personnalisée en ajoutant des entrées.
- Si vous exposez la table de reclassification en tant que paramètre de modèle, le champ de reclassement doit être exposé en tant que variable. Il n'est toutefois pas nécessaire de la définir comme paramètre de modèle. Si le champ n'est pas exposé en tant que variable, les boutons Valeurs uniques et Classer seront désactivés dans la boîte de dialogue de l'outil du modèle.
Par défaut, cet outil tire parti des processeurs à plusieurs cœurs. Le nombre maximal de cœurs pouvant être utilisés est limité à quatre.
Si vous souhaitez que l'outil utilise moins de cœurs, utilisez le paramètre d'environnement Facteur de traitement parallèle.
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
Reclassify (in_raster, reclass_field, remap, {missing_values})| Paramètre | Explication | Type de données |
in_raster | Raster en entrée à reclasser. | Raster Layer |
reclass_field | Champ permettant d'identifier les valeurs à reclasser. | Field |
remap | L'objet Classification permet de spécifier comment reclasser des valeurs du raster en entrée. Il existe deux méthodes pour définir la façon dont les valeurs seront reclassées dans le raster en sortie : RemapRange et RemapValue. L'une ou l'autre des plages de valeurs en entrée peut être affectée à une nouvelle valeur en sortie, ou des valeurs individuelles peuvent être affectées à une nouvelle valeur en sortie. Les formules des objets de classification sont indiquées ci-après.
| Remap |
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 d'utilisation de l'outil Reclassification (fenêtre Python)
Les exemples ci-dessous illustrent plusieurs façons de reclassifier un raster.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outReclass1 = Reclassify("landuse", "Value",
RemapValue([[1,9],[2,8],[3,1],[4,6],[5,3],[6,3],[7,1]]))
outReclass1.save("C:/sapyexamples/output/landuse_rcls")
outReclass2 = Reclassify("slope_grd", "Value",
RemapRange([[0,10,"NODATA"],[10,20,1],[20,30,2],
[30,40,3],[40,50,4],[50,60,5],[60,75,6]]))
outReclass2.save("C:/sapyexamples/output/slope_rcls")
outReclass3 = Reclassify("pop_density", "Value",
RemapRange([[10,10,1],[10,20,2],[20,25,3],
[25,50,4],[50,]]), "NODATA")
outReclass3.save("C:/sapyexamples/output/popden_rcls")
2è exemple d'utilisation de l'outil Reclassification (script autonome)
Cet exemple reclasse le raster en entrée selon les valeurs d'un champ de type chaîne.
# Name: reclassify_example02.py
# Description: Reclassifies the values in a raster.
# 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 = "landuse"
reclassField = "LANDUSE"
remap = RemapValue([["Brush/transitional", 0], ["Water", 1],["Barren land", 2]])
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Reclassify
outReclassify = Reclassify(inRaster, reclassField, remap, "NODATA")
# Save the output
outReclassify.save("C:/sapyexamples/output/outreclass02")
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