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 the output to BIL, BIP, BMP, BSQ, DAT, Esri Grid, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, MRF, or CRF format, or any geodatabase raster dataset.

  • When storing a raster dataset to a JPEG format file, a JPEG 2000 format file, or a geodatabase, you can specify a Compression Type value and a Compression Quality value in the geoprocessing environments.

Parameters

LabelExplanationData Type
Input Raster

The input raster.

Mosaic Layer; Raster Layer
Output Raster Dataset

The output raster dataset.

When storing the raster dataset in a file format, specify the file extension as follows:

  • .bilEsri BIL
  • .bipEsri BIP
  • .bmp—BMP
  • .bsqEsri BSQ
  • .dat—ENVI DAT
  • .gif—GIF
  • .img—ERDAS IMAGINE
  • .jpg—JPEG
  • .jp2—JPEG 2000
  • .png—PNG
  • .tif—TIFF
  • .mrf—MRF
  • .crf—CRF
  • No extension for Esri Grid

When storing a raster dataset in a geodatabase, do not add a file extension to the name of the raster dataset.

When storing a raster dataset to a JPEG format file, a JPEG 2000 format file, a TIFF format file, or a geodatabase, you can specify Compression Type and Compression Quality values in the geoprocessing environments.

Raster Dataset
X Scale Factor

The factor by which to scale the cell size in the x direction.

The factor must be greater than zero.

Double
Y Scale Factor

The factor by which to scale the cell size in the y direction.

The factor must be greater than zero.

Double

arcpy.management.Rescale(in_raster, out_raster, x_scale, y_scale)
NameExplanationData Type
in_raster

The input raster.

Mosaic Layer; Raster Layer
out_raster

The output raster dataset.

When storing the raster dataset in a file format, specify the file extension as follows:

  • .bilEsri BIL
  • .bipEsri BIP
  • .bmp—BMP
  • .bsqEsri BSQ
  • .dat—ENVI DAT
  • .gif—GIF
  • .img—ERDAS IMAGINE
  • .jpg—JPEG
  • .jp2—JPEG 2000
  • .png—PNG
  • .tif—TIFF
  • .mrf—MRF
  • .crf—CRF
  • No extension for Esri Grid

When storing a raster dataset in a geodatabase, do not add a file extension to the name of the raster dataset.

When storing a raster dataset to a JPEG format file, a JPEG 2000 format file, a TIFF format file, or a geodatabase, you can specify Compression Type and Compression Quality values in the geoprocessing environments.

Raster Dataset
x_scale

The factor by which to scale the cell size in the x direction.

The factor must be greater than zero.

Double
y_scale

The factor by 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
    
import arcpy

arcpy.env.workspace = r"C:/Workspace"

##Rescale a TIFF image by a factor of 4 in both directions
arcpy.Rescale_management("image.tif", "rescale.tif", "4", "4")

Related topics