Register Raster (Data Management)
Summary
Performs a geographic transformation to an existing raster dataset by automatically registering it to a reference image. This is similar to the Auto Register button on the Georeferencing tools.
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 in order 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 a single item within a mosaic dataset. You will need to type the full path of the mosaic dataset then a unique query for the item you want to update. Below are a few 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'
Syntax
Parameter | Explanation | Data Type |
in_raster |
The input raster dataset. After the tool runs, the input raster will have its geographic transformation updated. You are also able to register an item within a mosaic dataset. | 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.
| String |
reference_raster (Optional) |
Choose the reference raster to which the input will be matched. | Raster Layer |
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:
| Text File |
transformation_type (Optional) | The geometric transformation type.
| 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:
| Text File |
Code Sample
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", "#")
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)