点文件信息 (3D Analyst 工具)

汇总

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

插图

点文件信息工具图示

用法

每个输出要素都将包含输入文件的 x,y 范围。可以创建要素，作为描绘每个输入文件 z 范围的 2D 面或多面体。属性表将包含以下字段：
- FileName—与要素关联的点文件的名称。
- Pt_Count—点文件中的总点数。
- Pt_Spacing—采用指定坐标系线性单位的预估点平均间距。点间距是假设输入文件中的点在每个输入文件的 x,y 范围内均匀分布的估计值。
- Z_Min—文件中最低点的 z 值。
- Z_Max—文件中最高点的 z 值。
使用按类代码汇总参数，为输入 .las 或 .zlas 文件中的每个类代码生成一个输出要素。输出要素将包括一个名为 Class 的字段，其中包含要汇总的类代码，并且与要素关联的每个属性都将反映该类代码的属性。 .laz 文件不支持此参数。
当输入点数据参数值为一个或多个 .las 或 .zlas 文件，或者包含 .las 或 .zlas 文件的文件夹时，输出的默认空间参考取自读取的第一个文件。当输入为 LAS 数据集时，输出的默认空间参考设置为 LAS 数据集的空间参考。如果输入是 .laz 文件，请使用坐标系参数指定输出的空间参考。如果未指定空间参考，则输出将没有空间参考。

标注	说明	数据类型
输入点数据	待处理的点数据。支持的输入包括 LAS 数据集；`.las`、`.zlas` 和 `.laz` 文件；以及包含点记录的 ASCII 文件。也可以将一个或多个包含文件的文件夹指定为输入。包含文件夹时，必须在文件后缀参数中指定点文件的文件后缀。	File; Folder
输出要素类	将生成的要素类。	Feature Class
文件格式	指定输入文件的格式。 LAS format lidar—The format of the input files is LAS format lidar, which includes `.las`, `.zlas`, and `.laz` files. ASCII file with XYZ—The format of the input files is ASCII files with XYZ. ASCII file with XYZI—The format of the input files is ASCII files with XYZI. ASCII file in Generate format—The format of the input files is ASCII files in Generate format.	String
文件后缀（可选）	在输入中指定文件夹时，将导入的文件后缀。	String
坐标系（可选）	输入数据的坐标系。	Coordinate System
包括子文件夹（可选）	指定是否子文件夹中的数据将用于生成结果。当所选输入文件夹中的子文件夹目录含有数据时，工具将扫描子文件夹。为目录结构中的每个文件生成一行输出要素类。选中—Any data in the input folder and its subdirectories will be used to generate results. 未选中—Only the data in the input folder will be used to generate results. This is the default.	Boolean
拉伸几何形状（可选）	指定输出是创建为 2D 面要素类还是具有反映每个文件中高程范围的拉伸要素的多面体要素类。选中—The output will be created as a multipatch feature class. 未选中—The output will be created as a 2D polygon feature class. This is the default.	Boolean
小数分隔符（可选）	文本文件中将用于区分数字的整数部分与其小数部分的小数分隔符。 Point—A point will be used as the decimal character. This is the default. Comma—A comma will be used as the decimal character.	String
按类代码汇总（可选）	指定结果是按类代码还是按文件汇总 `.las` 或 `.zlas` 文件。此参数不适用于 `.laz` 文件。选中—Each output feature will represent a single class code in the input `.las` or `.zlas` file. This option will require a complete scan of the input files. 未选中—Each output feature will represent all the class codes in the `.las` or `.zlas` file. This is the default.	Boolean
改进 LAS 文件点间距评估（可选）	指定是否使用 `.las` 文件中点间距的增强评估，从而减少由不规则数据分布导致的过高评估。选中—A regular point spacing estimate will be used for `.las` files in which the extent is equally divided by the number of points. This is the default. 未选中—Binning will be used to obtain a more precise point spacing estimate for `.las` files. This option may increase tool run time.	Boolean

派生输出

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

arcpy.3d.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` 和 `.laz` 文件；以及包含点记录的 ASCII 文件。也可以将一个或多个包含文件的文件夹指定为输入。包含文件夹时，必须在 `file_suffix` 参数中指定文件后缀。	File; Folder
out_feature_class	将生成的要素类。	Feature Class
in_file_type	指定输入文件的格式。 `LAS`—The format of the input files is LAS format lidar, which includes `.las`, `.zlas`, and `.laz` files. `XYZ`—The format of the input files is ASCII files with XYZ. `XYZI`—The format of the input files is ASCII files with XYZI. `GENERATE`—The format of the input files is ASCII files in Generate format.	String
file_suffix （可选）	在输入中指定文件夹时，将导入的文件后缀。	String
input_coordinate_system （可选）	输入数据的坐标系。	Coordinate System
folder_recursion （可选）	指定是否子文件夹中的数据将用于生成结果。当所选输入文件夹中的子文件夹目录含有数据时，工具将扫描子文件夹。为目录结构中的每个文件生成一行输出要素类。 `RECURSION`—Any data in the input folder and its subdirectories will be used to generate results. `NO_RECURSION`—Only the data in the input folder will be used to generate results. This is the default.	Boolean
extrude_geometry （可选）	指定输出是创建为 2D 面要素类还是具有反映每个文件中高程范围的拉伸要素的多面体要素类。 `EXTRUSION`—The output will be created as a multipatch feature class. `NO_EXTRUSION`—The output will be created as a 2D polygon feature class. This is the default.	Boolean
decimal_separator （可选）	文本文件中将用于区分数字的整数部分与其小数部分的小数分隔符。 `DECIMAL_POINT`—A point will be used as the decimal character. This is the default. `DECIMAL_COMMA`—A comma will be used as the decimal character.	String
summarize_by_class_code （可选）	指定结果是按类代码还是按文件汇总 `.las` 或 `.zlas` 文件。此参数不适用于 `.laz` 文件。 `SUMMARIZE`—Each output feature will represent a single class code in the input `.las` or `.zlas` file. This option will require a complete scan of the input files. `NO_SUMMARIZE`—Each output feature will represent all the class codes in the `.las` or `.zlas` file. This is the default.	Boolean
improve_las_point_spacing （可选）	指定是否使用 `.las` 文件中点间距的增强评估，从而减少由不规则数据分布导致的过高评估。 `LAS_SPACING`—A regular point spacing estimate will be used for `.las` files in which the extent is equally divided by the number of points. This is the default. `NO_LAS_SPACING`—Binning will be used to obtain a more precise point spacing estimate for `.las` files. This option may increase tool run time.	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

    # Run PointFileInformation
    arcpy.ddd.PointFileInformation(lidarList, outputFC, "LAS", "las", prj,
                                "", extrudeGeom, decSep, sumClass)
    print("Finished running Point File Information.")
else:
    print("There are no LAS files in {0}.".format(arcpy.env.workspace))

环境

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

许可信息

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

点文件信息 (3D Analyst 工具)

汇总

插图

用法

参数

派生输出

环境

许可信息

相关主题