Apply Block Adjustment (Data Management)

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

LabelExplanationData 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 datasetThe mosaic dataset will be adjusted using the input solution table.
  • Reset the mosaic datasetThe mosaic dataset will be reset so there are no adjustments applied to it.
  • Reactivate image statusImages 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

LabelExplanationData 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

arcpy.management.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})
NameExplanationData 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.

  • ADJUSTThe mosaic dataset will be adjusted using the input solution table.
  • RESETThe mosaic dataset will be reset so there are no adjustments applied to it.
  • REACTIVATEImages 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_FOOTPRINTSThe footprint geometry will not be updated. This is the default.
  • ADJUST_FOOTPRINTSThe 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_TIEPOINTSThe tie points will not be updated. This is the default.
  • ADJUST_TIEPOINTSThe tie points will be updated when a solution point table is provided.
Boolean

Derived Output

NameExplanationData 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

Environments

This tool does not use any geoprocessing environments.

Related topics