Apply Block Adjustment (Reality Mapping)

Summary

Applies the geographic adjustments to the mosaic dataset items. This tool uses the solution table from the Compute Block Adjustments tool.

This tool can also reset the geographic adjustments back to the original location.

Usage

• This tool can be used to apply adjustments from a solution table or reset the geographic alignment back to its original state.

Parameters

Dialog

Label	Explanation	Data Type
Input Mosaic Dataset	The input mosaic dataset to adjust.	Mosaic Dataset; Mosaic Layer
Adjustment Operation	Specifies whether the mosaic dataset will be adjusted using the solution table or whether the mosaic dataset will be reset so there are no adjustments applied. Adjust the mosaic dataset—The mosaic dataset will be adjusted using the input solution table. Reset the mosaic dataset—The mosaic dataset will be reset so there are no adjustments applied to it. Reactivate image status—Images dropped from the adjustment will be restored to active status. Images without the minimum number of control points required for adjustment are dropped from the computation in the standard adjustment operation, such that the images are categorized as Inactive in the footprints table, the maxPS value is set to 0, the imagery is not visible in the map, and the tie points statuses for the dropped images are disabled. This option will restore the Category status to Primary and ensure the maxPS value is resumed. Images that were included in the adjustment process are unaffected by this option.	String
Input Solution Table (Optional)	The solution table that will be used when adjusting the mosaic dataset. This is the output from the Compute Block Adjustments tool.	Table View
Pan-To-MS Scaling Factor (Optional)	The scaling factor between the pan-sharpened resolution and the multispectral resolution that will be used if the mosaic dataset contains pan-sharpened rasters.	Double
Input DEM (Optional)	The DEM that will be used in the block adjustment. This DEM will only be used if it is a higher resolution than any existing DEM in the mosaic dataset. If this input DEM is used, the geometric function of the mosaic dataset will be updated using this input.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer
Z offset (Optional)	The vertical offset that will be used to adjust the elevation layer within the mosaic dataset's Geometric function.	Double
Control Point Table (Optional)	The input control point table that will have the same adjustments applied as the solution table adjustments.	Table View
Adjust Footprints (Optional)	Specifies whether the footprint geometry will be updated using the same transformation that will be applied to the image. Unchecked—The footprint geometry will not be updated. This is the default. Checked—The footprint geometry will be updated. If a control point table is provided, it will also be transformed.	Boolean
Solution Point Table (Optional)	The solution point table that will be used to update the status field for the control point table. This parameter is only used when the Control Point Table parameter value is provided.	Table View
Adjust Tiepoints (Optional)	Specifies whether the tie points will be updated when a solution point table is provided. This parameter is only used when the Solution Point Table parameter value is provided. Unchecked—The tie points will not be updated. This is the default. Checked—The tie points will be updated when a solution point table is provided.	Boolean

Derived Output

Label	Explanation	Data Type
Updated Input Mosaic Dataset	The output is the same mosaic dataset as the input; no new mosaic dataset is created. The block adjustment is applied to the original mosaic dataset.	Table View
Output Control Points	The updated control points.	Table View

Python

arcpy.rm.ApplyBlockAdjustment(in_mosaic_dataset, adjustment_operation, {input_solution_table}, {pan_to_ms_scaling_factor}, {DEM}, {zoffset}, {control_point_table}, {adjust_footprints}, {solution_point_table}, {adjust_tiepoints})

Name	Explanation	Data Type
in_mosaic_dataset	The input mosaic dataset to adjust.	Mosaic Dataset; Mosaic Layer
adjustment_operation	Specifies whether the mosaic dataset will be adjusted using the solution table or whether the mosaic dataset will be reset so there are no adjustments applied. ADJUST—The mosaic dataset will be adjusted using the input solution table. RESET—The mosaic dataset will be reset so there are no adjustments applied to it. REACTIVATE—Images dropped from the adjustment will be restored to active status. Images without the minimum number of control points required for adjustment are dropped from the computation in the standard adjustment operation, such that the images are categorized as Inactive in the footprints table, the maxPS value is set to 0, the imagery is not visible in the map, and the tie points statuses for the dropped images are disabled. This option will restore the Category status to Primary and ensure the maxPS value is resumed. Images that were included in the adjustment process are unaffected by this option.	String
input_solution_table (Optional)	The solution table that will be used when adjusting the mosaic dataset. This is the output from the Compute Block Adjustments tool.	Table View
pan_to_ms_scaling_factor (Optional)	The scaling factor between the pan-sharpened resolution and the multispectral resolution that will be used if the mosaic dataset contains pan-sharpened rasters.	Double
DEM (Optional)	The DEM that will be used in the block adjustment. This DEM will only be used if it is a higher resolution than any existing DEM in the mosaic dataset. If this input DEM is used, the geometric function of the mosaic dataset will be updated using this input.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer
zoffset (Optional)	The vertical offset that will be used to adjust the elevation layer within the mosaic dataset's Geometric function.	Double
control_point_table (Optional)	The input control point table that will have the same adjustments applied as the solution table adjustments.	Table View
adjust_footprints (Optional)	Specifies whether the footprint geometry will be updated using the same transformation that will be applied to the image. NO_ADJUST_FOOTPRINTS—The footprint geometry will not be updated. This is the default. ADJUST_FOOTPRINTS—The footprint geometry will be updated. If a control point table is provided, it will also be transformed.	Boolean
solution_point_table (Optional)	The solution point table that will be used to update the status field for the control point table. This parameter is only used when the control_point_table parameter value is provided.	Table View
adjust_tiepoints (Optional)	Specifies whether the tie points will be updated when a solution point table is provided. This parameter is only used when the solution_point_table parameter value is provided. NO_ADJUST_TIEPOINTS—The tie points will not be updated. This is the default. ADJUST_TIEPOINTS—The tie points will be updated when a solution point table is provided.	Boolean

Derived Output

Name	Explanation	Data Type
out_mosaic_dataset	The output is the same mosaic dataset as the input; no new mosaic dataset is created. The block adjustment is applied to the original mosaic dataset.	Table View
out_control_point_table	The updated control points.	Table View

Code sample

ApplyBlockAdjustment example 1 (Python window)

This is a Python sample for the ApplyBlockAdjustment function.

import arcpy
arcpy.ApplyBlockAdjustment_rm(
     "c:/BD/BD.gdb/redQB", "ADJUST",
     "c:/BD/BD.gdb/redQB_sol", 0.25)

ApplyBlockAdjustment example 2 (stand-alone script)

This is a Python script sample for the ApplyBlockAdjustment function.

#apply block adjustment
import arcpy
arcpy.env.workspace = "c:/workspace"

#Apply the block ajustment
mdName = "BD.gdb/redlandsQB"
out_solutionTable = "BD.gdb/redlandsQB_solution"

arcpy.ApplyBlockAdjustment_rm(mdName, "ADJUST", 
     out_solutionTable, 0.25)

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: No
• Standard: Yes
• Advanced: Yes