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
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.
| 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:
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.
| 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:
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
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)