Thin LAS (3D Analyst)

Summary

Creates new LAS files that contain a subset of LAS points from the input LAS dataset.

Usage

• Consider using this tool on over-sampled LAS data—such as photogrammetrically derived point clouds and returns from multiple overlapping lidar scans—to optimize display performance and speed up analysis operations. In mobile lidar surveys, extremely dense point returns can be captured due to the variation of the speed and movement pattern of the lidar sensor. Thinning can help create consistent density across the survey, which can help improve the result of certain automated classification routines that rely on regularly spaced point returns.

• Consider preserving class codes that represent sparsely captured objects, particularly if the number of points with that class code designation represent a small fraction of the total number of points. For example, if you have points representing sparsely captured features, such as powerlines, preserving them can provide a useful context about its spatial arrangement that would otherwise be lost if those points were thinned.

• Each LAS file is thinned independently from the other LAS files referenced by the LAS dataset. If the LAS files have overlapping data, use the Tile LAS tool to merge the points into nonoverlapping tiles before thinning the data.

• Each input LAS file will generate an output file with a name that matches the input unless a name suffix is specified in the Output File Name Suffix parameter.

Parameters

Dialog

Label	Explanation	Data Type
Input LAS Dataset	The LAS dataset that will be processed.	LAS Dataset Layer
Target Folder	The existing folder where the output LAS format files will be written.	Folder
Thinning Dimension	Specifies the type of thinning operation that will be conducted. 2D Thinning—Thinning will occur in tiles defined along the x,y-axis. 3D Thinning—Thinning will occur in volumes of space defined by tiles along the x,y-axis, and height gradients along the z-axis. This is the default.	String
Target XY Resolution	The size of each side of the thinning tile along the x,y-axis.	Linear Unit
Target Z Resolution (Optional)	The height of each thinning region when using the 3D thinning method.	Linear Unit
Point Selection Method	Specifies the method that will be used to determine which points are retained in each thinning region. Closest to Center—The LAS point that is closest to the center of the region being thinned will be retained. This is the default. Class Code Weights—The LAS points with the class code that has the highest weight assigned will be retained. Most Frequent Class Code—The LAS points with the most frequent class code value in the region being thinned will be retained. Lowest Point—The lowest LAS point in the region being thinned will be retained. Highest Point—The highest LAS point in the region being thinned will be retained. Lowest and Highest Point—The highest and lowest LAS points in the region being thinned will be retained. Closest to Average Height—The LAS point whose height is closest to the average of height of all points in the region being thinned will be retained. Lowest Intensity—The LAS point whose intensity value is the lowest among the points in the region being thinned will be retained. Highest Intensity—The LAS point whose intensity value is the highest among the points in the region being thinned will be retained. Lowest and Highest Intensity—The two LAS points with the lowest and the highest intensity values among the points in the region being thinned will be retained. Closest to Average Intensity—The LAS point whose intensity value is closest to the average of all intensity values from points in the region being thinned will be retained.	String
Input Class Codes and Weights (Optional)	The weights assigned to each class code that determine which points will be retained in each thinning region. This parameter is only enabled when the Class Code Weights option is specified for the Point Selection Method parameter. The class code with the highest weight will be retained in the thinning region. If two class codes with the same weight exist in a given thinning region, the class code with the smallest point source ID will be retained.	Value Table
Output File Name Suffix (Optional)	The name that will be added to each output file.	String
Output LAS Dataset (Optional)	The output LAS dataset referencing the newly created .las files.	LAS Dataset
Preserved Classes (Optional)	The input LAS points with the specified class code values will not be thinned from the output LAS files.	Long
Preserved Flags (Optional)	Specifies the input LAS points that will be preserved in the output LAS files based on class flag. Model Key—Points with the model key class flag will be preserved. Overlap—Points with the overlap class flag will be preserved. Synthetic—Points with the synthetic class flag will be preserved. Withheld—Points with the withheld class flag will be preserved.	String
Preserved Returns (Optional)	Specifies the input LAS points that will be preserved in the output LAS files based on returns. Single returns—All single return points will be included. Last returns—All single and last return points will be included. First of many returns—All points that are the first of multiple returns will be included. Last of many returns—All points that are the last of multiple returns will be included.	String
Excluded Classes (Optional)	The input LAS points with the specified class code values will be excluded from the output LAS files.	Long
Excluded Flags (Optional)	Specifies the input LAS points that will be excluded from the output LAS files based on class flag. Model Key—Points with the model key class flag will be excluded. Overlap—Points with the overlap class flag will be excluded. Synthetic—Points with the synthetic class flag will be excluded. Withheld—Points with the withheld class flag will be excluded.	String
Excluded Returns (Optional)	Specifies the input LAS points that will be excluded from the output LAS files based on returns. Single returns—All single return points will be excluded. Last returns—All single and last returns will be excluded. First of many returns—All points that are the first of multiple returns will be excluded. Last of many returns—All points that are the last of multiple returns will be excluded.	String
Compression (Optional)	Specifies whether the output .las file will be in a compressed format or the standard LAS format. No Compression—The output will be in the standard LAS format (*.las file). This is the default. zLAS Compression—Output .las files will be compressed in the zLAS format.	String
Remove Variable Length Records (Optional)	Specifies whether variable length records stored with the input LAS points will be maintained in or removed from the output LAS data. Unchecked—Variable length records will be maintained in the output LAS data. This is the default. Checked—Variable length records will be removed from the output LAS data.	Boolean
Rearrange LAS Points (Optional)	Specifies whether the order of the LAS points in the LAS files will remain the same or will be rearranged. Unchecked—The order of the points in the LAS files will remain the same. Checked—The order of the points in the LAS files will be rearranged. This is the default.	Boolean
Compute Statistics (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. Checked—Statistics will be computed. This is the default. Unchecked—Statistics will not be computed.	Boolean

Derived Output

Label	Explanation	Data Type
Output Folder	The folder with the output LAS files.	Folder

Python

arcpy.ddd.ThinLas(in_las_dataset, target_folder, thinning_dimension, xy_resolution, {z_resolution}, point_selection_method, {class_codes_weights}, {name_suffix}, {out_las_dataset}, {preserved_class_codes}, {preserved_flags}, {preserved_returns}, {excluded_class_codes}, {excluded_flags}, {excluded_returns}, {compression}, {remove_vlr}, {rearrange_points}, {compute_stats})

Name	Explanation	Data Type
in_las_dataset	The LAS dataset that will be processed.	LAS Dataset Layer
target_folder	The existing folder where the output LAS format files will be written.	Folder
thinning_dimension	Specifies the type of thinning operation that will be conducted. 2D—Thinning will occur in tiles defined along the x,y-axis. 3D—Thinning will occur in volumes of space defined by tiles along the x,y-axis, and height gradients along the z-axis. This is the default.	String
xy_resolution	The size of each side of the thinning tile along the x,y-axis.	Linear Unit
z_resolution (Optional)	The height of each thinning region when using the 3D thinning method.	Linear Unit
point_selection_method	Specifies the method that will be used to determine which points are retained in each thinning region. CLOSEST_TO_CENTER—The LAS point that is closest to the center of the region being thinned will be retained. This is the default. CLASS_CODE—The LAS points with the class code that has the highest weight assigned will be retained. PREDOMINANT_CLASS—The LAS points with the most frequent class code value in the region being thinned will be retained. Z_MIN—The lowest LAS point in the region being thinned will be retained. Z_MAX—The highest LAS point in the region being thinned will be retained. Z_MIN_MAX—The highest and lowest LAS points in the region being thinned will be retained. Z_AVERAGE—The LAS point whose height is closest to the average of height of all points in the region being thinned will be retained. INTENSITY_MIN—The LAS point whose intensity value is the lowest among the points in the region being thinned will be retained. INTENSITY_MAX—The LAS point whose intensity value is the highest among the points in the region being thinned will be retained. INTENSITY_MIN_MAX—The two LAS points with the lowest and the highest intensity values among the points in the region being thinned will be retained. INTENSITY_AVERAGE—The LAS point whose intensity value is closest to the average of all intensity values from points in the region being thinned will be retained.	String
class_codes_weights [class_codes_weights,...] (Optional)	The weights assigned to each class code that determine which points will be retained in each thinning region. This parameter is only enabled when the Class Code Weights option is specified for the Point Selection Method parameter. The class code with the highest weight will be retained in the thinning region. If two class codes with the same weight exist in a given thinning region, the class code with the smallest point source ID will be retained.	Value Table
name_suffix (Optional)	The name that will be added to each output file.	String
out_las_dataset (Optional)	The output LAS dataset referencing the newly created .las files.	LAS Dataset
preserved_class_codes [preserved_class_codes,...] (Optional)	The input LAS points with the specified class code values will not be thinned from the output LAS files.	Long
preserved_flags [preserved_flags,...] (Optional)	Specifies the input LAS points that will be preserved in the output LAS files based on class flag. MODEL_KEY—Points with the model key class flag will be preserved. OVERLAP—Points with the overlap class flag will be preserved. SYNTHETIC—Points with the synthetic class flag will be preserved. WITHHELD—Points with the withheld class flag will be preserved.	String
preserved_returns [preserved_returns,...] (Optional)	Specifies the input LAS points that will be preserved in the output LAS files based on returns. SINGLE—All single return points will be included. LAST—All single and last return points will be included. FIRST_OF_MANY—All points that are the first of multiple returns will be included. LAST_OF_MANY—All points that are the last of multiple returns will be included.	String
excluded_class_codes [excluded_class_codes,...] (Optional)	The input LAS points with the specified class code values will be excluded from the output LAS files.	Long
excluded_flags [excluded_flags,...] (Optional)	Specifies the input LAS points that will be excluded from the output LAS files based on class flag. MODEL_KEY—Points with the model key class flag will be excluded. OVERLAP—Points with the overlap class flag will be excluded. SYNTHETIC—Points with the synthetic class flag will be excluded. WITHHELD—Points with the withheld class flag will be excluded.	String
excluded_returns [excluded_returns,...] (Optional)	Specifies the input LAS points that will be excluded from the output LAS files based on returns. SINGLE—All single return points will be excluded. LAST—All single and last returns will be excluded. FIRST_OF_MANY—All points that are the first of multiple returns will be excluded. LAST_OF_MANY—All points that are the last of multiple returns will be excluded.	String
compression (Optional)	Specifies whether the output .las file will be in a compressed format or the standard LAS format. NO_COMPRESSION—The output will be in the standard LAS format (*.las file). This is the default. ZLAS—Output .las files will be compressed in the zLAS format.	String
remove_vlr (Optional)	Specifies whether variable length records stored with the input LAS points will be maintained in or removed from the output LAS data. MAINTAIN_VLR—Variable length records will be maintained in the output LAS data. This is the default. REMOVE_VLR—Variable length records will be removed from the output LAS data.	Boolean
rearrange_points (Optional)	Specifies whether the order of the LAS points in the LAS files will remain the same or will be rearranged. MAINTAIN_POINTS—The order of the points in the LAS files will remain the same. REARRANGE_POINTS—The order of the points in the LAS files will be rearranged. This is the default.	Boolean
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. COMPUTE_STATS—Statistics will be computed. This is the default. NO_COMPUTE_STATS—Statistics will not be computed.	Boolean

Derived Output

Name	Explanation	Data Type
output_folder	The folder with the output LAS files.	Folder

Code sample

ThinLas example (Python window)

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.ThinLas('photogrammetric_cloud.lasd', 'thinned', '3D', 
                  '20 Centimeters', '15 Centimeters', 'Z_AVERAGE', 
                  excluded_flags='WITHHELD', rearrange_points='REARRANGE_POINTS')

Environments

Current Workspace, Extent

Licensing information

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