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}, {replacement_value})
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

The output values of the corresponding input_ranges parameter value.

(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 or to a replacement value.

  • True—Any pixel from the input raster that is not 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 is not reclassed in a remap table will have its value remapped to NoData or to a replacement value for its location to the output raster.

(The default value is True)

Boolean
replacement_value

The value that will replace missing or unmatched values in the output when the allow_unmatched parameter is set to False.

(The default value is None)

Double
Return Value
Data TypeExplanation
Raster

The output raster.

Code sample

Remap example 1

This example reclassifies the input raster.

from arcpy.sa 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.sa 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")

Related topics