点文件信息 (3D Analyst)

摘要

创建面或多面体输出,它们用于捕获有关一个或多个 ASCII 或 LAS 格式点文件的空间范围和统计信息。

插图

点文件信息工具图示

使用情况

  • 每个输出要素都将包含输入文件的 x,y 范围。 可以创建要素,作为描绘每个输入文件 z 范围的 2D 面或多面体。 属性表将包含以下字段:

    • FileName- 与要素关联的点文件的名称。
    • Pt_Count- 点文件中的总点数。
    • Pt_Spacing- 采用指定坐标系线性单位的预估点平均间距。 点间距是假设输入文件中的点在每个输入文件的 x,y 范围内均匀分布的估计值。
    • Z_Min- 文件中最低点的 z 值。
    • Z_Max- 文件中最高点的 z 值。
  • 在处理 .las 文件集合时,可以通过汇总每个文件中的每个类代码的相关信息来创建输出。 生成的输出反映每个类代码的 z 范围。 当使用按类代码汇总参数时,输出将包括一个名为 Class 的字段,其中包含要汇总的类代码,并且与要素关联的每个属性都将反映该类代码的属性。

参数

标注说明数据类型
点数据

待处理的点数据。 支持的输入包括 LAS 数据集、.las 文件、.zlas 文件和包含点记录的 ASCII 文件。 也可以将一个或多个包含文件的文件夹指定为输入。 包含文件夹时,必须在文件后缀参数中指定点文件的文件后缀。

File; Folder
输出要素类

将生成的要素类。

Feature Class
文件格式

指定输入文件的格式。

  • LAS 格式激光雷达输入文件的格式是 LAS 格式激光雷达。
  • 含 XYZ 的 ASCII 文件输入文件的格式是包含 XYZ 的 ASCII 文件。
  • 含 XYZI 的 ASCII 文件输入文件的格式是包含 XYZI 的 ASCII 文件。
  • 生成格式的 ASCII 文件输入文件的格式是 Generate 格式的 ASCII 文件。
String
文件后缀
(可选)

在输入中指定文件夹时,将导入的文件后缀。

String
坐标系
(可选)

输入数据的坐标系。

Coordinate System
包括子文件夹
(可选)

指定是否子文件夹中的数据将用于生成结果。 当所选输入文件夹中的子文件夹目录含有数据时,工具将扫描子文件夹。 为目录结构中的每个文件生成一行输出要素类。

  • 未选中 - 只有输入文件夹中的数据才用于生成结果。 这是默认设置。
  • 选中 - 在输入文件夹及其子目录中找到的任何数据均将用于生成结果。
Boolean
拉伸几何形状
(可选)

指定是将输出创建为 2D 面要素类还是具有拉伸要素(可反映出每个文件中找到的高程范围)的多面体要素类。

  • 未选中 - 输出将创建为 2D 面要素类。 这是默认设置。
  • 选中 - 输出将创建为多面体要素类。
Boolean
小数分隔符
(可选)

文本文件中将用于区分数字的整数部分与其小数部分的小数分隔符。

  • 将使用点作为小数字符。 这是默认设置。
  • 逗号将使用逗号作为小数字符。
String
按类代码汇总
(可选)

指定输出是按类代码还是按文件汇总 .las 文件。 此参数仅适用于 LAS 格式数据,并且需要对每个输入文件进行完整扫描。

  • 未选中 - 每个输出要素将表示 .las 文件中找到的所有数据。 这是默认设置。
  • 选中 - 每个输出要素将表示在 .las 文件中找到的单个类代码。
Boolean
改进 LAS 文件点间距评估
(可选)

指定是否将使用 .las 文件中的点间距的加强版评估,从而减少由不规则数据分布导致的过高评估。

  • 未选中 - 将对 .las 文件使用常规点间距估计值,其中范围由点数均分。 这是默认设置。
  • 选中 - 将使用分组,从而为 .las 文件获取更精确的点间距估计值。 这可能会增加工具运行时间。
Boolean

派生输出

标注说明数据类型
平均点间距

平均点间距。

Double

arcpy.ddd.PointFileInformation(input, out_feature_class, in_file_type, {file_suffix}, {input_coordinate_system}, {folder_recursion}, {extrude_geometry}, {decimal_separator}, {summarize_by_class_code}, {improve_las_point_spacing})
名称说明数据类型
input
[input,...]

待处理的点数据。 支持的输入包括 LAS 数据集、.las 文件、.zlas 文件和包含点记录的 ASCII 文件。 也可以将一个或多个包含文件的文件夹指定为输入。 包含文件夹时,必须在 file_suffix 参数中指定点文件的文件后缀。

File; Folder
out_feature_class

将生成的要素类。

Feature Class
in_file_type

指定输入文件的格式。

  • LAS输入文件的格式是 LAS 格式激光雷达。
  • XYZ输入文件的格式是包含 XYZ 的 ASCII 文件。
  • XYZI输入文件的格式是包含 XYZI 的 ASCII 文件。
  • GENERATE输入文件的格式是 Generate 格式的 ASCII 文件。
String
file_suffix
(可选)

在输入中指定文件夹时,将导入的文件后缀。

String
input_coordinate_system
(可选)

输入数据的坐标系。

Coordinate System
folder_recursion
(可选)

指定是否子文件夹中的数据将用于生成结果。 当所选输入文件夹中的子文件夹目录含有数据时,工具将扫描子文件夹。 为目录结构中的每个文件生成一行输出要素类。

  • NO_RECURSION只有在输入文件夹中找到的数据才用于生成结果。 这是默认设置。
  • RECURSION在输入文件夹及其子目录中找到的任何数据均将用于生成结果。
Boolean
extrude_geometry
(可选)

指定是将输出创建为 2D 面要素类还是具有拉伸要素(可反映出每个文件中找到的高程范围)的多面体要素类。

  • NO_EXTRUSION输出将创建为 2D 面要素类。 这是默认设置。
  • EXTRUSION输出将创建为多面体要素类。
Boolean
decimal_separator
(可选)

文本文件中将用于区分数字的整数部分与其小数部分的小数分隔符。

  • DECIMAL_POINT将使用点作为小数字符。 这是默认设置。
  • DECIMAL_COMMA将使用逗号作为小数字符。
String
summarize_by_class_code
(可选)

指定结果是按类代码还是按文件汇总 .las 文件。

  • NO_SUMMARIZE每个输出要素将表示在 .las 文件中找到的所有类代码。 这是默认设置。
  • SUMMARIZE每个输出要素将表示在 .las 文件中找到的单个类代码。
Boolean
improve_las_point_spacing
(可选)

指定是否将使用 .las 文件中的点间距的加强版评估,从而减少由不规则数据分布导致的过高评估。

  • LAS_SPACING常规点间距估计值将用于 .las 文件,其中范围由点数均分。 这是默认设置。
  • NO_LAS_SPACING将使用分组,从而为 .las 文件获取更精确的点间距估计值。 这可能会增加工具运行时间。
Boolean

派生输出

名称说明数据类型
min_point_spacing

平均点间距。

Double

代码示例

PointFileInformation 示例 1(Python 窗口)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.PointFileInformation('las_files', "Test.gdb/two_las", 
                              in_file_type="LAS", file_suffix="las", 
                              input_coordinate_system="NAD 1983 UTM Zone 17N.prj", 
                              decimal_separator="DECIMAL_POINT")
PointFileInformation 示例 2(独立脚本)

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

'''****************************************************************************
Name: PointFileInformation Example
Description: This script demonstrates how to use the 
             PointFileInformation tool to create an output file that contains
             all LAS files under a parent folder.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"
lidarList = arcpy.ListFiles("*.las")
if lidarList:
    # Set Local Variables
    outputFC = "Test.gdb/output_las_info"
    prj = "Coordinate Systems/Geographic Coordinate Systems/World/WGS 1984.prj"
    extrudeGeom = True # Indicates whether to create extruded geometry shapes
    sumClass = True # Indicates whether to summarize output by class code
    decSep = "DECIMAL_POINT" # Identifies the decimal separator
    
    #Execute PointFileInformation
    arcpy.ddd.PointFileInformation(lidarList, outputFC, "LAS", "las", prj, 
                                "", extrudeGeom, decSep, sumClass)
    print("Finished executing Point File Information.")
else:
    print("There are no LAS files in {0}.".format(env.workspace))

许可信息

  • Basic: 需要 3D Analyst
  • Standard: 需要 3D Analyst
  • Advanced: 需要 3D Analyst

相关主题