Reproject function

Overview

The Reproject function modifies the projection of a raster dataset, mosaic dataset, or raster item in a mosaic dataset. It can also resample the data to a new cell size and define an origin.

Notes

The x,y origin is typically used to enforce pixel alignment between multiple scenes, as in a cache. Therefore, if two images use the same origin and pixel sizes, the pixels from the resampled images will coincide exactly in the overlap area, even if they came from images with different pixel sizes.

The Reproject function can be used when creating a cache from a raster or mosaic dataset that is not in the required projection. For example, when creating a cached image service that may be integrated by applications with other cached services, it's important that they all be in the same projection, such as a Web Mercator projection. Since the mosaic dataset cannot be reprojected, you can do one of two things—either create a referenced mosaic dataset from your mosaic dataset in the projection needed, or add the Reproject function to the mosaic dataset's function chain. Another example uses this function on the raster item in a mosaic dataset. When using the Cached Raster function, you may want to insert the Reproject function so the cache is created in the new projection. Raster items in a mosaic dataset can be cached when the processing is compute-intensive and you are trying to publish an image service that is fast, without caching the entire image service.

You can also use the Reproject function if you're working with a raster or mosaic dataset via a scripting environment that needs to be reprojected.

Parameters

Parameter nameDescription

Raster

The raster to be reprojected or resampled.

Spatial Reference

The coordinate system used to reproject the data.

X Cellsize

The x-dimension to which the data should be resampled. This is optional. If the value is 0 or less, the output envelope (extent and cell sizes) is calculated from the input raster.

Y Cellsize

The y-dimension to which the data should be resampled. This is optional. If the value is 0 or less, the output envelope (extent and cell sizes) is calculated from the input raster.

X Registration Point

The x-coordinate used to define the upper left corner of the dataset. This coordinate must be defined in the units of the new spatial reference. If both the X Cellsize and Y Cellsize parameters are greater than 0, they are used along with the X Registration Point and Y Registration Point parameters to define the output envelope.

Y Registration Point

The y-coordinate used to define the upper left corner of the dataset. This coordinate must be defined in the units of the new spatial reference. If both the X Cellsize and Y Cellsize parameters are greater than 0, they are used along with the X Registration Point and Y Registration Point parameters to define the output envelope.

Related topics


In this topic
  1. Overview
  2. Notes
  3. Parameters