构建或更新 LAS 数据集显示缓存，以优化其渲染性能。
LAS 数据集金字塔将存储在与 LAS 数据集相同的位置：在一个目录中，该目录的名称以 LAS 数据集的名称开头并以 .slas 结尾。该金字塔通常占据 LAS 数据集引用的 LAS 文件总大小的三分之一，并且由多层逐渐细化的 LAS 点组成。通过将点所在的空间划分为图格并使用点选择方法在每个图格区域中选择一个点来确定参与每个级别的点。
通过构造 LAS 数据集金字塔，可最大程度地利用可用内存资源来加快操作速度。如果没有足够的可用 RAM，则所需的内存将分页到磁盘。如果可能，请在执行此工具之前，考虑退出不必要的应用程序来释放内存。
将在临时工作空间中生成大小约等于 LAS 文件的大小或 zLAS 文件的未压缩大小的临时文件。确保将临时工作空间设置为具有足够存储空间的位置。
带有金字塔的 LAS 数据集包含一个新方案，该方案在 ArcGIS Desktop 或 ArcGIS Pro 2.6 之前的版本中不受支持。如果这些应用程序中仍在使用 LAS 数据集，考虑使用复制工具创建 LAS 数据集的复本。然后，在复本数据集上构建金字塔。这两个 LAS 数据集可以引用相同的 LAS 文件。如果已构建金字塔并且需要在不支持金字塔的应用程序中使用 LAS 文件，使用创建 LAS 数据集工具创建引用相同文件的 LAS 数据集。不需要源 LAS 文件的另一个副本；需要没有金字塔的另一个 LAS 数据集。
如果将新的 LAS 文件引用添加到 LAS 数据集，从 LAS 数据集中移除现有 LAS 文件引用，或者如果地理处理工具更新了 LAS 数据集引用的 LAS 文件的类代码值，则 LAS 数据集金字塔将过期。此时，可通过在 LAS 数据集上再次运行此工具来更新显示金字塔。
构建 LAS 数据集金字塔后，将无法更改点选择方法。要使用其他点选择方法，删除旧金字塔，然后使用新方法再次运行此工具。
要删除 LAS 数据集金字塔，可使用从 LAS 数据集移除文件工具或通过LAS 数据集属性对话框中的金字塔选项卡。要访问 LAS 数据集属性对话框，右键单击目录窗格或目录视图中的 LAS 数据集，然后选择属性选项。
| 标注 | 说明 | 数据类型 |
输入 LAS 数据集 | 待处理的 LAS 数据集。 | LAS Dataset Layer |
点选择方法
(可选) | 指定如何选择每个图格区域中的点以构建金字塔。如果 LAS 数据集包含金字塔，将禁用此参数。
| String |
输入类代码和权重
(可选) | 赋予每个类代码的权重，用于确定在每个稀疏化区域保留哪些点。仅当在点选择方法参数中指定了类代码权重选项时才会启用该参数。具有最高权重的类代码将保留在稀疏化区域中。如果给定稀疏化区域中存在两个具有相同权重的类代码，则将保留具有最小点源 ID 的类代码。 | Value Table |
| 标注 | 说明 | 数据类型 |
| 输出 LAS 数据集 | 已更新的 LAS 数据集。 | LAS 数据集图层 |
arcpy.management.BuildLasDatasetPyramid(in_las_dataset, {point_selection_method}, {class_codes_weights})| 名称 | 说明 | 数据类型 |
in_las_dataset | 待处理的 LAS 数据集。 | LAS Dataset Layer |
point_selection_method (可选) | 指定如何选择每个图格区域中的点以构建金字塔。如果 LAS 数据集包含金字塔，将禁用此参数。
| String |
class_codes_weights [class_codes_weights,...] (可选) | 赋予每个类代码的权重，用于确定在每个稀疏化区域保留哪些点。仅当在点选择方法参数中指定了类代码权重选项时才会启用该参数。具有最高权重的类代码将保留在稀疏化区域中。如果给定稀疏化区域中存在两个具有相同权重的类代码，则将保留具有最小点源 ID 的类代码。 | Value Table |
| 名称 | 说明 | 数据类型 |
| derived_las_dataset | 已更新的 LAS 数据集。 | LAS 数据集图层 |
下面的示例演示了如何在 Python 窗口中使用此工具。
import arcpy
arcpy.env.workspace = 'C:/data'
arcpy.ddd.BuildLasDatasetPyramid('test.lasd', 'MIN_Z')