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

Rescale_management (in_raster, out_raster, x_scale, y_scale)

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: .bil—Esri BIL .bip—Esri BIP .bmp—BMP .bsq—Esri BSQ .dat—ENVI DAT .gif—GIF .img—ERDAS IMAGINE .jpg—JPEG .jp2—JPEG 2000 .png—PNG .tif—TIFF no extension for 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, Resampling Method, NoData

Licensing Information

ArcGIS for Desktop Basic: Yes

ArcGIS for Desktop Standard: Yes

ArcGIS for Desktop Advanced: Yes