Summary
Classifies LAS points using cell values from a raster dataset.
Usage
This tool processes all LAS points that are contained in a given cell. A LAS dataset layer can be used to limit the points being processed by filtering them using classification codes, return values, and classification flags. The LAS dataset layer's filters can be defined in the Layer Properties dialog box or using the Make LAS Dataset Layer tool.
An integer raster must be used for this tool. The raster's cell value defines the class code that will be assigned to the LAS points being processed. Any cell value that is beyond the range supported by the LAS format will be ignored. Use the Reclassify tool if the raster's cell values need to be changed to have the desired class code.
For best results, don't use a raster dataset that is in a projection other than that of the LAS dataset. A raster with a coordinate system that differs from the LAS dataset will be reprojected on the fly, which can introduce alignment discrepancies that may yield unexpected results. If the raster has a different coordinate system, consider using the Project Raster tool to reproject it into the spatial reference of the LAS dataset.
The Classify LAS Ground tool may assign lidar returns over bodies of water as ground. If aerial imagery that accurately defines the shoreline is available, using image classification techniques to extract the regions of water can provide a reliable mechanism for classifying the points from the lidar survey to represent water.
Syntax
SetLasClassCodesUsingRaster(in_las_dataset, in_raster, {compute_stats}, {extent}, boundary, {process_entire_files})
Parameter | Explanation | Data Type |
in_las_dataset | The LAS dataset to process. | LAS Dataset Layer |
in_raster | The 8-bit integer raster with cell values that will be used to assign classification codes for LAS points. | Raster Layer; Mosaic Layer |
compute_stats (Optional) | Specifies whether statistics will be computed for the LAS files referenced by the LAS dataset. Computing statistics provides a spatial index for each LAS file, which improves analysis and display performance. Statistics also enhance the filtering and symbology experience by limiting the display of LAS attributes, such as classification codes and return information, to values that are present in the LAS file.
| Boolean |
extent (Optional) | Specifies the extent of the data that will be evaluated by this tool. | Extent |
boundary | A polygon feature that defines the area of interest to be processed by this tool. | Feature Layer |
process_entire_files (Optional) | Specifies how the processing extent is applied.
| Boolean |
Derived Output
Name | Explanation | Data Type |
derived_las_dataset | The reclassified LAS dataset. | LAS Dataset Layer |
Code sample
The following sample demonstrates the use of this tool in the Python window.
import arcpy
arcpy.ddd.SetLasClassCodesUsingRaster("Jacmel.las", "reclass.tif", "COMPUTE_STATS")
Environments
Licensing information
- Basic: Requires 3D Analyst
- Standard: Requires 3D Analyst
- Advanced: Requires 3D Analyst