Resampling Method (Environment setting)

Resampling is the process of interpolating the pixel values while transforming your raster dataset. This is used when the input and output do not line up exactly, when the pixel size changes, when the data is shifted, or a combination of these reasons.

Usage notes

• The nearest neighbor option should be used for categorical data, since no new values are created.
• The bilinear and cubic options should not be used with categorical data, but produce better looking outputs for continuous data.

Dialog syntax

• Resampling method—Choose which resampling method to use when creating the output.
  • NEAREST—Performs a nearest neighbor assignment, is the fastest of the interpolation methods. It is used primarily for discrete data, such as a land-use classification, since it will not change the values of the cells. The maximum spatial error will be one-half the cell size.
  • BILINEAR—Performs a bilinear interpolation, determines the new value of a cell based on a weighted distance average of the four nearest input cell centers. It is useful for continuous data and will cause some smoothing of the data.
  • CUBIC—Performs a cubic convolution, determines the new value of a cell based on fitting a smooth curve through the 16 nearest input cell centers. It is appropriate for continuous data, although it may result in the output raster containing values outside the range of the input raster. It is geometrically less distorted than the raster achieved by running the nearest neighbor resampling algorithm. The disadvantage of the Cubic option is that it requires more processing time. In some cases, it can result in output cell values outside the range of input cell values. If this is unacceptable, use Bilinear instead.

Scripting syntax

arcpy.env.resample = "interpolation_type"

Parameters	Explanation
interpolation_type (Optional)	The resampling technique used: NEAREST—Uses the value of the closest cell to assign a value to the output cell when resampling. This is the default. BILINEAR—Determines the new value of a cell based on a weighted distance average of the four nearest input cell centers. CUBIC—Determines the new value of a cell based on fitting a smooth curve through the 16 nearest input cell centers.

pyramid syntax

import arcpy
# Set the resampling method environment to bilinear interpolation.
arcpy.env.resamplingmethod = "BILINEAR"