Compute Depth Map (Data Management)

Available with Advanced 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

Dialog

Label	Explanation	Data 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

Label	Explanation	Data 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

Python

arcpy.management.ComputeDepthMap(in_mosaic_dataset, control_point_table, solution_point_table, {where_clause}, {skip_existing}, {adjust_footprints})

Name	Explanation	Data 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_EXISTING—A depth map CenterZ value will be computed for every mosaic dataset item, including items with an existing CenterZ value. This is the default. SKIP_EXISTING—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. NO_ADJUST_FOOTPRINTS—The footprint geometry will not be updated. This is the default. ADJUST_FOOTPRINTS—The footprint geometry will be updated to the image geometry.	Boolean

Derived Output

Name	Explanation	Data 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.management.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.management.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