Resample function

Available with Image Server

The Resample function changes the raster pixel size, the resampling type, or both.

Before combining and analyzing rasters with different resolutions and map projections, it is often desirable to resample the data to a common resolution and projection.

Reprojecting an image to a different coordinate system creates an image pixel grid on an alignment other than the original image. A value for each pixel in the new image must be computed by sampling or interpolating over a neighborhood of pixels from the corresponding position in the original image.

Notes

This function is useful for converting raster datasets, raster products, and mosaic datasets to a common pixel size, projection, or resampling type.

The appropriate resampling method depends on the raster data type and purpose of the resulting raster dataset as follows:

  • Nearest Neighbor—This method is most appropriate for discrete data, such as a land-use classification, since it does not create new pixel values. Use this method for continuous data when you want to preserve the original reflectance values in imagery for accurate multispectral analysis. It is the most efficient in terms of processing time but may introduce small positional errors in the output image. The output image may be offset by up to half a pixel, which may cause the image to have discontinuities and a jagged appearance.

  • Bilinear Interpolation and Bilinear Interpolation Plus—These methods are most appropriate for continuous data. The output image is smoother in appearance than the result of Nearest Neighbor, but the reflectance values are altered, which results in blurring or loss of image resolution. Use Bilinear Interpolation Plus for tiled data because the edges will match better. These methods are relatively computationally efficient to process.
  • Cubic—This method is suitable for continuous data. The result is geometrically less distorted than the raster achieved with Nearest Neighbor, and sharper than Bilinear Interpolation. In some cases, it may result in output pixel values outside the range of input pixel values; if this is unacceptable, use the Bilinear Interpolation method instead. This method is computationally intensive and takes longer to process.

  • Majority—Suitable for discrete data, it results in a smoother appearance than the Nearest Neighbor resampling method. This method determines the value of the pixel based on the most frequent value in the filter window.

  • Gauss Blur and Gauss Blur Plus—Appropriate for both discrete and continuous data. These methods are effective in reducing noise in resampled radar and SAR imagery that is affected by speckling. These methods are also appropriate for reducing noise and artifacts in raster data that is being down-sampled to a larger pixel size. Use Gauss Blur Plus for tiled data for better edge matching.
  • Average—Suitable for continuous data, it produces a smoother output image than the Nearest Neighbor resampling method.

  • Minimum—Appropriate for continuous data, it produces a smoother output image than the Nearest Neighbor resampling method.

  • Maximum—Appropriate for continuous data, it produces a smoother output image than the Nearest Neighbor resampling method.

  • Vector Average—Used for resampling multidimensional magnitude-direction data only.

The input pixel cell size can be different than the source pixel cell size.

Parameters

ParameterDescription
Raster

The raster product to be resampled.

Resampling Type

  • Nearest Neighbor—Calculates the output pixel value using the nearest input pixel. NoData pixels will remain unchanged in the output raster dataset. This the default.

  • Bilinear Interpolation—Calculates the pixel value using the distance-weighted value of the four nearest pixels. This method is computationally efficient to process.

  • Cubic Convolution—Determines the new value of a pixel based on fitting a smooth curve through the 16 nearest input pixel centers.

  • Majority—Calculates pixel value using the majority pixel value in the 16 nearest pixels. NoData pixels will remain unchanged in the output raster dataset.

  • Bilinear Interpolation Plus—Uses Bilinear Interpolation, except the pixels along the edges, which are defined as NoData and are not replicated or considered in the calculation. Use Bilinear Interpolation Plus for tiled data because the edges will match better.

  • Gauss Blur—Applies a Gaussian convolution to the source raster and calculates pixel value using the distance-weighted value of four nearest pixels from the blurred raster. It is appropriate for removing noise in resampled data and for down-sampling to a larger pixel size.

  • Gauss Blur Plus—Uses the same method as Gauss Blur, except the pixels along the edges are defined as NoData and are not replicated or considered in the calculation. Use Gauss Blur Plus for tiled data because the edges will match better.

  • Average—Calculates pixel values using the average value of all overlapping pixels, for each target pixel.

  • Minimum—Calculates pixel value using the minimum value of all overlapping pixels. NoData pixels will remain unchanged in the output raster dataset.

  • Maximum—Appropriate for continuous data, it produces a smoother output image than the Nearest Neighbor resampling method.

  • Vector Average—Calculates vector average of magnitude-direction using all involved pixels. This method is only applicable for two band rasters that represent magnitude and direction. It first converts magnitude-direction into U-V, and it takes the arithmetic average across all involved pixels to get the U-V of the target pixel and converts it back to magnitude-direction.

Input Cellsize

The pixel cell size of the input raster, which can be different from the source pixel cell size.

Output Cellsize

The pixel cell size of the output raster. The cell size can be changed, but the extent of the raster dataset will remain the same. Resampling from a user-defined cell size can be much slower than the system default, since the system default resampling processes the minimum amount of data from the closest possible display resolution.


In this topic
  1. Notes
  2. Parameters