Reclass by ASCII File (3D 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 worksLearn more about how Reclass by ASCII File works

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

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

arcpy.ddd.ReclassByASCIIFile(in_raster, in_remap_file, out_raster, {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
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 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.
  • NODATASignifies 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")
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:/data"
arcpy.ReclassByASCIIFile_3d("slope","remapslope.rmp","C:/output/recslope")
ReclassByASCIIFile example 2 (stand-alone script)

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

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

# Execute Reclassify
arcpt.ReclassByASCIIFile_3d(inRaster, inRemapFile, outRaster)

Related topics