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

摘要

从 LAS、zLAS、LAZ 或 LAS 数据集输入在云中创建点云场景图层包 (.slpk) 或场景图层内容 (.i3sREST)。

使用情况

  • 输出坐标系应与显示 web 场景所使用的坐标系相匹配。 如果预期显示环境将为全球 web 场景视图,则输出坐标系必须使用 GCS WGS84 或 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 文件也可以通过输入坐标系参数进行定义。

  • 使用目标云连接参数将场景图层内容输出到位于云中的对象存储,例如 Amazon S3Azure Blob 存储、Alibaba OSSGoogle Cloud。 可将此内容发布为场景服务,并且您选择的位置必须在 ArcGIS Enterprise 中注册为用户管理数据存储

  • 您可以使用创建云存储连接文件工具来构建连接文件 (.acs)。

参数

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

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

Layer File; LAS Dataset Layer; Folder; File
输出场景图层包
(可选)

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

File
输出坐标系
(可选)

输出场景图层包的坐标系。 它可以是任意投影坐标系或自定义坐标系。 支持的地理坐标系包括 WGS84 和 China Geodetic Coordinate System 2000。 WGS84 和 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.001。

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

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

Double
输入坐标系
(可选)

输入 .laz 文件的坐标系。 此参数仅用于标头中不包含空间参考信息或在相同位置不具有 .prj 文件的 .laz 文件。

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

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

  • 1.x所有 ArcGIS 客户端都将支持点云场景图层包。
  • 2.x点云场景图层包将在 ArcGIS AllSource 2.1.2 或更高版本中受支持,并且可以发布到 ArcGIS Online 和 ArcGIS 10.6.1 或更高版本。 这是默认设置。
String
目标云连接
(可选)

将输出场景图层内容 (.i3sREST) 的目标云连接文件 (.acs)。

Folder
输出名称
(可选)

输出到云存储时场景图层内容的输出名称。 仅在已指定目标云连接参数值的情况下,此参数才适用。

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}, {target_cloud_connection}, {out_name})
名称说明数据类型
in_dataset

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

Layer File; LAS Dataset Layer; Folder; File
out_slpk
(可选)

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

File
out_coor_system
(可选)

输出场景图层包的坐标系。 它可以是任意投影坐标系或自定义坐标系。 支持的地理坐标系包括 WGS84 和 China Geodetic Coordinate System 2000。 WGS84 和 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.001。

Double
z_max_error_m
(可选)

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

Double
in_coor_system
(可选)

输入 .laz 文件的坐标系。 此参数仅用于标头中不包含空间参考信息或在相同位置不具有 .prj 文件的 .laz 文件。

Coordinate System
scene_layer_version
(可选)

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

  • 1.X所有 ArcGIS 客户端都将支持点云场景图层包。
  • 2.X点云场景图层包将在 ArcGIS AllSource 2.1.2 或更高版本中受支持,并且可以发布到 ArcGIS Online 和 ArcGIS 10.6.1 或更高版本。 这是默认设置。
String
target_cloud_connection
(可选)

将输出场景图层内容 (.i3sREST) 的目标云连接文件 (.acs)。

Folder
out_name
(可选)

输出到云存储时场景图层内容的输出名称。 此参数仅在已指定 target_cloud_connection 参数值时可用。

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")

环境

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