Reclass by ASCII File (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 an ASCII remap file.

Learn more about how Reclass by ASCII File works

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 output raster will always be of integer type. If the output assignment values in the ASCII file are floating-point values, an error message will be returned and the program will halt.

  • 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 ASCII remap file

ASCII remap file defining the single values or ranges to be reclassified and the values they will become.

Allowed extensions for the ASCII remap files are .rmp, .txt, and .asc.

File
Change missing values to NoData
(Optional)

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

  • Unchecked—Signifies that if any cell location on the input raster contains a value that is not present or reclassed in the remap file, 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 that is not present or reclassed in the remap file, 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

ReclassByASCIIFile(in_raster, in_remap_file, {missing_values})
NameExplanationData Type
in_raster

The input raster to be reclassified.

Raster Layer
in_remap_file

ASCII remap file defining the single values or ranges to be reclassified and the values they will become.

Allowed extensions for the ASCII remap files are .rmp, .txt, and .asc.

File
missing_values
(Optional)

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

  • DATASignifies that if any cell location on the input raster contains a value that is not present or reclassed in the remap file, the value should remain intact and be written for that location to the output raster. This is the default.
  • NODATA Signifies that if any cell location on the input raster contains a value that is not present or reclassed in the remap file, 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

ReclassByASCIIFile example 1 (Python window)

This example uses an ASCII remap file to reclassify the input raster.

import arcpy
from arcpy.sa import *
from arcpy import env  
env.workspace = "C:/sapyexamples/data"
outReclass = ReclassByASCIIFile("slope","remapslope.rmp")
outReclass.save("C:/sapyexamples/output/recslope")
ReclassByASCIIFile example 2 (stand-alone script)

This example uses an ASCII remap file to reclassify the input raster.

# Name: reclassbyasciifile_example02.py
# Description: Reclassifies  values of the input raster using an ASCII remap file
# 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"
inRemapFile = "remapslope.rmp"

# Execute Reclassify
outRaster = ReclassByASCIIFile(inRaster, inRemapFile)

# 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