Reclass by Table (Spatial Analyst)

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.

  • See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.

Parameters

LabelExplanationData 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
Change missing values to NoData
(Optional)

Denotes whether missing values in the reclass table retain their value or get mapped to NoData.

  • Unchecked—Signifies that if any cell location on the input raster contains a value not present or reclassed in a remap table, the value should remain intact and be written for that location to the output raster. This is the default.
  • Checked—Signifies that if any cell location on the input raster contains a value not present or reclassed in a remap table, the value will be reclassed to NoData for that location on the output raster.
Boolean

Return Value

LabelExplanationData Type
Output raster

The output reclassified raster.

The output will always be of integer type.

Raster

ReclassByTable(in_raster, in_remap_table, from_value_field, to_value_field, output_value_field, {missing_values})
NameExplanationData 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.

  • DATASignifies that if any cell location on the input raster contains a value not present or reclassed in a remap table, the value should remain intact and be written for that location to the output raster. This is the default.
  • NODATASignifies that if any cell location on the input raster contains a value not present or reclassed in a remap table, the value will be reclassed to NoData for that location on the output raster.
Boolean

Return Value

NameExplanationData 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"

# Execute Reclassify
outRaster = ReclassByTable(inRaster, inRemapTable,"FROM","TO","OUT","NODATA")

# Save the output 
outRaster.save("C:/sapyexamples/output/recslope")

Licensing information

  • Basic: Requires Spatial Analyst or 3D Analyst
  • Standard: Requires Spatial Analyst or 3D Analyst
  • Advanced: Requires Spatial Analyst or 3D Analyst

Related topics