License Information

Use of this function requires a license for Whitebox Workflows for Python Professional (WbW-Pro). Please visit www.whiteboxgeo.com to purchase a license.

Description

This performs a quality control check on the return values of points in a LiDAR file. In particular, the tool will search for missing point returns, duplicate point returns, and points for which the return number (r) is larger than the encoded number of returns (n), all of which may be indicative of processing or encoding errors in the input file.

The user must specify the name of the input LiDAR file (input), and may optionally specify an output LiDAR file (output). If no output file is specified, only the text report is generated by the tool. If an output is specified, the tool will create an output LiDAR file for which missing returns are assigned class 13, duplicate returns are assigned class 14, points that are both, part of a missing series and are duplicate returns, are classed 15, and all other non-problemmatic points are assigned class 1. Note, those points designated as missing in the output image are clearly not so much missing as they are part of a sequence of points that contain missing returns. Missing points are apparent when the first point in a series does not have r = 1, when the last point does not have r = n, or the series is non-sequential (e.g. 1/3, 3/3, but no 2/3). This condition may occur because returns are split between tiles. However, when sequences with missing points are not located near the edges of tiles, it is usually an indication that either point filtering has taken place during pre-processing or that there is been some kind of processing or encoding error.

Duplicate points are defined as points that share the same time, scanner channel, r, and n. Note that these points may have different x, y, z coordinates. Duplicate points are always an indication of a processing or encoding error. For example, it may indicate that the scanner channel information from a multi-channel LiDAR sensor has not been encoded when creating the file or has been lost.

No point should have r > n. This always indicates some kind of processing or encoding error when it occurs.

The following is a sample output report generated by this tool:

********* * Welcome to LidarPointReturnAnalysis *


The Global Encoding for this file indicates that the point returns are not synthetic.

Missing Returns: 2441636 (16.336 percent) points are missing

rnMissing Pts
121127770
22817
13823240
23569
33718
14285695
24142890
34142
44213
1529772
2519848
359928
4518
5516

Duplicate Returns: 4311021 (28.844 percent) points are duplicates

rnDuplicates
112707083
12332028
22663717
1370619
23211834
33282348
142856
248568
3414280
4417136
1523
2569
35115
45161
55184

Return Greater Than Num. Returns: 0 (0.000 percent) points have r > n

Writing output LAS file... Complete! Elapsed Time (including I/O): 1.959s

Project Links

WbW Homepage User Manual Support WbW