将文件添加到 LAS 数据集 (数据管理)

在 Standard 或 Advanced 许可等级下可用。

需要 3D Analyst 许可。

需要 Spatial Analyst 许可。

摘要

将一个或多个 LAS 文件和表面约束要素的引用添加到 LAS 数据集。

使用情况

• LAS 数据集旨在配合 LAS 或 ZLAS 格式的激光雷达数据使用。 支持的 LAS 格式文件版本为 1.0 - 1.4。 EzLAS Optimizer 是一个独立的雷达激光应用程序，可用于生成 .zlas 文件或将它们转换回 LAS 格式。

• 表面约束要素可用于强化 LAS 数据集中要素衍生的表示表面特征的高程值。

• LAS 格式支持根据美国摄影测量与遥感协会 (ASPRS) 制定的规范对每个点进行分类。 ArcGIS 平台应用为 LAS 格式文件版本 1.4 指定的分类方案：

  分类值	分类类型
  0	从不分类
  1	未分配
  2	地面
  3	低植被
  4	中等植被
  5	高植被
  6	建筑物
  7	低噪音
  8	模型关键点/保留
  9	水域
  10	铁路
  11	路面
  12	重叠/保留
  13	钢丝护网
  14	导线
  15	输电塔
  16	线 - 连接器
  17	桥板
  18	高噪音
  19 – 63	为 ASPRS 定义保留（LAS 1.1 至 1.3 最高支持类代码 31）
  32 – 255	可由用户定义（仅 LAS 1.0 和 1.4 的特定版本支持）

  注：

  尽管 LAS 1.4 引入的大部分类代码分配先前已被指定为“保留”，但类代码 8 和 12 已相应地从“模型关键和重叠”更改为“保留”。

参数

对话框

标注	说明	数据类型
输入 LAS 数据集	待处理的 LAS 数据集。	LAS Dataset Layer
LAS 文件或文件夹 (可选)	输入文件可引用包含 LAS 数据的各个 LAS 文件和文件夹的任意组合。 在“工具”对话框中，可将文件夹指定为输入，具体方法如下：在 Windows 资源管理器中选择文件夹，然后将其拖动到参数的输入框上。	Folder; File
包括子文件夹 (可选)	指定 LAS 数据集是否引用位于输入文件夹子目录中的 .las 文件。 未选中 - 仅位于输入文件夹中的 .las 文件会添加到 LAS 数据集。 这是默认设置。 选中 - 位于输入文件夹子目录中的所有 .las 文件都将被添加到 LAS 数据集。	Boolean
表面约束 (可选)	将构成由 LAS 数据集生成的三角化网格面定义的要素。 输入要素 - 其几何将整合到 LAS 数据集的三角化网格面的要素。 高度字段 - 通过选择 Shape.Z，可以从要素属性表或几何中的任何数值字段获取要素的高程源。 如果无需高度，则指定关键字 <None> 来创建 z-less 要素，其高程由表面内插得到。 类型 - 定义由 LAS 数据集生成的三角化网格面中的要素角色。 具有硬或软标识的选项表示要素边是否表示坡度的明显中断或平缓变化。 表面要素类型 - 定义如何将要素几何加入到表面的三角网中的表面要素类型。 具有硬或软标识的选项表示要素边是否表示坡度的明显中断或平缓变化。 锚点 - 不会被细化掉的高程点。 此选项仅可用于单点要素几何。 硬断线或软断线 - 强制高度值的隔断线。 硬裁剪或软裁剪 - 定义 LAS 数据集边界的面数据集。 硬擦除或软擦除 - 定义 LAS 数据集中的孔的面数据集。 硬替换或软替换 - 定义高度恒定的区域的面数据集。	Value Table

派生输出

标注	说明	数据类型
更新后的输入 LAS 数据集	已更新的 LAS 数据集。	LAS 数据集图层

Python

arcpy.management.AddFilesToLasDataset(in_las_dataset, {in_files}, {folder_recursion}, {in_surface_constraints})

名称	说明	数据类型
in_las_dataset	待处理的 LAS 数据集。	LAS Dataset Layer
in_files [in_files,...] (可选)	输入文件可引用包含 LAS 数据的各个 LAS 文件和文件夹的任意组合。 在“工具”对话框中，可将文件夹指定为输入，具体方法如下：在 Windows 资源管理器中选择文件夹，然后将其拖动到参数的输入框上。	Folder; File
folder_recursion (可选)	指定位于输入文件夹子目录中的激光雷达数据是否将添加到 LAS 数据集。 NO_RECURSION—未选中 - 仅位于输入文件夹中的激光雷达文件会添加到 LAS 数据集。 这是默认设置。 RECURSION—位于输入文件夹子目录中的所有激光雷达文件都将被添加到 LAS 数据集。	Boolean
in_surface_constraints [[in_feature_class, height_field, SF_type],...] (可选)	生成三角化网格面时，LAS 数据集将引用的要素。 每个要素都必须定义以下属性： in_feature_class - LAS 数据集将引用的要素。 height_field - 要素属性表中可用于定义高度源的任何数值字段。 如果要素几何包含 Z 值，则可以通过指定 Shape.Z 进行选择。 如果无需高度，则指定关键字 <None> 来创建 z-less 要素，其高程由表面内插得到。 SF_type - 定义如何将要素几何加入到表面的三角网中的表面要素类型。 具有硬或软标识的选项表示要素边是否表示坡度的明显中断或平缓变化。 锚点 - 不会被细化掉的高程点。 此选项仅可用于单点要素几何。 硬断线或软断线 - 强制高度值的隔断线。 硬裁剪或软裁剪 - 定义 LAS 数据集边界的面数据集。 硬擦除或软擦除 - 定义 LAS 数据集中的孔的面数据集。 硬替换或软替换 - 定义高度恒定的区域的面数据集。	Value Table

派生输出

名称	说明	数据类型
derived_las_dataset	已更新的 LAS 数据集。	LAS 数据集图层

代码示例

AddFilesToLasDataset 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具。

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.AddFilesToLasDataset_management("test.lasd", 
                                      ["LA_N", "LA_S/LA_5S4E.las"],
                                      "RECURSION", 
                                      ["boundary.shp <None> Soft_Clip",
                                       "breakline.shp Shape.Z Hard_Line"])

AddFilesToLasDataset 示例 2（独立脚本）

下面的示例演示了如何在独立 Python 脚本中使用此工具。

'''*********************************************************************
Name: Modify Files in LAS Dataset& Calculate Stats for LASD
Description: Adds files & surface constraints to a LAS dataset, then
             calculates statistics and generates report.
*********************************************************************'''
# Import system modules
import arcpy

try:
    # Script variables
    arcpy.env.workspace = 'C:/data'
    lasd = 'sample.lasd'
    oldLas = ['2006', '2007/file2.las']
    newLas = ['2007_updates_1', '2007_updates_2']
    oldSurfaceConstraints = ['boundary.shp', 'streams.shp']
    newSurfaceConstraints = [['sample.gdb/boundary', '<None>',
                              'Soft_Clip']
                             ['sample.gdb/streams', 'Shape.Z',
                              'Hard_Line']]
    arcpy.management.RemoveFilesFromLasDataset(lasd, oldLas,
                                               oldSurfaceConstraints)
    arcpy.management.AddFilesToLasDataset(lasd, newLas, 'RECURSION',
                                          newSurfaceConstraints)
    arcpy.management.LasDatasetStatistics(lasd, "UPDATED_FILES",
                                          "lasd_stats.txt",
                                          "LAS_FILE", "DECIMAL_POINT",
                                          "SPACE", "LAS_summary.txt")
except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err.args[0])

环境

当前工作空间, 临时工作空间

特殊情况

许可信息

• Basic: 需要 3D Analyst 或 Spatial Analyst
• Standard: 是
• Advanced: 是