Reclass by Table
Release 9.2 Last modified January 3, 2008	Print all topics in : "Reclass (Spatial Analyst)"

Reclassifies or changes the values of the input cells of a raster using a remap table.

Usage tips

Command line and Scripting

• The input raster must have valid statistics. If the statistics do not exist, they can be created in two ways. The first is to right-click the raster in ArcCatalog and click Calculate Statistics. The other is to open the Data Management Tools toolbox, Raster toolset, Calculate Statistics tool in ArcToolbox.

• 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 an INFO table, a .dbf file, an Access table, or a text 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 field of the table must be sorted in ascending order and should not overlap.

• The output raster will always be of integer type.

• The following environment settings affect this tool:

  • General: Current Workspace, Scratch Workspace, Output Coordinate system, Output Extent (and Snap Raster).
  • Raster Analysis: Cell size, Mask.
  • Raster Storage: See the Raster Storage settings for the particular output raster format selected.

Command line syntax
An overview of the Command Line window
ReclassByTable_sa <in_raster> <in_remap_table> <from_value_field> <to_value_field> <output_value_field> <out_raster> {DATA | NODATA}

Parameter	Explanation	Data Type
<in_raster>	An input raster. The values contained in this raster will be the values to be reclassified.	Composite Geodataset
<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 in_remap_table.	Field
<to_value_field>	Field holding the ending value for each value range to be reclassified. This is a numeric field of in_remap_table.	Field
<output_value_field>	Field holding the integer values to which each range should be changed. This is an integer field of in_remap_table.	Field
<out_raster>	The raster to be created.	Raster Dataset
{DATA | NODATA}	Denotes whether missing values in the reclass table retain their value or get mapped to NoData. DATA  — A keyword signifying 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. NODATA  — A keyword signifying 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

Data types for geoprocessing tool parameters

Command line example

ReclassByTable_sa c:/data/ras_1 c:/data/ReclassTable FromFld ToFld New_name c:/data/final_1 DATA

Scripting syntax
About getting started with writing geoprocessing scripts
ReclassByTable_sa (in_raster, in_remap_table, from_value_field, to_value_field, output_value_field, out_raster, missing_values)

Parameter	Explanation	Data Type
in_raster (Required)	An input raster. The values contained in this raster will be the values to be reclassified.	Composite Geodataset
in_remap_table (Required)	Table holding fields defining value ranges to be reclassified and the values they will become.	Table View
from_value_field (Required)	Field holding the beginning value for each value range to be reclassified. This is a numeric field of in_remap_table.	Field
to_value_field (Required)	Field holding the ending value for each value range to be reclassified. This is a numeric field of in_remap_table.	Field
output_value_field (Required)	Field holding the integer values to which each range should be changed. This is an integer field of in_remap_table.	Field
out_raster (Required)	The raster to be created.	Raster Dataset
missing_values (Optional)	Denotes whether missing values in the reclass table retain their value or get mapped to NoData. DATA  — A keyword signifying 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. NODATA  — A keyword signifying 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

Data types for geoprocessing tool parameters

Script example

# ReclassByTable.py
# Description: 
#   Reclassifies (or changes) the values of the input cells of a 
#   raster by using a remap table.
# Requirements: None
# Author: ESRI
# Date: Sept 6, 2005
# Import system modules
import arcgisscripting

# Create the Geoprocessor object
gp = arcgisscripting.create()

try:
    # Set the input files
    inRaster = "c:/data/ras_1"
    reclassByTable = "c:/data/ReclassTable"

    # Set the output raster name
    outRaster = "c:/data/final_1"

    # Check out ArcGIS Spatial Analyst extension license
    gp.CheckOutExtension("Spatial")

    # Process: ReclassByTable
    gp.ReclassByTable_sa(inRaster, reclassByTable, "FromFld", "ToFld", "New_name", outRaster, "DATA")

except:
    # If an error occurred while running a tool, then print the messages
    print gp.GetMessages()

Map Algebra syntax
See Reclass

ArcObjects syntax
See Reclass

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.