Available with Spatial Analyst license.
Available with 3D Analyst license.
Summary
Reclassifies (or changes) the values of the input cells of a raster using a remap table.
Usage
The input raster must have valid statistics. If the statistics do not exist, they can be created using the Calculate Statistics tool in the Data Management toolbox.
The From value field, To value field, and Output value field are the field names in the table that define the remapping.
To reclassify individual values, use a simple remap table of two items. The first item identifies the value to reclassify, and the other item identifies the value to assign to it. Set the To value field the same as the From value field. The value to assign to the output is Output value field.
To reclassify ranges of values, the remap table must have items defining the start and end of each range, along with the value to assign the range. The item defining the start of the range is the From value field, and the value defining the end of the range is the To value field. The value to assign to the output is Output value field.
The remap table can be a geodatabase table, a text file, an INFO table, or a dbase file.
The values in the from and to fields can be any numerical item. The assignment values in the output field must be integers.
Values in the From value field for .dbf, INFO, and Geodatabase tables do not need to be sorted. For text-file based tables, they must be sorted in ascending order. The values should not overlap in either case.
See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.
Syntax
ReclassByTable(in_raster, in_remap_table, from_value_field, to_value_field, output_value_field, {missing_values})| Parameter | Explanation | Data Type |
in_raster | The input raster to be reclassified. | Raster Layer |
in_remap_table | Table holding fields defining value ranges to be reclassified and the values they will become. | Table View |
from_value_field | Field holding the beginning value for each value range to be reclassified. This is a numeric field of the input remap table. | Field |
to_value_field | Field holding the ending value for each value range to be reclassified. This is a numeric field of the input remap table. | Field |
output_value_field | Field holding the integer values to which each range should be changed. This is an integer field of the input remap table. | Field |
missing_values (Optional) | Denotes whether missing values in the reclass table retain their value or get mapped to NoData.
| Boolean |
Return Value
| Name | Explanation | Data Type |
| out_raster | The output reclassified raster. The output will always be of integer type. | Raster |
Code sample
ReclassByTable example 1 (Python window)
This example uses a remap table to reclassify the input raster.
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")
ReclassByTable example 2 (stand-alone script)
This example uses a remap table to reclassify the input raster.
# 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")
Environments
Licensing information
- Basic: Requires Spatial Analyst or 3D Analyst
- Standard: Requires Spatial Analyst or 3D Analyst
- Advanced: Requires Spatial Analyst or 3D Analyst