Remap

Summary

Categorizes the pixel values of a raster object into groups with specific values.

For example, assign image values from 1 to 25 a value of 1, and image values from 200 to 255 a value of 255.

Discussion

For more information about how this function works, see the Remap raster function.

The referenced raster dataset for the raster object is temporary. To make it permanent, you can call the raster object's save method.

Syntax

Remap (raster, {input_ranges}, {output_values}, {no_data_ranges}, {allow_unmatched})
ParameterExplanationData Type
raster

The input raster.

Raster
input_ranges

Input ranges are specified in pairs: from (inclusive) and to (exclusive).

(The default value is None)

Double
output_values

Output values of corresponding input_ranges.

(The default value is None)

Double
no_data_ranges

NoData ranges are specified in pairs: from (inclusive) and to (exclusive).

(The default value is None)

Double
allow_unmatched

Missing values in the reclass table can retain their value or be remapped to NoData.

  • True—Any pixel from the input raster that does not get reclassed in a remap table will retain its value and be written for its location to the output raster.
  • False—Any pixel from the input raster that does not get reclassed in a remap table will have its value remapped to NoData for its location to the output raster.

(The default value is True)

Boolean
Return Value
Data TypeExplanation
Raster

The output raster.

Code sample

Remap example 1

This example reclassifies the input raster.

from arcpy.ia import *
out_remap_raster = Remap("NomalRaster.tif")
out_remap_raster.save("C:/arcpyExamples/raster_remap.tif")
Remap example 2

This example reclassifies the input raster.

# Import system modules
import arcpy
from arcpy.ia import *

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set Local Variables
in_raster = "raster.tif"

# Excute Remap function
out_remap_raster = Remap(in_raster, [-5, 0, 0, 5], [-1, 1])

# Save output
out_remap_raster.save("C:/arcpyExamples/outputs/raster_remap.tif")