Shift (Data Management)
Summary
Moves (slides) the raster to a new geographic location, based on x and y shift values. This tool is helpful if your raster dataset needs to be shifted to align with another data file.
Illustration
Usage
-
The cell size of the output raster will be the same as that of the input raster.
-
The number of rows and columns in the output raster will be the same as those of the input raster, no matter what parameters are specified.
-
The coordinates of the lower left corner of the output raster will be offset from the input raster by the x and y shift coordinate values specified.
-
Using a negative shift x-coordinate value will shift the output to the left. A positive shift x-coordinate value will shift the output to the right. Using a negative shift y-coordinate value will shift the output down. A positive shift y-coordinate value will shift the output to the top.
-
The output raster dataset is nudged according to the location of the input snap raster, so the new shifted raster dataset can be aligned perfectly with another raster dataset.
-
Shift does not perform any resampling or warping.
-
You can save your output to BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, or any geodatabase raster dataset.
-
When storing your raster dataset to a JPEG file, a JPEG 2000 file, or a geodatabase, you can specify a Compression type and Compression Quality within the Environment Settings.
Syntax
Parameter | Explanation | Data Type |
in_raster |
The input raster dataset. | Mosaic Layer; Raster Layer |
out_raster |
Output raster dataset. When storing the raster dataset in a file format, you need to specify the file extension:
When storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. When storing your raster dataset to a JPEG file, a JPEG 2000 file, a TIFF file, or a geodatabase, you can specify a compression type and compression quality. | Raster Dataset |
x_value |
The value used to shift the x coordinates. | Double |
y_value |
The value used to shift the y coordinates. | Double |
in_snap_raster (Optional) |
The raster dataset used to align the cells of the output raster dataset. | Raster Layer |
Code Sample
This is a Python sample for the Shift tool.
import arcpy
arcpy.Shift_management("c:/data/image.tif", "c:/output/shift.tif", "100",\
"150", "snap.tif")
This is a Python script sample for the Shift tool.
##====================================
##Shift
##Usage: Shift_management in_raster out_raster x_value y_value {in_snap_raster}
try:
import arcpy
arcpy.env.workspace = r"C:/Workspace"
##Shift a TIFF image by 4.5 in X direction and 6 in Y direction
##Snap the output to a existing raster dataset
arcpy.Shift_management("image.tif", "shift.tif", "4.5", "6", "snap.tif")
except:
print "Shift example failed."
print arcpy.GetMessages()
Environments
- Snap Raster
If the snap raster is set in the tool and also in the Environment Settings, the snap raster from the tool will be used.