重新构建表面 (数据管理)

在 Advanced 许可等级下可用。

摘要

根据调整后的影像生成 DSM 正射影像、2.5D 网格、3D 网格和点云。

许可：

重新构建表面工具仅在有限的仅能通过邀请使用的 Beta 测试版本中提供。

使用情况

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

• 运行该工具后，将在重建文件夹值中创建一个 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 - 指定是否应用颜色平衡的布尔值。
  • orthoEnhanceTexture - 指定是否将对 DSM 正射产品进行纹理增强的布尔值。
  • meshEnahnceTexture - 指定是否将对网格产品进行纹理增强的布尔值。
  • force8BitColor - 指定是否无论输入如何，均将使用 8 位色彩的布尔值。
  • dsmDepthBuffer - 定义 DSM 像元中多少个最高点将用于计算像元高度值的整数。 默认情况下，该值将自动确定，但也可以手动指定。
  • exportAdditionalTFWs - 指定是否导出附加 .tfw 文件的布尔值。
  • exportImagePyramidsInTIFFs - 指定是否在 .tiff 文件中导出影像金字塔的布尔值。
  • 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
    CESIUM	JPG 和 S3TC
    SLPK	JPG、JPG 和 DDS
    LOD_OBJ	JPG、PNG 和 DDS
    LOD_DAE	JPG、PNG 和 DDS
    DAE	JPG 和 PNG
    OBJ	JPG 和 PNG

  • cesiumOverImposeHeightsOnTargetEllipsoid - 此布尔值用于指定是否将包括高度在内的所有尺寸都转换为 Cesium (WGS 84) 使用的坐标系而不进行任何修改。 如果此选项为 False，则输入网格的高度值将被解释为 Cesium 椭球上方的高度。
  • cesiumDracoCompression - 指定是否会减小网格大小以提高性能的布尔值。
  • slpkExportInPCS - 指定是否将为 SLPK 网格格式执行坐标系转换的布尔值。 默认情况下，SURE 会将 SLPK 网格结果转换为具有 EGM96 大地水准面高度的 WGS 84 坐标系。 如果是 True，则不会对 SLPK 网格格式执行坐标系转换，除非需要不同的坐标系。 当此选项为 True 时，必须定义水平和垂直坐标系的 WKID 以及高度模型和高度单位。

• 以下提供了指定为 .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 Class; Feature Layer; File; String
水体要素 (可选)	将用于定义大型水体范围的面。 要获得最佳效果，请使用 3D shapefile。	Feature Class; Feature Layer; File; String
校正要素 (可选)	将用于定义所有非水体表面的范围的面。 该值必须为 3D shapefile。	Feature Class; Feature Layer; File; String

派生输出

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

Python

arcpy.management.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 参数值包含现有工程，则需要为 None 参数指定 in_mosaic_dataset。	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 Class; Feature Layer; File; String
waterbody_features (可选)	将用于定义大型水体范围的面。 要获得最佳效果，请使用 3D shapefile。	Feature Class; Feature Layer; File; String
correction_features (可选)	将用于定义所有非水体表面的范围的面。 该值必须为 3D shapefile。	Feature Class; Feature Layer; File; String

派生输出

名称	说明	数据类型
derived_recon_folder	输出重建文件夹。	Folder

代码示例

ReconstructSurface 示例 1（Python 窗口）

本示例使用正射影像创建了 3D 网格。

# Import system modules
import arcpy

3d_surface = arcpy.management.ReconstructSurface(r"C:\SURE.gdb\droneMD", r"C:\RS_output", None, "DEFAULT", 
	   None, None, "HIGH", "TRUE_ORTHO", 0.1, r"\\shared_location\RMeTesting.gdb\AOI", None, 
	   r"\\shared_location\RMTesting.gdb\CorrectionFeature")

ReconstructSurface 示例 2（Python 窗口）

此示例从正射影像创建 DSM、DSM 网格和真正射

# Import system modules
import arcpy

surface = arcpy.management.ReconstructSurface(r"C:\SURE.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,"meshEnhanceTexture":true,"areaFeatures":"\\\\shared_location\\RMeTesting.gdb\\AOI"}')

ReconstructSurface 示例 3（独立脚本）

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

# Import system modules
import arcpy


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

#Execute - Generate Products
surface = arcpy.management.ReconstructSurface(in_mosaic, out_folder,json_file,
		scenario, forward_overlap, side_overlap, out_quality, output_products)

环境

范围, 处理器类型

许可信息

• Basic: 否
• Standard: 需要 现实映射
• Advanced: 需要 现实映射