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, GIF, GRID, 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

Rescale_management (in_raster, out_raster, x_scale, y_scale)

Parameter	Explanation	Data Type
in_raster	The input raster dataset.	Raster Layer
out_raster	Output raster dataset. When storing the raster dataset in a file format, you need to specify the file extension: .bil—ESRI BIL .bip—ESRI BIP .bmp—BMP .bsq—ESRI BSQ .dat—ENVI DAT .gif—GIF .img—ERDAS IMAGINE file .jpg—JPEG .jp2—JPEG 2000 .png—PNG .tif—TIFF no extension—ESRI GRID 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

Rescale example 1 (Python window)

This is a Python sample for the Rescale tool.

import arcpy
arcpy.Rescale_management("c:/data/image.tif", "c:/output/rescale.tif", "4", "4")

Rescale example 2 (stand-alone window)

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()

Environments

Compression, Current Workspace, Output CONFIG Keyword, Output Coordinate System, Extent, Pyramid, Raster Statistics, Scratch Workspace, Snap Raster, Tile Size

Licensing Information

ArcView: Yes

ArcEditor: Yes

ArcInfo: Yes