Label | Explanation | Data Type |
Input raster | The input raster to be reclassified. | Raster Layer |
Input 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 |
Output raster |
The output reclassified raster. The output will always be of integer type. | Raster Dataset |
Change missing values to NoData (Optional) | Denotes whether missing values in the reclass table retain their value or get mapped to NoData.
| Boolean |
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, you can create them 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, 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 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.
Parameters
arcpy.ddd.ReclassByTable(in_raster, in_remap_table, from_value_field, to_value_field, output_value_field, out_raster, {missing_values})
Name | 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 |
out_raster |
The output reclassified raster. The output will always be of integer type. | Raster Dataset |
missing_values (Optional) | Denotes whether missing values in the reclass table retain their value or get mapped to NoData.
| Boolean |
Code sample
This example uses a remap table to reclassify the input raster.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.ReclassByTable_3d("slope","remapslope","C:/sapyexamples/output/recslope",
"FROM","TO","OUT", "NODATA")
This example uses a remap table to reclassify the input raster.
# Name: ReclassByTable_Ex_02.py
# Description: Reclassifies the values of the input raster using a remap table.
# Requirements: 3D Analyst Extension
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "slope"
inRemapTable = "remapslope"
outRaster = "C:/output/recslope"
# Execute Reclassify
arcpy.ddd.ReclassByTable(inRaster, inRemapTable, outRaster, "FROM","TO","OUT",
"NODATA")
Environments
Licensing information
- Basic: Requires 3D Analyst or Spatial Analyst
- Standard: Requires 3D Analyst or Spatial Analyst
- Advanced: Requires 3D Analyst or Spatial Analyst