Reclass by ASCII File (Spatial Analyst)

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 Tools 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.

Syntax

ReclassByASCIIFile (in_raster, in_remap_file, {missing_values})

Parameter	Explanation	Data 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. DATA — 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. NODATA — A keyword signifying 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

Name	Explanation	Data Type
out_raster	The output reclassified raster. The output will always be of integer type.	Raster

Code Sample

ReclassByASCIIFile example 1 (Python window)

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"

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

# Execute Reclassify
outRaster = ReclassByASCIIFile(inRaster, inRemapFile)

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

Environments

Cell Size, Current Workspace, Mask, Output Coordinate System, Extent, Scratch Workspace, Snap Raster

Licensing Information

ArcGIS for Desktop Basic: Requires Spatial Analyst or 3D Analyst

ArcGIS for Desktop Standard: Requires Spatial Analyst or 3D Analyst

ArcGIS for Desktop Advanced: Requires Spatial Analyst or 3D Analyst