ArcGIS Help 10.2 - Register Raster (Data Management)

Summary

This tool registers an image by automatically computing control points based on a reference image, or by using a set of predefined control points. The geometric transformation computed from the control points is written to the input dataset. If the input dataset is a mosaic dataset, the tool will operate on each mosaic dataset item.

In order to automatically register the image, the input raster and the reference raster must be in a relatively close geographic area. You may need to create a link file with a few links to get your input raster into the same map space. A link table can be created using the Georeferencing toolbar.

Usage

The input raster will have its georeferencing information updated.
The RESET keyword allows you to remove any geographic transformation that has been applied using this tool.
This tool allows you to register all the items within a mosaic dataset, a subset of the items, or a single item within a mosaic dataset. If you only want to register a specific item, you will need to enter the full path of the mosaic dataset and a unique query for the item you want to update.
Following are some examples of how to choose an item within a mosaic dataset as your input raster:
- \\Myserver\MyFolder\MyMosaicDataset\OBJECTID=1
- \\Myserver\MyFolder\MyMosaicDataset\NAME='tileName01'
If you want to choose a subset of the items, you can make a selection on the mosaic dataset layer.
When the input raster is a mosaic dataset with pan-sharpened items, this tool can automatically register the multispectral raster to the panchromatic raster by leaving the Reference Raster and the Input Link File parameters empty.

Syntax

RegisterRaster_management (in_raster, register_mode, {reference_raster}, {input_link_file}, {transformation_type}, {output_cpt_link_file}, {maximum_rms_value})

Parameter	Explanation	Data Type
in_raster	The input raster dataset. After the tool runs, the input raster will have its geographic transformation updated. Registering a mosaic dataset item will only update that particular item within the mosaic dataset. A mosaic dataset item will have the path to the mosaic dataset followed by the Object ID of the item. For instance, the first item in the mosaic dataset would have the following path: .\mosaicDataset\objectid=1. For a mosaic dataset input, it will register each mosaic dataset item based on the control points and the reference raster.	Mosaic Layer; Raster Dataset; Raster Layer
register_mode	Choose the registration mode. You can either register the raster with a transformation, or you can reset the transformation. REGISTER —The tool will apply a geometric transformation on the input raster. This is the default. RESET — The tool will remove the geometric transformation previously added by this tool. CREATE_LINKS —The tool will create a link file with automatically generated links.	String
reference_raster (Optional)	Choose the reference raster to which the input will be matched. Leave this parameter empty if you want to register your multispectral mosaic dataset items to their associated panchromatic rasters.	Image Service; Internet Tiled Layer; Map Server Layer; MapServer; Mosaic Layer; Raster Dataset; Raster Layer; WMS Map
input_link_file (Optional)	The link file that will be used to place the input raster in the same map space as the reference raster. Each row in the input link file can be one of the following set of values, each delimited by a Tab: <Optional ID> <From X> <From Y> <To X> <To Y> <From X> <From Y> <To X> <To Y> <Residual X> <Residual Y> <Residual> The input link table works with one mosaic item in the mosaic layer. The input must specify which item is being processed, either selecting the item or specifying the ObjectID in the input. Leave this parameter empty if you want to register your multispectral mosaic dataset items to their associated panchromatic rasters.	Text File
transformation_type (Optional)	The geometric transformation type. POLYORDER0 —A zero-order polynomial is used to shift your data. This is commonly used when your data is already georeferenced, but a small shift will better line up your data. Only one link is required to perform a zero-order polynomial shift. POLYORDER1 —A first-order polynomial (affine) fits a flat plane to the input points. This is the default. POLYORDER2 —A second-order polynomial fits a somewhat more complicated surface to the input points. POLYORDER3 —A third-order polynomial fits a more complicated surface to the input points. ADJUST —A transformation that optimizes for both global and local accuracy. It accomplishes this by first performing a polynomial transformation, then adjusting the control points locally, to better match the target control points, using a triangulated irregular network (TIN) interpolation technique. SPLINE —A transformation that exactly transforms the source control points to the target control points. This means that the control points will be accurate, but the raster pixels that are between the control points are not. PROJECTIVE —A transformation that can warp lines so they remain straight. In doing so, lines that were once parallel may no longer remain parallel. The projective transformation is especially useful for oblique imagery, scanned maps, and for some imagery products.	String
output_cpt_link_file (Optional)	The output link file that contains the registration links created by this tool. The output link table can be used in the Warp From File tool. Each row in the output link file has the following values, each delimited by a Tab: <From X> <From Y> <To X> <To Y> <Residual X> <Residual Y> <Residual> The output link table works with one mosaic dataset item in the mosaic layer. The input must specify which item is being processed, either selecting the item or specifying the ObjectID in the input.	Text File
maximum_rms_value (Optional)	The maximum root mean square error (RMSE) is the maximum modeled error that is allowed for the output transformation. Setting the maximum RMSE will remove large residual errors, thereby reducing the error of the transformation. By default, the maximum RMSE is set to 0.5 times the cell size of your input raster. The maximum RMSE should not be less than 0.3 times the cell size of your input raster.	Double

Code Sample

RegisterRaster example 1 (Python window)

This is a Python sample for the RegisterRaster tool.

import arcpy
arcpy.RegisterRaster_management(
     "\\cpu\data\nonref.tif", "REGISTER", "\\cpu\data\yesref.tif",
     "\\cpu\data\links.txt", "POLYORDER1", "#")

RegisterRaster example 2 (stand-alone script)

This is a Python script sample for the RegisterRaster tool.

# Register raster using only control points

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
rdname = "irs_ps.img"
mode = "REGISTER"
refrd = ""
linkfile = "C:/Workspace/irs_controls_13.txt"
order = "POLYORDER2"
    
arcpy.RegisterRaster_management(
     rdname, mode, refrd, linkfile, order)

Environments

Parallel Processing Factor

Licensing Information

ArcGIS for Desktop Basic: Yes

ArcGIS for Desktop Standard: Yes

ArcGIS for Desktop Advanced: Yes

5/7/2015

Register Raster (Data Management)