点文件信息 (3D Analyst)

摘要

在面或多面体输出中生成有关一个或多个点文件的统计信息。

插图

使用情况

• 如果选择包含点数据文件的文件夹作为输入，必须输入文件后缀。但对于文件输入，不需要此后缀。

• 如果没有使用汇总选项，要素属性表中显示的统计信息包括每个输入的点文件的点数、平均点间距、最小 z 值和最大 z 值。每个输入文件都单独生成一行信息。点间距值是通过假设每个输入文件中的点都平均分布在该输入文件的 XY 范围内估算出来的。

• 每个生成的要素都将包含输入文件的 XY 范围。可将要素创建为 2D 面或提供 3D 边界框（其底部和顶部的 z 值反映了文件中的高程值范围）的拉伸多面体要素。可使用 ArcScene 或 ArcGlobe 以 3D 形式显示多面体。

• 汇总选项在统计汇总输入文件中每个类代码的信息时十分有用，但由于必须扫描和分析每个文件，代价较高。

• 点文件信息报告的点间距并不精确，它是一个估计值。所给出的点间距是考察多组文件趋势时的汇总结果。该工具使用粗略的估计值，将点数与文件边界框的面积做了比较。如果所检查文件的矩形范围内布满了数据，则精确度最高。对于点主要分布在大型水体上或者研究区域周围的文件，由于只是部分填充了数据，因此，不能生成精确的估计值。

参数

对话框

标注	说明	数据类型
点数据	存储将要分析的点记录的文件夹和文件的任意组合。 在“工具”对话框中，可将文件夹指定为输入，具体方法如下：在 Windows 资源管理器中选择文件夹，然后将其拖动到参数的输入框上。	File; Folder
输出要素类	将生成的要素类。	Feature Class
文件格式	指定输入文件的格式。 LAS 格式的激光雷达数据—美国摄影测量及遥感协会 (ASPRS) 定义的激光雷达数据存储格式。 含 XYZ 的 ASCII 文件—XYZ 文件。 含 XYZI 的 ASCII 文件—XYZI 文件。 Generate 格式的 ASCII 文件—GENERATE 文件。	String
文件后缀 (可选)	在输入中指定文件夹时导入的文件的后缀。如果提供输入文件夹，则此参数为必填项。	String
坐标系 (可选)	输入数据的坐标系。	Coordinate System
包括子文件夹 (可选)	指定是否子文件夹中的数据将用于生成结果。当所选输入文件夹中的子文件夹目录含有数据时，工具将扫描子文件夹。为目录结构中包含的每个文件生成一行输出要素类。 未选中 - 只有在输入文件夹中找到的数据才用于生成结果。这是默认设置。 选中 - 在输入文件夹及其子目录中找到的任何数据均将用于生成结果。	Boolean
拉伸几何形状 (可选)	指定是将输出创建为 2D 面要素类还是具有拉伸要素（可反映出每个文件中找到的高程范围）的多面体要素类。 未选中 - 输出将创建为 2D 面要素类。这是默认设置。 选中 - 输出将创建为多面体要素类。	Boolean
小数分隔符 (可选)	文本文件中将用于区分数字的整数部分与其小数部分的小数分隔符。 点—将使用点作为小数字符。 这是默认设置。 逗号—将使用逗号作为小数字符。	String
按类代码汇总 (可选)	指定结果将按类代码还是 LAS 文件汇总 LAS 文件。该选项要求对 LAS 文件进行密集扫描。 未选中 - 每个输出要素都将表示在激光雷达文件中找到的所有数据。这是默认设置。 选中 - 每个输出要素将表示在激光雷达文件中找到的单个类代码。	Boolean
改进 LAS 文件点间距评估 (可选)	指定是否将使用 LAS 文件中的点间距的加强版评估，从而减少由不规则数据分布导致的过高评估。 未选中 - 对 LAS 文件使用规则点间距估计值，其中范围由点数均分。这是默认设置。 选中 - 将分块计算以获取 LAS 文件的更精确的点间距估计值。这可能增加工具的执行时间。	Boolean

派生输出

标注	说明	数据类型
平均点间距	平均点间距。	双精度

Python

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,...]	存储将要分析的点记录的文件夹和文件的任意组合。 在“工具”对话框中，可将文件夹指定为输入，具体方法如下：在 Windows 资源管理器中选择文件夹，然后将其拖动到参数的输入框上。	File; Folder
out_feature_class	将生成的要素类。	Feature Class
in_file_type	指定输入文件的格式。 LAS—美国摄影测量及遥感协会 (ASPRS) 定义的激光雷达数据存储格式。 XYZ—XYZ 文件。 XYZI—XYZI 文件。 GENERATE—GENERATE 文件。	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 文件汇总 LAS 文件。 NO_SUMMARIZE—每个输出要素将表示在激光雷达文件中找到的所有类代码。这是默认设置。 SUMMARIZE—每个输出要素将表示在激光雷达文件中找到的单个类代码。	Boolean
improve_las_point_spacing (可选)	指定是否将使用 LAS 文件中的点间距的加强版评估，从而减少由不规则数据分布导致的过高评估。 LAS_SPACING—对 LAS 文件使用规则点间距估计值，其中范围由点数均分。这是默认设置。 NO_LAS_SPACING—将分块计算以获取 LAS 文件的更精确的点间距估计值。这可能增加工具的执行时间。	Boolean

派生输出

名称	说明	数据类型
min_point_spacing	平均点间距。	双精度

代码示例

PointFileInformation 示例 1（Python 窗口）

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

arcpy.env.workspace = "C:/data"
arcpy.PointFileInformation_3d('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.PointFileInformation_3d(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))

环境

当前工作空间, 临时工作空间, 输出坐标系, 范围, XY 分辨率, XY 容差, Z 分辨率, Z 容差, 输出配置关键字, 自动提交, 输出 XY 属性域, 输出 Z 属性域

特殊情况

许可信息

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