重新构建表面 (实景映射工具)

汇总

可根据镶嵌数据集中的校正影像生成数字表面模型 (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—用于定义大型水体范围的面。
- coarseWaterbody—一个布尔值，用于指定水体要素是精确水体还是粗略水体。如果设置为 False，则水体为精确水体。如果设置为 True，则水体为粗略水体。默认值为 True。
- correctionFeatures—用于定义所有非水体表面的范围的面。
- dsmMetaProducts—指定输出中将包含的 DSM 元信息产品。值可以包含 DSM_BINARY_MASK、DSM_DISTANCE_MAP 和 DSM_POINT_MODEL_COUNT 的任意组合。
- meshFormats—指定网格输出格式。有效值为 SLPK、OBJ 和 3D_TILES，例如 "meshFormats": "SLPK;OBJ;3D_TILES"。默认值为 SLPK。
- processingFolder—本地存储中的处理位置。默认值是本地临时文件夹。处理完成后，生成的内容将被删除。
- resultsFolder—处理结果的输出位置。默认值为重建文件夹。
- meshSettings—指定网格产品的网格设置。受支持的网格设置包括 srs、exportInLocalCoordinateSystem、exportAsSingleFile 和 keepHeightsOfInputCoordinateSystem。不同的网格格式支持不同的网格设置。可以在全局设置网格设置，也可以根据格式设置网格设置。例如，如果设置为 { "dsmMeshSettings": { "srs": "4326;5773" } }，则 SLPK 格式网格和 3D_Tiles 格式网格将输出到指定空间参考。如果希望 SLPK 格式网格和 3D_Tiles 格式网格输出到其他空间参考，请根据格式设置网格设置。
  - srs—SLPK 格式的空间参考。 srs 值可以为水平坐标系和垂直坐标系的 WKID 对，例如 "4326;5773" 或 WKT。第一个值为水平坐标系，如果支持将工程坐标系变换为所选坐标系，则可以指定 srs 值。如果目标空间参考为地理坐标系，则目前仅支持 WGS84。默认值为镶嵌数据集的空间参考。
  - exportInLocalCoordinateSystem—指定是否在局部坐标系中导出网格的布尔值。此选项适用于 OBJ 格式。如果设置为 True，则将在局部坐标系中导出网格。如果设置为 False，则将在重新构建的坐标系中导出网格。默认值为 False。
  - exportAsSingleFile—指定是否将网格导出为单个 .obj 文件或多个文件的布尔值。此选项仅适用于 OBJ 格式。如果设置为 True，则网格将导出为单个 .obj 文件。如果设置为 False，则网格将导出为多个 .obj 文件。默认值为 False。
- dsmMeshSettings—指定 DSM 网格产品的网格设置。受支持的 DSM 网格设置与上述 meshSettings 的设置相同。
- tiePointTablePath—指定连接点表的路径。
- slnPointTablePath—指定解决方案点表的路径。
以下提供了指定为 JSON 的重建选项参数值的示例：

<!--```other { "scenario": "AERIAL_NADIR", "fwdOverlap": 0.60, "swdOverlap": 0.30, "quality": "ULTRA", "products": "DSM;TRUE_ORTHO;DSM_MESH", "dsmMeshFormats": "SLPK;3D_TILES;OBJ", "dsmMetaProducts": "DSM_BINARY_MASK;DSM_DISTANCE_MAP", "dsmMeshSettings": { "SLPK": { "srs": "4326;5773" }, "OBJ": { "exportInLocalCoordinateSystem": false, "exportAsSingleFile": false } }, "resultsFolder": "C:\RMResultsFolder" }
多光谱无人机数据仅支持生成 DSM 和真正射产品，不支持生成点云或网格产品。
当产品参数设置为 DSM 时，工具将在 ...\Results\DSM\las 文件夹中创建输出 LAS 数据集或 LAS 文件夹。可以使用 LAS 数据集或文件夹，通过基于点云进行插值工具生成数字地形模型 (DTM)。
旧版本：

在 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 网格。默认情况下，当方案参数设置为无人机或航空倾斜时，将指定该选项。高斯泼溅—将在具有高斯分布的密集 3D 点云中渲染点，并且将使用机器学习来重建高保真 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 倍。 `RAPID`—产品将以调整后的质量生成，以满足需要快速获取结果的工作流。	String
products [products,...] （可选）	指定将要生成的产品。 `DSM`—将生成 DSM。默认情况下，当 `scenario` 参数设置为 `AERIAL_NADIR` 或 `SATELLITE` 时，将指定该选项。 `TRUE_ORTHO`—将对此影像进行正射校正。默认情况下，当 `scenario` 参数设置为 `AERIAL_NADIR` 或 `SATELLITE` 时，将指定该选项。 `DSM_MESH`—将生成 DSM 网格。默认情况下，当 `scenario` 参数设置为 `AERIAL_NADIR` 或 `SATELLITE` 时，将指定该选项。 `POINT_CLOUD`—将生成图像点云。默认情况下，当 `scenario` 参数设置为 `DRONE` 或 `AERIAL_OBLIQUE` 时，将指定该选项。 `MESH`—将生成 3D 网格。默认情况下，当 `scenario` 参数设置为 `DRONE`、`AERIAL_OBLIQUE` 时，将指定该选项。 `GAUSSIAN_SPLATS`—将在具有高斯分布的密集 3D 点云中渲染点，并且将使用机器学习来重建高保真 3D 场景，这些场景将捕捉诸如薄结构等精细细节。	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"

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

环境

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

许可信息

基本: 否
标准: 需要 ArcGIS Reality for ArcGIS Pro
高级: 需要 ArcGIS Reality for ArcGIS Pro

重新构建表面 (实景映射工具)

汇总

用法

注:

注:

旧版本：

参数

派生输出

环境

许可信息

相关主题