计算深度地图 (实景映射)

在 Advanced 许可等级下可用。

适用于具有 ArcGIS Reality 许可的 ArcGIS 组织。

摘要

根据组成镶嵌数据集的每个图像的深度地图来计算更加精确的 CenterZ 字段值。 控制点和解决方案点用于计算组成镶嵌数据集的每个图像的深度地图，以改善图像到地面（地图）的变换，尤其是在高倾斜情况下。

图像检查通常在图像空间中执行，以便发现缺陷、执行测量，并为校正后的影像生成检查报告。 可以在地图空间或图像空间中测量对象的距离、面积和高度，并且可以生成检查报告以共享检查结果。

检查工作流的一个重要组成部分是从图像到地面（地图）空间的变换，以便更加精确地定位和测量图像上的缺陷、点、线、面。 图像到地面的变换（特别是对于高倾斜图像）将使用深度地图，即每个像素从相机位置到地面位置的距离。

使用情况

• 该工具将经过校正的镶嵌数据集、控制点表和解决方案点表作为输入，以生成更新的已校正镶嵌数据集。

  注：

  将为包含已校正镶嵌数据集的每个输入图像项目创建深度地图文件 (.dm)。 将在与包含原始已校正镶嵌数据集的源影像文件相同的目录中创建深度地图文件。

• 更新的已校正镶嵌数据集中的 CenterZ 字段将更新为更加精确的值。

• 此工具中使用的控制点表和解决方案点表是在使用正射映射工作流或 ArcGIS Reality for ArcGIS Pro 执行区域网平差时生成的。

参数

对话框

标注	说明	数据类型
输入镶嵌数据集	经过区域网平差的输入镶嵌数据集。 在将镶嵌数据集用作此工具的输入之前，必须对其进行校正。 可以在 ArcGIS Pro 或 Reality for ArcGIS Pro 工作流中使用正射映射工作流，以校正镶嵌数据集。	Mosaic Dataset; Mosaic Layer
控制点表	输入控制点要素类。 该点要素类是计算相机模型工具或计算连接点工具的输出。	Feature Class; Table View
解决方案点表	输入解决方案点要素类。 该点要素类是计算相机模型工具或计算连接点工具的输出。	Feature Class; Table View
查询定义 (可选)	一种 SQL 表达式，将用于选择要包含在深度地图中的镶嵌数据集项目。	SQL Expression
跳过现有的 (可选)	指定是仅针对没有 CenterZ 值的栅格计算深度地图 CenterZ 值，还是针对所有镶嵌数据集项目（包括具有现有 CenterZ 值的栅格项目）计算深度地图值。 未选中 - 将为每个镶嵌数据集项目（包括具有现有 CenterZ 值的项目）计算深度地图 CenterZ 值。 这是默认设置。 选中 - 仅针对没有 CenterZ 值的栅格计算深度地图 CenterZ 值。	Boolean
调整轮廓线 (可选)	指定是否使用应用于图像的相同变换来更新轮廓线几何。 未选中 - 将不会更新轮廓线几何。 这是默认设置。 选中 - 轮廓线几何将更新为图像几何。	Boolean

派生输出

标注	说明	数据类型
输出镶嵌数据集	更新后的已校正镶嵌数据集。 将更新 CenterZ 字段。 如果选中调整轮廓线参数，则还将更新镶嵌数据集的轮廓线。	Mosaic Dataset; Mosaic Layer

Python

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

名称	说明	数据类型
in_mosaic_dataset	经过区域网平差的输入镶嵌数据集。 在将镶嵌数据集用作此工具的输入之前，必须对其进行校正。 可以在 ArcGIS Pro 或 Reality for ArcGIS Pro 工作流中使用正射映射工作流，以校正镶嵌数据集。	Mosaic Dataset; Mosaic Layer
control_point_table	输入控制点要素类。 该点要素类是计算相机模型工具或计算连接点工具的输出。	Feature Class; Table View
solution_point_table	输入解决方案点要素类。 该点要素类是计算相机模型工具或计算连接点工具的输出。	Feature Class; Table View
where_clause (可选)	一种 SQL 表达式，将用于选择要包含在深度地图中的镶嵌数据集项目。	SQL Expression
skip_existing (可选)	指定是仅针对没有 CenterZ 值的栅格计算深度地图 CenterZ 值，还是针对所有镶嵌数据集项目（包括具有现有 CenterZ 值的栅格项目）计算深度地图值。 NO_SKIP_EXISTING—将为每个镶嵌数据集项目（包括具有现有 CenterZ 值的项目）计算深度地图 CenterZ 值。 这是默认设置。 SKIP_EXISTING—仅针对没有 CenterZ 值的栅格计算深度地图 CenterZ 值。	Boolean
adjust_footprints (可选)	指定是否使用应用于图像的相同变换来更新轮廓线几何。 NO_ADJUST_FOOTPRINTS—将不会更新轮廓线几何。 这是默认设置。 ADJUST_FOOTPRINTS—轮廓线几何将更新为图像几何。	Boolean

派生输出

名称	说明	数据类型
out_mosaic_dataset	更新后的已校正镶嵌数据集。 将更新 CenterZ 字段。 如果 adjust_footprints 参数指定为 ADJUST_FOOTPRINTS，则还将更新镶嵌数据集的轮廓线。	Mosaic Dataset; Mosaic Layer

代码示例

ComputeDepthMap 示例 1（独立脚本）

此示例将使用更加精确的 CenterZ 值创建更新的校正镶嵌数据集。

# 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 示例 2（Python 窗口）

此示例将使用更加精确的 CenterZ 值创建更新的校正镶嵌数据集。

# 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)

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 否
• Standard: 需要 ArcGIS Reality for ArcGIS Pro
• Advanced: 是