创建点云场景图层包 (数据管理)

摘要

从 LAS、zLAS、LAZ 或 LAS 数据集输入创建点云场景图层包(.slpk 文件)。

使用情况

  • 输出坐标系应与显示 web 场景所使用的坐标系相匹配。如果预期显示环境将为全球 web 场景视图,则输出坐标系必须使用 GCS WGS 84 或 China Geodetic Coordinate System 2000。全球场景的垂直坐标系必须为椭圆体或 EGM2008 大地水准面或 EGM96 大地水准面。

  • 所有正在进行处理的 LAS、ZLAS 或 LAZ 文件必须具有相同的空间参考。如果所需的 LAS 或 ZLAS 文件集使用多个空间参考,请考虑使用提取 LAS 工具将数据重新投影到公共空间参考。包含未知坐标系的数据集将无法作为此工具的输入。

  • LAS、ZLAS 或 LAZ 文件可以在其标头中定义其空间参考,或者使用放置于相同位置的基本名称相同的 PRJ 文件定义其空间参考。PRJ 文件将覆盖标头中的信息,并可用于校正缺失或无效的空间参考信息。如果所有正在进行处理的 LAS、ZLAS 或 LAZ 文件具有未知坐标,但使用相同的空间参考,则只有一个文件需要具有 PRJ 定义,以便于工具处理该集合。可使用创建 LAS 数据集工具生成 PRJ 文件。

  • 缺少坐标系信息的 LAZ 文件也可以通过输入坐标系参数进行定义。

  • 如果场景图层包中的文件大小小于 1 GB,则可在浏览器中直接将其上传至 ArcGIS OnlinePortal for ArcGIS。如果点云场景图层包中的文件大小大于 1 GB,请使用共享包工具将其上传至 ArcGIS OnlinePortal for ArcGIS 10.5 或更高版本。

参数

标注说明数据类型
输入数据集

激光雷达数据(LAS、zLAS、LAZ 或 LAS 数据集),可用于创建场景图层包。也可以通过选择包含所需文件的父文件夹来指定激光雷达数据。

Layer File; LAS Dataset Layer; Folder; File
输出场景图层包

输出场景图层包 (.slpk)。

File
输出坐标系
(可选)

输出场景图层包的坐标系。它可以是任意投影坐标系或自定义坐标系。支持的地理坐标系包括 WGS 1984 和 China Geodetic Coordinate System 2000。WGS 1984 和 EGM96 大地水准面分别是默认的水平和垂直坐标系。可通过以下任一方式指定坐标系:

  • 指定 .prj 文件的路径。
  • 引用具有所需坐标系的数据集。
  • 使用 arcpy.SpatialReference 对象。

Spatial Reference
地理(坐标)变换
(可选)

此基准面变换方法适用于输入图层坐标系所使用的基准面不同于输出坐标系的情况。所有变换均为双向,而不管其名称隐含的方向如何。例如,即使基准面变换为从 WGS 1984 到 NAD 1927,NAD_1927_to_WGS_1984_3 仍可正常运行。

注:

在椭圆体和重力相关的基准面以及两个与重力相关的基准面之间进行垂直基准面变换时,需要使用 ArcGIS 坐标系数据。

String
缓存的属性
(可选)

指定要包含在场景图层包中的源数据属性。在其他查看器中使用内容时,可以访问这些值。选择所需渲染和过滤选项需要的属性(例如,强度、回波、类代码、RGB)。排除不需要的属性以降低存储。

  • 强度 每个激光雷达点的激光脉冲的回波强度。
  • RGB针对每个激光雷达点采集的 RGB 影像信息。
  • LAS 标记分类和扫描方向标记。
  • 分类代码分类代码值。
  • 返回值激光雷达脉冲的离散回波编号。
  • 用户数据可自定义属性的取值范围是 0 到 255。
  • 点源 ID对于航空激光雷达,此值通常用于标识采集了给定激光雷达点的飞行路径。
  • GPS 时间 从飞机发射激光点的 GPS 时间戳。此时间以 GPS 一周的秒数表示,其中时间戳介于 0 和 604800 之间,并在星期日的午夜重置。
  • 扫描角度给定激光雷达点的激光扫描仪的角度方向。值的范围从 -90 到 90。
  • 近红外针对每个激光雷达点采集的近红外记录。
String
点大小 (m)
(可选)

激光雷达数据的点大小 对于机载激光雷达数据,默认值 0 或接近平均点间距的值通常为最佳。对于地形激光雷达数据,点大小应与感兴趣区域所需的点间距匹配。值以米为单位表示。默认值 0 将自动确定输入数据集的最佳值。

Double
XY 最大误差(m)
(可选)

容许最大 x,y 误差。容差越大,数据压缩越好,并且数据传输效率越高。值以米为单位表示。默认值为 0.01。

Double
Z 最大误差(m)
(可选)

容许最大 z 误差。容差越大,数据压缩越好,并且数据传输效率越高。值以米为单位表示。默认值为 0.01。

Double
输入坐标系
(可选)

输入 LAZ 文件的坐标系。此参数仅用于标头中不包含空间参考信息且不具有 .prj 文件的 LAZ 文件。

Coordinate System
场景图层版本
(可选)

生成的点云场景图层包的 Indexed 3D Scene Layer (I3S) 版本。指定版本支持向后兼容,并允许与较早版本的 ArcGIS 共享场景图层包。

  • 1.x在所有 ArcGIS 客户端中均受支持。
  • 2.xArcGIS Pro 2.1.2 或更高版本中受支持,并且可以发布到 ArcGIS Online 以及 ArcGIS 10.6.1 或更高版本。这是默认设置。
String

arcpy.management.CreatePointCloudSceneLayerPackage(in_dataset, out_slpk, {out_coor_system}, {transform_method}, {attributes}, {point_size_m}, {xy_max_error_m}, {z_max_error_m}, {in_coor_system}, {scene_layer_version})
名称说明数据类型
in_dataset

激光雷达数据(LAS、zLAS、LAZ 或 LAS 数据集),可用于创建场景图层包。也可以通过选择包含所需文件的父文件夹来指定激光雷达数据。

Layer File; LAS Dataset Layer; Folder; File
out_slpk

输出场景图层包 (.slpk)。

File
out_coor_system
(可选)

输出场景图层包的坐标系。它可以是任意投影坐标系或自定义坐标系。支持的地理坐标系包括 WGS 1984 和 China Geodetic Coordinate System 2000。WGS 1984 和 EGM96 大地水准面分别是默认的水平和垂直坐标系。可通过以下任一方式指定坐标系:

  • 指定 .prj 文件的路径。
  • 引用具有所需坐标系的数据集。
  • 使用 arcpy.SpatialReference 对象。

Spatial Reference
transform_method
[transform_method,...]
(可选)

此基准面变换方法适用于输入图层坐标系所使用的基准面不同于输出坐标系的情况。所有变换均为双向,而不管其名称隐含的方向如何。例如,即使基准面变换为从 WGS 1984 到 NAD 1927,NAD_1927_to_WGS_1984_3 仍可正常运行。

注:

在椭圆体和重力相关的基准面以及两个与重力相关的基准面之间进行垂直基准面变换时,需要使用 ArcGIS 坐标系数据。

String
attributes
[attributes,...]
(可选)

指定要包含在场景图层包中的源数据属性。在其他查看器中使用内容时,可以访问这些值。选择所需渲染和过滤选项需要的属性(例如,强度、回波、类代码、RGB)。排除不需要的属性以降低存储。

  • INTENSITY 每个激光雷达点的激光脉冲的回波强度。
  • RGB针对每个激光雷达点采集的 RGB 影像信息。
  • FLAGS分类和扫描方向标记。
  • CLASS_CODE分类代码值。
  • RETURNS激光雷达脉冲的离散回波编号。
  • USER_DATA可自定义属性的取值范围是 0 到 255。
  • POINT_SRC_ID对于航空激光雷达,此值通常用于标识采集了给定激光雷达点的飞行路径。
  • GPS_TIME 从飞机发射激光点的 GPS 时间戳。此时间以 GPS 一周的秒数表示,其中时间戳介于 0 和 604800 之间,并在星期日的午夜重置。
  • SCAN_ANGLE给定激光雷达点的激光扫描仪的角度方向。值的范围从 -90 到 90。
  • NEAR_INFRARED针对每个激光雷达点采集的近红外记录。
String
point_size_m
(可选)

激光雷达数据的点大小 对于机载激光雷达数据,默认值 0 或接近平均点间距的值通常为最佳。对于地形激光雷达数据,点大小应与感兴趣区域所需的点间距匹配。值以米为单位表示。默认值 0 将自动确定输入数据集的最佳值。

Double
xy_max_error_m
(可选)

容许最大 x,y 误差。容差越大,数据压缩越好,并且数据传输效率越高。值以米为单位表示。默认值为 0.01。

Double
z_max_error_m
(可选)

容许最大 z 误差。容差越大,数据压缩越好,并且数据传输效率越高。值以米为单位表示。默认值为 0.01。

Double
in_coor_system
(可选)

输入 LAZ 文件的坐标系。此参数仅用于标头中不包含空间参考信息且不具有 .prj 文件的 LAZ 文件。

Coordinate System
scene_layer_version
(可选)

生成的点云场景图层包的 Indexed 3D Scene Layer (I3S) 版本。指定版本支持向后兼容,并允许与较早版本的 ArcGIS 共享场景图层包。

  • 1.X在所有 ArcGIS 客户端中均受支持。
  • 2.XArcGIS Pro 2.1.2 或更高版本中受支持,并且可以发布到 ArcGIS Online 以及 ArcGIS 10.6.1 或更高版本。这是默认设置。
String

代码示例

CreatePointCloudSceneLayerPackage 示例(Python 窗口)

以下 Python 脚本演示了如何在 Python 窗口中使用 CreatePointCloudSceneLayerPackage 函数。

import arcpy
arcpy.env.workspace = "c:/gis_data"
arcpy.management.CreateSceneLayerPackage(
    "Milan.lyrx", "Milan.slpk", arcpy.SpatialReference(4326), 
    ["ITRF_2000_To_WGS_1984 + WGS_1984_To_WGS_1984_EGM2008_2.5x2.5_Height"],
    ["INTENSITY", "RGB", "CLASS_CODE", "FLAGS", "RETURNS"], 0, 0.1, 0.1, None, 
    "1.X")

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题