重新构建表面 (现实映射)

在 Advanced 许可等级下可用。

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

摘要

可根据调整后的影像生成数字表面模型 (DSM)、正射影像、DSM 网格、3D 网格和点云。

使用情况

  • 必须预先调整输入镶嵌数据集参数值。 有关正射映射中的区域网平差的信息,请参阅比较区域网平差工具。

  • 运行工具时,将在重建文件夹参数值中创建一个 reality.json 文件。 如果使用相同的重建文件夹值再次运行工具,reality.json 文件将根据上次运行的值填充方案质量水体要素校正要素参数。 要为同一工程生成其他产品,请再次运行该工具。

    注:

    要重置水体要素校正要素参数的值,请将这些参数值设置为 NONE

  • 如果输入镶嵌数据集发生更改,请为重建文件夹值指定不同的文件夹。 要生成反映镶嵌数据集更改的产品,请提供此新位置并再次运行该工具。

  • 使用感兴趣区域参数可以提高处理速度并为输入镶嵌中的图像子集生成产品数据集。

  • 如果指定了重建选项参数,则 .json 文件或 JSON 字符串的属性将为其余可选参数设置默认值。

    注:

    如果使用重建选项参数和其他可选参数设置相同的属性,则可选参数值将覆盖重建选项值。

    以下列表定义了重建选项参数以 .json 文件或 JSON 字符串形式使用的关键字:

    • scenario - 指定将用于生成输出产品的影像类型。
    • fwdOverlap - 图像之间的向前(条带内)重叠百分比。 将 scenario 设置为 AERIAL_NADIR 时,将使用此关键字。
    • swdOverlap - 图像之间的侧方(跨条带)重叠百分比。 将 scenario 设置为 AERIAL_NADIR 时,将使用此关键字。
    • quality - 指定最终产品的质量。
    • products - 指定要生成的产品。
    • tileSize - 分块大小。 值可以为 AUTO 或双精度型。
    • cellSize - 输出栅格产品的像元大小。 该值是自动估计的,但可以手动定义。 值可以为 AUTO 或双精度型。
    • tilingOrigin - 分块原点的地图坐标。 例如,"tilingOrigin": [0, 0]
    • areaFeatures - 感兴趣区域。
    • waterbodyFeatures - 用于定义大型水体范围的面。
    • correctionFeatures - 用于定义所有非水体表面的范围的面。
    • dsmMetaProducts - 指定输出中将包含的 DSM 元信息产品。 值可以包含DSM_BINARY_MASKDSM_DISTANCE_MAPDSM_POINT_MODEL_COUNT 的任意组合。
    • meshFormats - 指定网格输出格式。 有效值为 SLPKOBJ3D_TILES,例如 "meshFormats": "SLPK;OBJ;3D_TILES"。 默认值为 SLPK
    • processingFolder - 本地存储中的处理位置。 默认值是本地临时文件夹。 处理完成后,生成的内容将被删除。
    • resultsFolder - 处理结果的输出位置。 默认值为重建文件夹。
  • 以下提供了指定为 JSON 的重建选项参数值的示例:

    {
        "scenario": "AERIAL_NADIR",
        "fwdOverlap": .60,
        "swdOverlap": .30,
        "quality": "ULTRA",
        "products": "DSM;TRUE_ORTHO;DSM_MESH",
        "dsmMetaProducts": "DSM_BINARY_MASK;DSM_DISTANCE_MAP",
        "resultsFolder": "C:\\RMResultsFolder"
    }
  • 旧版本:

    ArcGIS Pro 3.2 版中,方案参数的默认选项被无人机选项取代。 此外,以下参数选项已被弃用:

    • 质量参数 - 选项已被弃用。
    • 感兴趣区域参数 - 自动选项已被弃用。

参数

标注说明数据类型
输入镶嵌数据集

调整的输入镶嵌数据集。

Mosaic Dataset; Mosaic Layer
重建文件夹

输出数据集文件夹。

Folder
重建选项
(可选)

用于指定工具参数值的 .json 文件或 JSON 字符串。

如果提供了此参数值,则 .json 文件或 JSON 字符串的属性将为其余可选参数设置默认值。 有关选项列表,请参阅以上用法部分。

File; String
方案
(可选)

指定将用于生成输出产品的影像类型。

  • 无人机输入影像将被定义为使用无人机或地面照相机获取。
  • 航空像底点输入影像将被定义为使用大型摄影测量照相机系统获取。
  • 航空倾斜输入影像将被定义为使用倾斜照相机系统获取。
  • 卫星输入影像将被定义为使用卫星系统获取。
String
向前重叠
(可选)

将在图像之间使用的向前(条带内)重叠百分比。 默认值为 60。

在将方案参数设置为航空像底点时才启用此参数。

Long
侧方重叠
(可选)

将在图像之间使用的侧方(跨条带)重叠百分比。 默认值为 30。

在将方案参数设置为航空像底点时才启用此参数。

Long
质量
(可选)

指定最终产品的质量。

  • 超级将使用密度最高的点云。 输入图像将以其原始(全)分辨率使用。
  • 将使用高密度的点云。 输入图像将被降采样 2 倍。
String
产品
(可选)

指定将要生成的产品。

  • DSM将生成 DSM。 默认情况下,当方案参数设置为航空像底点卫星时,将指定该选项。
  • 正射影像将对此影像进行正射校正。 默认情况下,当方案参数设置为航空像底点卫星时,将指定该选项。
  • DSM 网格将生成 DSM 网格。 默认情况下,当方案参数设置为航空像底点卫星时,将指定该选项。
  • 点云将生成图像点云。 默认情况下,当方案参数设置为无人机航空像底点时,将指定该选项。
  • 网格将生成 3D 网格。 默认情况下,当方案参数设置为无人机航空像底点时,将指定该选项。
String
像元大小
(可选)

输出产品的像元大小。

Double; String
感兴趣区域
(可选)

将用于选择要处理的图像的感兴趣区域。 感兴趣区域可以自动计算或使用输入 polygon 定义。

如果该值包含 3D 几何,则将忽略 z 分量。 如果该值包括重叠要素,则将计算这些要素的并集。

Feature Layer; File; String
水体要素
(可选)

将用于定义大型水体范围的面。 该值必须为 3D 要素。

Feature Layer; File; String
校正要素
(可选)

将用于定义所有非水体表面的范围的面。 该值必须为 3D 要素。

Feature Layer; File; String

派生输出

标注说明数据类型
更新的重建文件夹

输出重建文件夹。

Folder

arcpy.rm.ReconstructSurface(in_mosaic_dataset, recon_folder, {recon_options}, {scenario}, {fwd_overlap}, {swd_overlap}, {quality}, {products}, {cell_size}, {aoi}, {waterbody_features}, {correction_features})
名称说明数据类型
in_mosaic_dataset

调整的输入镶嵌数据集。

Mosaic Dataset; Mosaic Layer
recon_folder

输出数据集文件夹。

Folder
recon_options
(可选)

用于指定工具参数值的 .json 文件或 JSON 字符串。

如果提供了此参数值,则 .json 文件或 JSON 字符串的属性将为其余可选参数设置默认值。 有关选项列表,请参阅以上用法部分。

File; String
scenario
(可选)

指定将用于生成输出产品的影像类型。

  • DRONE输入影像将被定义为使用无人机或地面照相机获取。
  • AERIAL_NADIR输入影像将被定义为使用大型摄影测量照相机系统获取。
  • AERIAL_OBLIQUE输入影像将被定义为使用倾斜照相机系统获取。
  • SATELLITE输入影像将被定义为使用卫星系统获取。
String
fwd_overlap
(可选)

将在图像之间使用的向前(条带内)重叠百分比。 默认值为 60。

当将 scenario 参数设置为 AERIAL_NADIR 时,此参数处于启用状态。

Long
swd_overlap
(可选)

将在图像之间使用的侧方(跨条带)重叠百分比。 默认值为 30。

当将 scenario 参数设置为 AERIAL_NADIR 时,此参数处于启用状态。

Long
quality
(可选)

指定最终产品的质量。

  • ULTRA将使用密度最高的点云。 输入图像将以其原始(全)分辨率使用。
  • HIGH将使用高密度的点云。 输入图像将被降采样 2 倍。
String
products
[products,...]
(可选)

指定将要生成的产品。

  • DSM将生成 DSM。 默认情况下,当 scenario 参数设置为 AERIAL_NADIRSATELLITE 时,将指定该选项。
  • TRUE_ORTHO将对此影像进行正射校正。 默认情况下,当 scenario 参数设置为 AERIAL_NADIR 时,将指定该选项。
  • DSM_MESH将生成 DSM 网格。 默认情况下,当 scenario 参数设置为 AERIAL_NADIRSATELLITE 时,将指定该选项。
  • POINT_CLOUD将生成图像点云。 默认情况下,当 scenario 参数设置为 DRONEAERIAL_OBLIQUE 时,将指定该选项。
  • MESH将生成 3D 网格。 默认情况下,当 scenario 参数设置为 DRONEAERIAL_OBLIQUE 时,将指定该选项。
String
cell_size
(可选)

输出产品的像元大小。

Double; String
aoi
(可选)

将用于选择要处理的图像的感兴趣区域。 感兴趣区域可以自动计算或使用输入 polygon 定义。

如果该值包含 3D 几何,则将忽略 z 分量。 如果该值包括重叠要素,则将计算这些要素的并集。

Feature Layer; File; String
waterbody_features
(可选)

将用于定义大型水体范围的面。 该值必须为 3D 要素。

Feature Layer; File; String
correction_features
(可选)

将用于定义所有非水体表面的范围的面。 该值必须为 3D 要素。

Feature Layer; File; String

派生输出

名称说明数据类型
derived_recon_folder

输出重建文件夹。

Folder

代码示例

ReconstructSurface 示例 1(Python 窗口)

此示例从经过校正的镶嵌数据集创建 3D 产品。

# ReconstructSurface example 1 (Python window) 
# This example creates 3D products from an adjusted mosaic dataset. 

# Import system modules 
import arcpy 

products_3d = arcpy.rm.ReconstructSurface(r"C:\ReconstructSurface.gdb\droneMD", r"C:\RS_output", None, "DRONE", None, None, "HIGH", "POINT_CLOUD;MESH", 0.1, r"\\shared_location\RMeTesting.gdb\AOI", None, r"\\shared_location\RMTesting.gdb\CorrectionFeature")
ReconstructSurface 示例 2(Python 窗口)

此示例使用 JSON 字符串创建了 DSM、DSM 网格和真正射影像产品。

# ReconstructSurface example 2 (Python window) 
# This example creates DSM, DSM mesh, and True Ortho products using JSON string. 

# Import system modules 

import arcpy

products_2d = arcpy.rm.ReconstructSurface(r"C:\ReconstructSurface.gdb\droneMD_json", r"C:\RS_output_folder", r'{"scenario":"DRONE","quality":"ULTRA","products":"DSM;TRUE_ORTHO;DSM_MESH","cellSize":0.05,"correctionFeatures":"\\\\shared_location\\RMeTesting.gdb\\CorrectionFeature","areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI","processingFolder":"\\\\shared_location\\RMeprocessingFolder"}')
ReconstructSurface 示例 3(独立脚本)

本示例使用航空像底点影像创建了多个 2D 产品。

#ReconstructSurface example 3 (stand-alone script) 
#This example creates multiple 2D products from aerial nadir imagery. 

# Import system modules 
import arcpy 

# Define input parameters 
in_mosaic = "C:/ReconstructSurface.gdb/aerialMD" 
out_folder = "C:/ScenarioAerialNadir" 
json_file = "" 
scenario = "AERIAL_NADIR" 
forward_overlap = 60
side_overlap = 30 
out_quality = "ULTRA" 
output_products = "DSM;TRUE_ORTHO;DSM_MESH" 

#Execute - Generate Products 
products = arcpy.rm.ReconstructSurface(in_mosaic, out_folder, json_file,senario, forward_overlap, side_overlap, out_quality, output_products)

环境

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

许可信息

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

相关主题