Rescale (Data Management)
Summary
Resizes a raster by the specified x and y scale factors.
Usage
-
The output size is multiplied by the scale factor for both the x and y directions. The number of columns and rows stays the same in this process, but the cell size is multiplied by the scale factor.
-
The scale factor must be positive.
-
A scale factor greater than one means the image will be rescaled to a larger dimension, resulting in a larger extent because of a larger cell size.
-
A scale factor less than one means the image will be rescaled to a smaller dimension, resulting in a smaller extent because of a smaller cell size.
-
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. | 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_scale |
The factor in which to scale the cell size in the x direction. The factor must be greater than zero. | Double |
y_scale |
The factor in which to scale the cell size in the y direction. The factor must be greater than zero. | Double |
Code Sample
This is a Python sample for the Rescale tool.
import arcpy
arcpy.Rescale_management("c:/data/image.tif", "c:/output/rescale.tif", "4", "4")
This is a Python script sample for the Rescale tool.
##====================================
##Rescale
##Usage: Usage: Rescale_management in_raster out_raster x_scale y_scale
try:
import arcpy
arcpy.env.workspace = r"C:/Workspace"
##Rescael a TIFF image by a factor of 4 in both directions
arcpy.Rescale_management("image.tif", "rescale.tif", "4", "4")
except:
print "Rescale example failed."
print arcpy.GetMessages()