Point File Information (3D Analyst)

Summary

Creates polygon or multipatch output that captures the spatial extent and statistical information about one or more ASCII or LAS format point files.

Illustration

Point File Information tool illustration

Usage

  • Each output feature will encompass the x,y extent of an input file. The features can be created as 2D polygons or multipatches depicting the z-range of each input file. The attribute table will have the following fields:

    • FileName—The name of the point file associated with the feature.
    • Pt_Count—The total number of points in the point file.
    • Pt_Spacing—The estimated average spacing of the points in the linear units of the specified coordinate system. The point spacing is an estimate that assumes the points in the input file are evenly spaced over the x,y extent of each input file.
    • Z_Min—The z-value of the lowest point in the file.
    • Z_Max—The z-value of the highest point in the file.
  • Use the Summarize by class code parameter to produce an output feature for each class code in an input .las or .zlas file. The output features will include a field named Class that contains the class code being summarized, and each attribute associated with the feature will reflect the properties for that class code. This option is not supported for .laz files.

Parameters

LabelExplanationData Type
Point Data

The point data that will be processed. Supported inputs include LAS datasets, .las, .zlas, and .laz files, and ASCII files containing point records. One or more folders containing the files can also be specified as input. When a folder is included, the file suffix of the point files must be specified in the File Suffix parameter.

File; Folder
Output Feature Class

The feature class that will be produced.

Feature Class
File Format

Specifies the format of the input files.

  • LAS format lidarThe format of the input files is LAS format lidar, which includes .las, .zlas, and .laz files.
  • ASCII file with XYZThe format of the input files is ASCII files with XYZ.
  • ASCII file with XYZIThe format of the input files is ASCII files with XYZI.
  • ASCII file in Generate formatThe format of the input files is ASCII files in Generate format.
String
File Suffix
(Optional)

The suffix of the files that will be imported when a folder is specified in the input.

String
Coordinate System
(Optional)

The coordinate system of the input data.

Coordinate System
Include Subfolders
(Optional)

Specifies whether data in subfolders will be used to generate results. The tool scans subfolders when an input folder is selected containing data in a subfolders directory. The output feature class will be generated with a row for each file in the directory structure.

  • Unchecked—Only the data in the input folder will be used to generate results. This is the default.
  • Checked—Any data in the input folder and its subdirectories will be used to generate results.
Boolean
Extrude Geometry Shapes
(Optional)

Specifies whether the output will be created as a 2D polygon or multipatch feature class with extruded features that reflect the elevation range in each file.

  • Unchecked—The output will be created as a 2D polygon feature class. This is the default.
  • Checked—The output will be created as a multipatch feature class.
Boolean
Decimal Separator
(Optional)

The decimal character that will be used in the text file to differentiate the integer of a number from its fractional part.

  • DECIMAL_POINTA point will be used as the decimal character. This is the default.
  • DECIMAL_COMMAA comma will be used as the decimal character.
String
Summarize by class code
(Optional)

Specifies whether the output will summarize .las or .zlas files by class codes or by file. This parameter is not supported for .laz files.

  • Unchecked—Each output feature will represent all the data in the .las or .zlas file. This is the default.
  • Checked—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.
Boolean
Improve LAS files point spacing estimate
(Optional)

Specifies whether enhanced assessment of the point spacing in .las files, which can reduce over-estimation caused by irregular data distribution, will be used.

  • Unchecked—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.
  • Checked—Binning will be used to obtain a more precise point spacing estimate for .las files. This option may increase tool run time.
Boolean

Derived Output

LabelExplanationData Type
Average Point Spacing

The average point spacing.

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})
NameExplanationData Type
input
[input,...]

The point data that will be processed. Supported inputs include LAS datasets, .las, .zlas, and .laz files, and ASCII files containing point records. One or more folders containing the files can also be specified as input. When a folder is included, the file suffix must be specified in the file_suffix parameter.

File; Folder
out_feature_class

The feature class that will be produced.

Feature Class
in_file_type

Specifies the format of the input files.

  • LASThe format of the input files is LAS format lidar, which includes .las, .zlas, and .laz files.
  • XYZThe format of the input files is ASCII files with XYZ.
  • XYZIThe format of the input files is ASCII files with XYZI.
  • GENERATEThe format of the input files is ASCII files in Generate format.
String
file_suffix
(Optional)

The suffix of the files that will be imported when a folder is specified in the input.

String
input_coordinate_system
(Optional)

The coordinate system of the input data.

Coordinate System
folder_recursion
(Optional)

Specifies whether data in subfolders will be used to generate results. The tool scans subfolders when an input folder is selected containing data in a subfolders directory. The output feature class will be generated with a row for each file in the directory structure.

  • NO_RECURSIONOnly the data in the input folder will be used to generate results. This is the default.
  • RECURSIONAny data in the input folder and its subdirectories will be used to generate results.
Boolean
extrude_geometry
(Optional)

Specifies whether the output will be created as a 2D polygon or multipatch feature class with extruded features that reflect the elevation range in each file.

  • NO_EXTRUSIONThe output will be created as a 2D polygon feature class. This is the default.
  • EXTRUSIONThe output will be created as a multipatch feature class.
Boolean
decimal_separator
(Optional)

The decimal character that will be used in the text file to differentiate the integer of a number from its fractional part.

  • DECIMAL_POINTA point will be used as the decimal character. This is the default.
  • DECIMAL_COMMAA comma will be used as the decimal character.
String
summarize_by_class_code
(Optional)

Specifies whether the results will summarize .las or .zlas files by class code or by file. This option is not available for .laz files.

  • NO_SUMMARIZEEach output feature will represent all the class codes in the .las or .las file. This is the default.
  • SUMMARIZEEach 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.
Boolean
improve_las_point_spacing
(Optional)

Specifies whether enhanced assessment of the point spacing in .las files, which can reduce over-estimation caused by irregular data distribution, will be used.

  • LAS_SPACINGA 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_SPACINGBinning will be used to obtain a more precise point spacing estimate for .las files. This option may increase tool run time.
Boolean

Derived Output

NameExplanationData Type
min_point_spacing

The average point spacing.

Double

Code sample

PointFileInformation example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window.

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 example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script.

'''****************************************************************************
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))

Related topics