Compute Depth Map (Reality Mapping)

Available with Advanced license.

Available for an ArcGIS organization with the ArcGIS Reality license.

Summary

Computes a more accurate CenterZ field value based on the depth map for each image comprising a mosaic dataset. Control points and solution points are used to compute a depth map for each image comprising a mosaic dataset to improve image-to-ground (map) transformation, especially in high oblique cases.

Image inspection, typically performed in image space, allows you to discover defects, perform measurement, and generate inspection reports for rectified imagery. You can measure distance, area, and height of objects in either map space or image space, and an inspection report can be generated to share the inspection results.

An important component of the inspection workflow is the transformation from image to ground (map) space, that allows the defects, points, lines, polygons, on images to be more accurately located and measured. The image-to-ground transformation, especially for high oblique images, uses a depth map, which is the distance from the camera location to the ground location for each pixel.

Usage

  • This tool takes an adjusted mosaic dataset, a control point table, and a solution point table as input to generate an updated adjusted mosaic dataset.

    Note:

    A depth map file (.dm) is created for each input image item comprising the adjusted mosaic dataset. The depth map file is created in the same directory as the source imagery files comprising the original adjusted mosaic dataset.

  • The CenterZ field in the updated adjusted mosaic dataset will be updated with a more accurate value.

  • The control point table and solution point table used in this tool are generated when performing block adjustment using an ortho mapping workflow or ArcGIS Reality for ArcGIS Pro.

Parameters

LabelExplanationData Type
Input Mosaic Dataset

The block adjusted input mosaic dataset. The mosaic dataset must be adjusted before it is used as input for this tool. You can use an ortho mapping workflow in ArcGIS Pro, or a Reality for ArcGIS Pro workflow, to adjust the mosaic dataset.

Mosaic Dataset; Mosaic Layer
Control Point Table

The input control point feature class. This point feature class is the output of the Compute Camera Model tool or the Compute Tie Points tool.

Feature Class; Table View
Solution Point Table

The input solution point feature class. This point feature class is the output of the Compute Camera Model tool or the Compute Tie Points tool.

Feature Class; Table View
Query Definition
(Optional)

An SQL expression that will be used to select items in the mosaic dataset to include in the depth map.

SQL Expression
Skip Existing
(Optional)

Specifies whether a depth map CenterZ value will be computed only for rasters without a CenterZ value, or computed for all mosaic dataset items including those with an existing CenterZ value.

  • Unchecked—A depth map CenterZ value will be computed for every mosaic dataset item, including items with an existing CenterZ value. This is the default.
  • Checked—A depth map CenterZ value will only be computed for rasters that do not have a CenterZ value.

Boolean
Adjust Footprints
(Optional)

Specifies whether the footprint geometry will be updated using the same transformation that was applied to the image.

  • Unchecked—The footprint geometry will not be updated. This is the default.
  • Checked—The footprint geometry will be updated to the image geometry.

Boolean

Derived Output

LabelExplanationData Type
Output Mosaic Dataset

The updated adjusted mosaic dataset. The CenterZ field will be updated. If the Adjust Footprints parameter is checked, the footprint of the mosaic dataset will also be updated.

Mosaic Dataset; Mosaic Layer

arcpy.rm.ComputeDepthMap(in_mosaic_dataset, control_point_table, solution_point_table, {where_clause}, {skip_existing}, {adjust_footprints})
NameExplanationData Type
in_mosaic_dataset

The block adjusted input mosaic dataset. The mosaic dataset must be adjusted before it is used as input for this tool. You can use an ortho mapping workflow in ArcGIS Pro, or a Reality for ArcGIS Pro workflow, to adjust the mosaic dataset.

Mosaic Dataset; Mosaic Layer
control_point_table

The input control point feature class. This point feature class is the output of the Compute Camera Model tool or the Compute Tie Points tool.

Feature Class; Table View
solution_point_table

The input solution point feature class. This point feature class is the output of the Compute Camera Model tool or the Compute Tie Points tool.

Feature Class; Table View
where_clause
(Optional)

An SQL expression that will be used to select items in the mosaic dataset to include in the depth map.

SQL Expression
skip_existing
(Optional)

Specifies whether a depth map CenterZ value will be computed only for rasters without a CenterZ value, or computed for all mosaic dataset items including those with an existing CenterZ value.

  • NO_SKIP_EXISTINGA depth map CenterZ value will be computed for every mosaic dataset item, including items with an existing CenterZ value. This is the default.
  • SKIP_EXISTINGA depth map CenterZ value will only be computed for rasters that do not have a CenterZ value.
Boolean
adjust_footprints
(Optional)

Specifies whether the footprint geometry will be updated using the same transformation that was applied to the image.

  • NO_ADJUST_FOOTPRINTSThe footprint geometry will not be updated. This is the default.
  • ADJUST_FOOTPRINTSThe footprint geometry will be updated to the image geometry.
Boolean

Derived Output

NameExplanationData Type
out_mosaic_dataset

The updated adjusted mosaic dataset. The CenterZ field will be updated. If the adjust_footprints parameter is specified as ADJUST_FOOTPRINTS, the footprint of the mosaic dataset will also be updated.

Mosaic Dataset; Mosaic Layer

Code sample

ComputeDepthMap example 1 (stand-alone script)

This example creates an updated adjusted mosaic dataset with a more accurate CenterZ value.

# Import system modules
 import arcpy  

# Execute
arcpy.rm.ComputeDepthMap(in_mosaic_dataset= r"C:\CDM.gdb\YVWD", control_point_table=r" C:\CDM.gdb\YVWD_ControlPoints", solution_point_table= r"C:\CDM.gdb\YVWD_SolutionPoints", skip_existing="SKIP_EXISTING", adjust_footprints="NO_ADJUST_FOOTPRINTS")
ComputeDepthMap example 2 (Python window)

This example creates an updated adjusted mosaic dataset with a more accurate CenterZ value.

# Import system modules
import arcpy  

# Define input parameters
in_mosaic_dataset= r"C:\CDM_RM.gdb\YVWD"
control_point_table=r"C:\CDM_RM.gdb\YVWD_ControlPoints"
solution_point_table= r"C:\CDM_RM.gdb\YVWD_SolutionPoints",
where_clause= "OBJECTID > 2",
skip_existing="SKIP_EXISTING",
adjust_footprints="ADJUST_FOOTPRINTS"

# Execute
arcpy.rm.ComputeDepthMap(in_mosaic_dataset, control_point_table, solution_point_table, where_clause, skip_existing, adjust_footprints)

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Requires ArcGIS Reality for ArcGIS Pro
  • Advanced: Yes

Related topics