LAS To Multipoint (3D Analyst Tools)

Summary

Creates multipoint features using one or more lidar files.

Illustration

LAS To Multipoint tool illustration

Usage

This tool supports ZLAS and LAS file versions 1.0 to 1.4.
The class code labels provided in the LAS dataset's layer and catalog properties reflect the class designations outlined in the ASPRS LAS 1.4 specifications. This classification scheme is oriented for aerial lidar surveys and is comprised of the following:
- Classes associated with predefined objects, for example, 2 represents ground
- Classes whose values are not defined but reserved for later use by the ASPRS
- Classes that can be allocated to any other object
The LAS dataset layer's point filters, interactive editing options, and default symbology labels reflect the LAS format specification's class code labels.

Learn more about lidar point classification.
The LAS format supports the storage of numerous predefined attributes for each lidar point. If you do not know which attributes are available with a given collection of LAS files, consider using a LAS dataset to review the LAS file properties.
When loading multiple LAS attributes into an Oracle database, you'll need to make sure all DBTUNE keywords for parameter attribute_binary are set to use binary large objects (BLOBs), not LONGRAW. This is because LAS attributes are loaded as BLOBs, and Oracle does not support multiple BLOBs in LONGRAW tables. See your Oracle database administrator for assistance.

Label	Explanation	Data type
Input	The LAS or ZLAS files that will be imported to a multipoint feature class. If a folder is specified, all the LAS files that reside therein will be imported. In the Geoprocessing pane, a folder can also be specified as an input by selecting the folder in File Explorer and dragging it onto the parameter's input box.	Folder; File
Output Feature Class	The feature class that will be produced.	Feature Class
Average Point Spacing	The average 2D distance between points in the input file or files. This can be an approximation. If areas have been sampled at different densities, specify the smaller spacing. The value needs to be provided in the projection units of the output coordinate system.	Double
Class Codes (Optional)	The classification codes that will be used as a query filter for LAS data points. Valid values range from 0 to 255. No filter is applied by default.	Long
Return Values (Optional)	The return values that will be used to filter the LAS points that get imported to multipoint features. All Returns—Any returns 1st Return—1 2nd Return—2 3rd Return—3 4th Return—4 5th Return—5 6th Return—6 7th Return—7 8th Return—8 Last Return—Last returns	String
Input Attribute Names (Optional)	The LAS point properties whose values will be stored in binary large object (BLOB) fields in the attribute table of the output. If the resulting features will participate in a terrain dataset, the stored attributes can be used to symbolize the terrain. The Name column indicates the name of the field that will be used to store the specified attributes. The following LAS properties are supported: Value table columns: Keyword—The LAS point properties whose values will be stored in binary large object (BLOB) fields in the attribute table of the output. Intensity—The intensity property will be stored. Return number—The return number property will be stored. Number of returns per pulse—The number of returns per pulse property will be stored. Scan direction flag—The scan direction flag property will be stored. Edge of flightline—The edge of flightline property will be stored. Classification—The classification property will be stored. Scan angle rank—The scan angle rank property will be stored. File marker—The file marker property will be stored. User data value—The user data value property will be stored. GPS time—The GPS time property will be stored. Red band—The red band property will be stored. Green band—The green band property will be stored. Blue band—The blue band property will be stored. Name—The name of the field that will be used to store the specified attributes.	Value Table
Coordinate System (Optional)	The coordinate system of the input LAS file.	Coordinate System
File Suffix (Optional)	The suffix of the files that will be imported from an input folder. This parameter is required when a folder is specified as input.	String
Z Factor (Optional)	The factor by which z-values will be multiplied. This is typically used to convert z linear units to match x,y linear units. The default is 1, which leaves elevation values unchanged. This parameter is not available if the spatial reference of the input surface has a z-datum with a specified linear unit.	Double
Include Subfolders (Optional)	Scans through 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 encountered in the directory structure. Checked—All LAS files residing in the subdirectories of an input folder will be converted to multipoint features. Unchecked—Only LAS files found in an input folder will be converted to multipoint features. This is the default.	Boolean

arcpy.3d.LASToMultipoint(input, out_feature_class, average_point_spacing, {class_code}, {return}, {attribute}, {input_coordinate_system}, {file_suffix}, {z_factor}, {folder_recursion})

Name	Explanation	Data type
input [input,...]	The LAS or ZLAS files that will be imported to a multipoint feature class. If a folder is specified, all the LAS files that reside therein will be imported. In the Geoprocessing pane, a folder can also be specified as an input by selecting the folder in File Explorer and dragging it onto the parameter's input box.	Folder; File
out_feature_class	The feature class that will be produced.	Feature Class
average_point_spacing	The average 2D distance between points in the input file or files. This can be an approximation. If areas have been sampled at different densities, specify the smaller spacing. The value needs to be provided in the projection units of the output coordinate system.	Double
class_code [class_code,...] (Optional)	The classification codes that will be used as a query filter for LAS data points. Valid values range from 0 to 255. No filter is applied by default.	Long
return [return,...] (Optional)	The return values that will be used to filter the LAS points that get imported to multipoint features. `ANY_RETURNS`—Any returns `1`—1 `2`—2 `3`—3 `4`—4 `5`—5 `6`—6 `7`—7 `8`—8 `LAST_RETURNS`—Last returns	String
attribute [[keyword, name],...] (Optional)	The LAS point properties whose values will be stored in binary large object (BLOB) fields in the attribute table of the output. If the resulting features will participate in a terrain dataset, the stored attributes can be used to symbolize the terrain. The Name column indicates the name of the field that will be used to store the specified attributes. The following LAS properties are supported: Value table columns: `Keyword`—The LAS point properties whose values will be stored in binary large object (BLOB) fields in the attribute table of the output. `INTENSITY`—The intensity property will be stored. `RETURN_NUMBER`—The return number property will be stored. `NUMBER_OF_RETURNS`—The number of returns per pulse property will be stored. `SCAN_DIRECTION_FLAG`—The scan direction flag property will be stored. `EDGE_OF_FLIGHTLINE`—The edge of flightline property will be stored. `CLASSIFICATION`—The classification property will be stored. `SCAN_ANGLE_RANK`—The scan angle rank property will be stored. `FILE_MARKER`—The file marker property will be stored. `USER_BIT_FIELD`—The user data value property will be stored. `GPS_TIME`—The GPS time property will be stored. `COLOR_RED`—The red band property will be stored. `COLOR_GREEN`—The green band property will be stored. `COLOR_BLUE`—The blue band property will be stored. `Name`—The name of the field that will be used to store the specified attributes.	Value Table
input_coordinate_system (Optional)	The coordinate system of the input LAS file.	Coordinate System
file_suffix (Optional)	The suffix of the files that will be imported from an input folder. This parameter is required when a folder is specified as input.	String
z_factor (Optional)	The factor by which z-values will be multiplied. This is typically used to convert z linear units to match x,y linear units. The default is 1, which leaves elevation values unchanged. This parameter is not available if the spatial reference of the input surface has a z-datum with a specified linear unit.	Double
folder_recursion (Optional)	Scans through 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 encountered in the directory structure. `RECURSION`—All LAS files residing in the subdirectories of an input folder will be converted to multipoint features. `NO_RECURSION`—Only LAS files found in an input folder will be converted to multipoint features. This is the default.	Boolean

Code sample

LASToMultipoint example 1 (Python window)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.LASToMultipoint("001.las", "Test.gdb/feature_dataset/sample_1", 1.5,
                        "2", "ANY_RETURNS", "INTENSITY", "Coordinate Systems"\
                        "/Projected Coordinate Systems/UTM/NAD 1983/NAD 1983 "\
                        "UTM Zone 17N.prj", "las", 1)

LASToMultipoint example 2 (stand-alone script)

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

'''****************************************************************************
Name: Define Data Boundary of LAS File
Description: This script demonstrates how to delineate data boundaries of
             LAS files with irregularly clustered points. It is intended for
             use as a script tool with one input LAS file.
****************************************************************************'''
# Import system modules
import arcpy

# Set local variables
inLas = arcpy.GetParameterAsText(0)  # input LAS file
ptSpacing = arcpy.GetParameterAsText(1)  # LAS point spacing
classCode = arcpy.GetParameterAsText(2)  # List of integers
returnValue = arcpy.GetParameterAsText(3)  # List of strings
outTin = arcpy.GetParameterAsText(4)  # TIN created to delineate data area
outBoundary = arcpy.GetParameterAsText(5)  # Polygon boundary file

try:
    # Run LASToMultipoint
    lasMP = arcpy.CreateUniqueName('lasMultipoint', 'in_memory')
    arcpy.ddd.LASToMultipoint(inLas, LasMP, ptSpacing, class_code,
                             "ANY_RETURNS", "", sr, inFormat, zfactor)
    # Run CreateTin
    arcpy.ddd.CreateTin(outTin, sr, "{0} Shape.Z masspoints"\
                       .format(lasMP), "Delaunay")
    # Run CopyTin
    arcpy.ddd.CopyTin(outTin, "{0}_copy".format(outTin))
    # Run DelineateTinDataArea
    maxEdge = ptSpacing * 4
    arcpy.ddd.DelineateTinDataArea(outTin, maxEdge, "PERIMETER_ONLY")
    # Run TinDomain
    arcpy.ddd.TinDomain(outTin, outBoundary, "POLYGON")

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

Environments

Current Workspace, Output Coordinate System, Geographic Transformations, Extent, XY Resolution, XY Tolerance, Z Resolution, Z Tolerance, Output CONFIG Keyword, Auto Commit, Output XY Domain, Output Z Domain

Licensing information

Basic: Requires 3D Analyst
Standard: Requires 3D Analyst
Advanced: Requires 3D Analyst