Project Raster (Data Management)

License Level:BasicStandardAdvanced

Summary

Transforms the raster dataset from one projection to another.

Learn more about how Project Raster works

Usage

Syntax

ProjectRaster_management (in_raster, out_raster, out_coor_system, {resampling_type}, {cell_size}, {geographic_transform}, {Registration_Point}, {in_coor_system})
ParameterExplanationData Type
in_raster

The input raster dataset.

Mosaic Layer; Raster Layer
out_raster

The output raster dataset to be created.

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
out_coor_system

The coordinate system to which the input raster will be projected. The default value is set based on the Output Coordinate System environment setting.

Valid values for this parameter are

  • A file with the ".prj" extension (the prj files which ship with ArcGIS can be found in "C:\Program Files\ArcGIS\Coordinate Systems").
  • An existing feature class, feature dataset, raster catalog (basically anything with a coordinate system).
  • The string representation of a coordinate system. These lengthy strings can be generated by adding a coordinate system variable to ModelBuilder, setting the variable's value as desired, then exporting the model to a Python script.

Coordinate System
resampling_type
(Optional)

The resampling algorithm to be used. The default is NEAREST.

  • NEARESTNearest neighbor assignment
  • BILINEARBilinear interpolation
  • CUBICCubic convolution
  • MAJORITYMajority resampling

The NEAREST and MAJORITY options are used for categorical data, such as a land-use classification. The NEAREST option is the default since it is the quickest and also because it will not change the cell values. Do not use NEAREST or MAJORITY for continuous data, such as elevation surfaces.

The BILINEAR option and the CUBIC option are most appropriate for continuous data. It is not recommended that BILINEAR or CUBIC be used with categorical data because the cell values may be altered.

String
cell_size
(Optional)

The cell size for the new raster dataset.

The default cell size is the cell size of the selected raster dataset.

Analysis Cell Size
geographic_transform
(Optional)

The transformation method used between two geographic systems or datums.

The geographic transformation is optional when the input and output coordinate systems have the same datum. If the input and output datum are different, a geographic transformation needs to be specified.

For information on each supported geographic (datum) transformations, see the geographic_transformations.pdf located in <install location>\ArcGIS\Desktop10.1\Documentation.

String
Registration_Point
(Optional)

The x and y coordinates (in the output space) used for pixel alignment.

The registration point works similar to the concept of snap raster. Instead of snapping the output to an existing raster cell alignment, the registration point allows you to specify the origin point for anchoring the output cells. All output cells will be an interval of the cell size away from this point. This point does not have to be a corner coordinate or fall within the raster dataset.

The Snap Raster environment setting will take priority over the Registration Point parameter. Therefore, if you want to set the registration point, make sure that Snap Raster is not set.

Point
in_coor_system
(Optional)

The coordinate system of the input raster dataset.

Coordinate System

Code Sample

ProjectRaster example 1 (Python window)

This is a Python sample for the ProjectRaster tool.

import arcpy
from arcpy import env
arcpy.ProjectRaster_management("c:/data/image.tif", "c:/output/reproject.tif",\
                               "World_Mercator.prj", "BILINEAR", "5",\
                               "NAD_1983_To_WGS_1984_5", "#", "#")
ProjectRaster example 2 (stand-alone script)

This is a Python script sample for the ProjectRaster tool.

##====================================
##Project Raster
##Usage: ProjectRaster_management in_raster out_raster out_coor_system {NEAREST | BILINEAR 
##                                | CUBIC | MAJORITY} {cell_size} {geographic_transform;
##                                geographic_transform...} {Registration_Point} {in_coor_system}
    
try:
    import arcpy
    
    arcpy.env.workspace = r"C:/Workspace"
    
    ##Reproject a TIFF image with Datumn transfer
    arcpy.ProjectRaster_management("image.tif", "reproject.tif", "World_Mercator.prj",\
                                   "BILINEAR", "5", "NAD_1983_To_WGS_1984_5", "#", "#")
    
    ##Reproject a TIFF image that does not have a spatial reference
    ##Set snapping point to the top left of the original image
    snapping_pnt = "1942602 304176"
    
    arcpy.ProjectRaster_management("nosr.tif", "project.tif", "World_Mercator.prj", "BILINEAR",\
                                   "5", "NAD_1983_To_WGS_1984_6", snapping_pnt,\
                                   "NAD_1983_StatePlane_Washington_North.prj")
    
except:
    print "Project Raster example failed."
    print arcpy.GetMessages()

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
11/18/2013