使用训练模型对点云进行分类 (3D Analyst 工具)

汇总

使用深度学习模型对点云进行分类。

用法

此工具需要安装深度学习框架。

要设置计算机以在 ArcGIS Pro 中使用深度学习框架，请参阅安装 ArcGIS 的深度学习框架。
该工具默认情况下对输入点云中的所有点进行分类。如果输入点云中的任何现有类代码已正确分类，请使用现有类代码处理和现有类代码参数指示应编辑或保留哪些类代码，以使这些点不被修改。

了解有关通过深度学习对点云进行分类的详细信息
输入点云必须具有与用于开发分类模型的训练数据相同的属性。例如，如果训练模型使用强度属性，则正在处理的点云也必须具有强度值。点密度和分布也应与训练模型时使用的数据相似。
如果输入点云的空间参考未使用投影坐标系，则可以使用输出坐标系环境定义在分类点时将使用的投影坐标系。
该模型经过训练，可以处理特定大小的块中的点云数据，这些块包含一定数量的点和一组给定属性。通过将输入点云划分到由模型定义的块中对其进行处理。可以在任何给定时间处理多个块。一起处理的一组块称为一批。批次大小用于控制推断操作期间将使用的计算机资源量。虽然可以使用 CPU 来处理点云，但使用支持 CUDA 的 NVIDIA GPU 可以更高效地运行推断。可以通过指定批量大小参数中的值来控制同时处理的块数，以限制消耗的 GPU 内存量。避免指定超出计算机资源的批次大小。可以通过 NVIDIA 的系统管理接口 (SMI) 实用程序来观察该工具运行之前和运行期间的可用 GPU 内存。将随 GPU 的 NVIDIA 驱动程序一起自动安装此命令行实用程序。此应用程序将追踪 GPU 使用情况。要控制工具运行时剩余的可用内存量，请考虑评估具有较小批次大小的点云数据的子集，并逐渐增大该值，直至达到所需使用量为止。否则，可以将该工具设置为自动最大限度地利用 GPU 的内存。
当使用相对高度属性训练输入模型时，需要参考表面参数。栅格表面用作参考高度，从该高度开始为每个点插入相对高度。这为模型提供了附加信息，这些信息有助于区分对象。为此参数提供的栅格表面应表示与创建模型的训练数据中使用的栅格相同类型的数据。在大多数情况下，这将是从地面分类点创建的栅格。通过应用地面过滤器并使用 LAS 数据集转栅格 工具，可以从 LAS 数据集中的地面分类点生成栅格表面。也可以使用 点云转栅格 工具从点云场景图层生成地面表面。或者，可以使用非基于输入点云的栅格表面，但必须确保栅格中的 z 值与点云中的 z 值相应匹配。
当输入模型在训练时某些类的点被排除在训练数据之外时，请使用排除类代码参数来确保从模型评估的点集中忽略这些点。排除不为给定模型的目标提供有用上下文的类将减少被评估的点数，这将提高训练和应用模型的速度。例如，表示建筑物的点通常与表示交通信号灯、电力线或汽车等对象的点无关。也可以使用 分类 LAS 建筑物 工具对建筑物点进行正确分类。如果在用于创建模型的训练数据中排除了表示建筑物的类代码为 6 的点，则输入点云还必须对建筑物点进行分类，并将其在此工具中排除。

标注	说明	数据类型
目标点云	将进行分类的点云。	LAS Dataset Layer
输入模型定义	要用于对点云进行分类的输入 Esri 模型定义文件 (`.emd`) 或深度学习包 (`.dlpk`)。您也可以使用在 ArcGIS Online 或 ArcGIS Living Atlas 上发布的深度学习包的 URL。	File; String
目标分类	训练模型中的类代码，将用于对输入点云进行分类。除非已指定子集，否则默认情况下将使用输入模型中的所有类。	String
现有类代码处理（可选）	指定如何定义输入点云中的可编辑点。 Edit All Points—All points in the input point cloud will be edited. This is the default. Edit Selected Points—Only points with class codes specified in the Existing Class Codes parameter will be edited; all other points will remain unchanged. Preserve Selected Points—Points with class codes specified in the Existing Class Codes parameter will be preserved; the remaining points will be edited.	String
现有类代码（可选）	将根据现有类代码处理参数值编辑点或保留原始类代码名称的类。	Long
计算统计数据（可选）	指定是否将计算 LAS 数据集引用的 `.las` 文件的统计数据。计算统计数据时会为每个 `.las` 文件提供一个空间索引，从而提高了分析和显示性能。统计数据还可通过将 LAS 属性（如分类代码和回波信息）显示限制为 `.las` 文件中存在的值来提升过滤和符号系统体验。选中—Statistics will be computed. This is the default. 未选中—Statistics will not be computed.	Boolean
处理边界	面边界，可用于定义要通过输入点云处理的点的子集。边界要素之外的点将不会进行评估。	Feature Layer
更新金字塔（可选）	指定在修改类代码后是否更新 LAS 数据集金字塔。选中—The LAS dataset pyramid will be updated. This is the default. 未选中—The LAS dataset pyramid will not be updated.	Boolean
参考表面（可选）	将用于为点云数据中的每个点提供相对高度值的栅格表面。在分析中，将不考虑不与栅格重叠的点。	Raster Layer
排除类代码（可选）	将在处理过程中排除的类代码。可以指定 0 到 255 范围内的任何值。	Long
批量大小（可选）	在推断操作期间同时处理的点云数据块数量。通常，批次大小越大，则数据处理速度越快，但需要避免使用对于计算机资源而言过大的批次大小。当使用 GPU 时，可用 GPU 内存是计算机可以处理的有关批次大小的最常见限制。给定块所使用的内存将取决于模型的块点限制和所需点属性。要确定可用的 GPU 内存并获取有关评估 GPU 内存使用情况的详细信息，请使用“用法”部分中介绍的 NVIDIA SMI 命令行实用程序。对于某些架构，如果未指定批次大小，则将计算最佳批次大小。当使用 GPU 时，最佳批次大小将取决于给定数据块消耗的内存量以及运行该工具时可用的 GPU 内存量。当使用 CPU 进行推断时，将在 CPU 线程上处理每个块，并且最佳批次大小计算为可用的未使用 CPU 线程的一半。	Long

派生输出

标注	说明	数据类型
输出点云	通过深度学习模型进行分类的点云。	Feature Layer

arcpy.3d.ClassifyPointCloudUsingTrainedModel(in_point_cloud, in_trained_model, output_classes, {in_class_mode}, {target_classes}, {compute_stats}, boundary, {update_pyramid}, {reference_height}, {excluded_class_codes}, {batch_size})

名称	说明	数据类型
in_point_cloud	将进行分类的点云。	LAS Dataset Layer
in_trained_model	要用于对点云进行分类的输入 Esri 模型定义文件 (`.emd`) 或深度学习包 (`.dlpk`)。您也可以使用在 ArcGIS Online 或 ArcGIS Living Atlas 上发布的深度学习包的 URL。	File; String
output_classes [output_classes,...]	训练模型中的类代码，将用于对输入点云进行分类。除非已指定子集，否则默认情况下将使用输入模型中的所有类。	String
in_class_mode （可选）	指定如何定义输入点云中的可编辑点。 `EDIT_ALL`—All points in the input point cloud will be edited. This is the default. `EDIT_SELECTED`—Only points with class codes specified in the `target_classes` parameter will be edited; all other points will remain unchanged. `PRESERVE_SELECTED`—Points with class codes specified in the `target_classes` parameter will be preserved; the remaining points will be edited.	String
target_classes [target_classes,...] （可选）	将根据 `in_class_mode` 参数值编辑点或保留原始类代码名称的类。	Long
compute_stats （可选）	指定是否将计算 LAS 数据集引用的 `.las` 文件的统计数据。计算统计数据时会为每个 `.las` 文件提供一个空间索引，从而提高了分析和显示性能。统计数据还可通过将 LAS 属性（如分类代码和回波信息）显示限制为 `.las` 文件中存在的值来提升过滤和符号系统体验。 `COMPUTE_STATS`—Statistics will be computed. This is the default. `NO_COMPUTE_STATS`—Statistics will not be computed.	Boolean
boundary	面边界，可用于定义要通过输入点云处理的点的子集。边界要素之外的点将不会进行评估。	Feature Layer
update_pyramid （可选）	指定在修改类代码后是否更新 LAS 数据集金字塔。 `UPDATE_PYRAMID`—The LAS dataset pyramid will be updated. This is the default. `NO_UPDATE_PYRAMID`—The LAS dataset pyramid will not be updated.	Boolean
reference_height （可选）	将用于为点云数据中的每个点提供相对高度值的栅格表面。在分析中，将不考虑不与栅格重叠的点。	Raster Layer
excluded_class_codes [excluded_class_codes,...] （可选）	将在处理过程中排除的类代码。可以指定 0 到 255 范围内的任何值。	Long
batch_size （可选）	在推断操作期间同时处理的点云数据块数量。通常，批次大小越大，则数据处理速度越快，但需要避免使用对于计算机资源而言过大的批次大小。当使用 GPU 时，可用 GPU 内存是计算机可以处理的有关批次大小的最常见限制。给定块所使用的内存将取决于模型的块点限制和所需点属性。要确定可用的 GPU 内存并获取有关评估 GPU 内存使用情况的详细信息，请使用“用法”部分中介绍的 NVIDIA SMI 命令行实用程序。对于某些架构，如果未指定批次大小，则将计算最佳批次大小。当使用 GPU 时，最佳批次大小将取决于给定数据块消耗的内存量以及运行该工具时可用的 GPU 内存量。当使用 CPU 进行推断时，将在 CPU 线程上处理每个块，并且最佳批次大小计算为可用的未使用 CPU 线程的一半。	Long

派生输出

名称	说明	数据类型
out_point_cloud	通过深度学习模型进行分类的点云。	Feature Layer

代码示例

ClassifyPointCloudUsingTrainedModel 示例（独立脚本）

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

import arcpy
arcpy.env.workspace = 'C:/data/'
arcpy.ddd.ClassifyPointCloudUsingTrainedModel(
    '2018_survey.lasd', 'electrical_infrastructure_classification.emd',
    [14, 15], 'EDIT_SELECTED', [0,1]
)

环境

范围, 处理器类型, GPU ID, 输出坐标系, 地理变换

许可信息

基本: 需要 3D Analyst
标准: 需要 3D Analyst
高级: 需要 3D Analyst

使用训练模型对点云进行分类 (3D Analyst 工具)

汇总

用法

参数

派生输出

环境

许可信息

相关主题