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

在 Advanced 许可等级下可用。

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

摘要

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

许可：

重新构建表面工具仅适用于 ArcGIS Reality for ArcGIS Pro 许可以及 ArcGIS Standard 许可或 Advanced 许可。

使用情况

必须预先调整输入镶嵌数据集参数值。有关现实映射中的区域网平差的信息，请参阅比较区域网平差工具。
运行该工具后，将在重建文件夹值中创建一个 Project.spr 文件。如果再次使用重建文件夹值，则 Project.spr 文件的存在将导致输入镶嵌数据集参数在地理处理窗格中隐藏。由于其存储在 Project.spr 文件中，因此您可以生成其他产品，而无需从输入镶嵌中重新计算信息。要为同一工程生成其他产品，请再次运行该工具。
如果输入镶嵌数据集发生更改，请为重建文件夹值指定不同的文件夹。要生成反映镶嵌数据集更改的产品，请指定此新位置并再次运行该工具。
使用感兴趣区域参数可以提高处理速度并为输入镶嵌中的图像子集生成产品。
如果指定了重建选项参数，则 .json 文件或 JSON 字符串的属性将为其余可选参数设置默认值。
以下列表定义了重建选项参数以 .json 文件或 JSON 字符串形式使用的关键字：
- scenario - 指定将用于生成输出产品的影像类型。
- fwdOverlap - 图像之间的向前（条带内）重叠百分比。将 scenario 设置为 AERIAL_NADIR 时，将使用此关键字。
- swdOverlap - 图像之间的侧方（跨条带）重叠百分比。将 scenario 设置为 AERIAL_NADIR 时，将使用此关键字。
- quality - 指定最终产品的质量。
- products - 指定要生成的产品。
- srs - WKT 格式的工程地理坐标系。
- tileSize - 分块大小。值可以为 AUTO 或双精度型。
- cellSize - 输出栅格产品的像元大小。该值是自动估计的，但可以手动定义。值可以为 AUTO 或双精度型。
- cellSizeMultiplicator - 像元大小标量值。该值是自动估计的，但可以手动定义。值可以为 AUTO 或双精度型。
- areaX - 输出范围的 x 坐标。
- areaY - 输出范围的 y 坐标。
- areaZ - 输出范围的 z 坐标。
- areaFeatures - 感兴趣区域。
- waterbodyFeatures - 用于指定大型水体范围的面。
- correctionFeatures - 用于指定所有非水体表面的范围的面。
- gpuStatus - 用于指定 GPU 是否将用于处理的布尔值。默认值取决于“处理器类型”环境值。
- applyGlobalColorBalancing - 指定是否应用颜色平衡的布尔值。默认值为 true。
- orthoEnhanceTexture - 指定是否将对 DSM 正射产品进行纹理增强的布尔值。默认值为 false。
- meshEnhanceTexture - 指定是否将对网格产品进行纹理增强的布尔值。默认值为 true。
- colorBitDepth - 指定真正射和 DSM 产品颜色位深度的整数值。有效值为 8 和 16。默认值为 8 位。
- dsmDepthBuffer - 定义 DSM 像元中多少个最高点将用于计算像元高度值的整数。默认情况下，该值将自动确定，但也可以手动指定。
- exportAdditionalTFWs - 指定是否导出附加 .tfw 文件的布尔值。默认值为 true。
- exportImagePyramidsInTIFFs - 指定是否在 .tiff 文件中导出影像金字塔的布尔值。默认值为 true。
- dsmMetaProducts - 指定输出中将包含的 DSM 元信息产品。值可以包含 DSM_CELL_POINT_COUNT、DSM_HEIGHT_COLORED、DSM_POINT_COLOR、DSM_POINT_COLOR_INTERPOLATE、DSM_BINARY_MASK、DSM_DISTANCE_MAP、DSM_POINT_MODEL_COUNT、DSM_CELL_SD 和 DSM_ROUGHNESS 的任意组合。
- meshAndTextureFormats - 指定网格输出格式。仅兼容特定的网格和纹理格式组合。下表中列出了支持的组合。默认情况下，使用 OSGB 和 S3TC 格式。
  MeshFileFormat TextureFileFormat
  OSGB
  S3TC
  3D_TILES
  JPG 和 S3TC
  SLPK
  JPG、JPG 和 DDS
  LOD_OBJ
  JPG、PNG 和 DDS
  LOD_DAE
  JPG、PNG 和 DDS
  DAE
  JPG 和 PNG
  OBJ
  JPG 和 PNG
- 3dTilesOverImposeHeightsOnTargetEllipsoid - 此布尔值用于指定是否将包括高度在内的所有尺寸都转换为 Cesium (WGS 84) 使用的坐标系而不进行任何修改。如果此选项为 false，则输入网格的高度值将被解释为 Cesium 椭球上方的高度。默认值为 true。
- 3dTilesExportInPCS - 指定是否将为 3D 切片网格格式执行坐标系转换的布尔值。如果为 false，则将 3D 切片网格结果转换为具有 EGM96 大地水准面高度的 WGS84 坐标系。如果为 true，则不会对 3D 切片网格格式执行坐标系转换，除非需要不同的坐标系。默认值为 false。
- slpkExportInPCS - 指定是否将为 SLPK 网格格式执行坐标系转换的布尔值。如果为 false，则将 SLPK 网格结果转换为具有 EGM96 大地水准面高度的 WGS84 坐标系。如果为 true，则不会对 SLPK 网格格式执行坐标系转换，除非需要不同的坐标系。默认值为 true。
重建选项参数的默认值仅用于新创建的重建文件夹。如果重建文件夹存在，则将保留现有重建文件夹中的默认值。

MeshFileFormat	TextureFileFormat
OSGB	S3TC
3D_TILES	JPG 和 S3TC
SLPK	JPG、JPG 和 DDS
LOD_OBJ	JPG、PNG 和 DDS
LOD_DAE	JPG、PNG 和 DDS
DAE	JPG 和 PNG
OBJ	JPG 和 PNG

以下提供了指定为 .json 文件的重建选项参数值的示例：

{
    "scenario": "AERIAL_NADIR",
    "fwdOverlap": .60,
    "swdOverlap": .30,
    "quality": "HIGH",
    "products": "DSM;TRUE_ORTHO;DSM_MESH",
    "areaX": [424960.019858008, 425010.984614762],
    "areaY": [5132484.30528369, 5132517.9432181],
    "gpuStatus": True,
    "applyGlobalColorBalancing": True,
    "dsmMetaProducts": "DSM_HEIGHT_COLORED;DSM_ROUGHNESS"

}

参数

标注	说明	数据类型
输入镶嵌数据集	调整的输入镶嵌数据集。	Mosaic Dataset; Mosaic Layer
重建文件夹	输出数据集文件夹。	Folder
重建选项 (可选)	用于指定工具参数值的 .json 文件或 JSON 字符串。如果指定了此参数，则 .json 文件或 JSON 字符串的属性将为其余可选参数设置默认值。有关选项列表，请参阅以上用法。	File; String
方案 (可选)	指定将用于生成输出产品的影像类型。默认值—输入影像将被定义为使用无人机或地面照相机获取。航空像底点—输入影像将被定义为使用大型摄影测量照相机系统获取。航空倾斜—输入影像将被定义为使用倾斜照相机系统获取。	String
向前重叠 (可选)	将在图像之间使用的向前（条带内）重叠百分比。默认值为 60。在将方案参数设置为航空像底点时才启用此参数。	Long
侧方重叠 (可选)	将在图像之间使用的侧方（跨条带）重叠百分比。默认值为 30。在将方案参数设置为航空像底点时才启用此参数。	Long
质量 (可选)	指定最终产品的质量。超级—输入图像将以其原始（全）分辨率使用。高—输入图像将被降采样 2 倍。中—输入图像将被降采样 4 倍。低—输入图像将被降采样 8 倍。	String
产品 (可选)	指定将要生成的产品。 DSM—将生成 DSM。默认情况下，当方案参数设置为航空像底点时，将选择该选项。正射影像—将对此影像进行正射校正。默认情况下，当方案参数设置为航空像底点时，将选择该选项。 DSM 网格—将生成 DSM 网格。默认情况下，当方案参数设置为航空像底点时，将选择该选项。点云—将生成图像点云。默认情况下，当方案参数设置为默认值或航空像底点时，将选择该选项。网格—将生成 3D 网格。默认情况下，当方案参数设置为默认值或航空像底点时，将选择该选项。	String
像元大小 (可选)	输出产品的像元大小。	Double; String
感兴趣区域 (可选)	将用于选择要处理的图像的感兴趣区域。感兴趣区域可以自动计算或使用输入 shapefile 定义。如果该值包含 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	调整的输入镶嵌数据集。如果 recon_folder 参数值包含现有工程，则需要为 in_mosaic_dataset 参数指定 None。	Mosaic Dataset; Mosaic Layer
recon_folder	输出数据集文件夹。	Folder
recon_options (可选)	用于指定工具参数值的 .json 文件或 JSON 字符串。如果指定了此参数，则 .json 文件或 JSON 字符串的属性将为其余可选参数设置默认值。有关选项列表，请参阅以上用法。	File; String
scenario (可选)	指定将用于生成输出产品的影像类型。 DEFAULT—输入影像将被定义为使用无人机或地面照相机获取。 AERIAL_NADIR—输入影像将被定义为使用大型摄影测量照相机系统获取。 AERIAL_OBLIQUE—输入影像将被定义为使用倾斜照相机系统获取。	String
fwd_overlap (可选)	将在图像之间使用的向前（条带内）重叠百分比。默认值为 60。当将 scenario 参数设置为 AERIAL_NADIR 时，此参数处于启用状态。	Long
swd_overlap (可选)	将在图像之间使用的侧方（跨条带）重叠百分比。默认值为 30。当将 scenario 参数设置为 AERIAL_NADIR 时，此参数处于启用状态。	Long
quality (可选)	指定最终产品的质量。 ULTRA—输入图像将以其原始（全）分辨率使用。 HIGH—输入图像将被降采样 2 倍。 MEDIUM—输入图像将被降采样 4 倍。 LOW—输入图像将被降采样 8 倍。	String
products [products,...] (可选)	指定将要生成的产品。 DSM—将生成 DSM。默认情况下，当 scenario 参数设置为 AERIAL_NADIR 时，将选择该选项。 TRUE_ORTHO—将对此影像进行正射校正。默认情况下，当 scenario 参数设置为 AERIAL_NADIR 时，将选择该选项。 DSM_MESH—将生成 DSM 网格。默认情况下，当 scenario 参数设置为 AERIAL_NADIR 时，将选择该选项。 POINT_CLOUD—将生成图像点云。默认情况下，当 scenario 参数设置为 DEFAULT 或 AERIAL_OBLIQUE 时，将选择该选项。 MESH—将生成 3D 网格。默认情况下，当 scenario 参数设置为 DEFAULT 或 AERIAL_OBLIQUE 时，将选择该选项。	String
cell_size (可选)	输出产品的像元大小。	Double; String
aoi (可选)	将用于选择要处理的图像的感兴趣区域。感兴趣区域可以自动计算或使用输入 shapefile 定义。如果该值包含 3D 几何，则将忽略 z 分量。如果该值包括重叠要素，则将计算这些要素的并集。 NONE—所有影像都将用于处理。 AUTO—将自动计算处理范围。这是默认设置。	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, "DEFAULT", 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":"DEFAULT","quality":"HIGH","products":"DSM;TRUE_ORTHO;DSM_MESH","cellSize":0.05,"correctionFeatures":"\\\\shared_location\\RMeTesting.gdb\\CorrectionFeature","meshAndTextureFormats":{"OSGB":"S3TC","SLPK":"JPG","OBJ":"JPG","LOD_DAE":"PNG"},"applyGlobalColorBalancing":true,"areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI"}')

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,	scenario, forward_overlap, side_overlap, out_quality, output_products)

环境

范围, 处理器类型

许可信息

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

摘要

许可：

使用情况

参数

派生输出

派生输出

代码示例

环境

许可信息

相关主题

在本主题中