Batch Processing

Functional Description

In view of point cloud data to realize multi-data, multi-function, multi-thread streamlining batch processing operations, support the las and LiData type data, and provides two types of calling methods, these are dialog box and command line call batch processing function, the dialog calling batch processing function provides the operating sequence and parameters are saved in the function,in order to facilitate the use of other data. The following steps are described the calling method:

Structured Tool

1. After clickingthe following interface pops up. The file list lists all the point cloud data in the system. The functions that support point cloud batch processing operations are listed in the left list of functions, and the list on the right shows the function sequence of the batch processing operations.

   

2. Click the on the right side of file list to select point clouds to be batch processing; Click the button to clear the file list; Click the button to remove selected point clouds (.las or .LiData type).

3. Double click the function in the left list (or select this function and click the button) and the function Parameters Settings interface will pop up. After Parameters Settings are completed, it will be displayed in the right list.
4. (Optional) Double click the function in the right list (or select this function and click the button) to modify the parameters.
5. (Optional) Select a function in the execution sequence, then click the or button to adjust the order of execution.
6. (Optional) Click the button to clear the execution sequence.
7. (Optional) Click the button to save the execution sequence and corresponding parameters to file (.LiProcessList).
8. (Optional) Click the button to load execution sequence and corresponding parameters from file(.LiProcessList).
9. Set the number of threads for multi-thread batch processing in the thread number box (default 4). If the number of threads is set to 1, a single thread processing will be performed.

10. Set output path and click execute button, and the batch processing operations are processed in the order of the function list, and all intermediate results from this process are saved to the output path.

    Note: This tool is only applicable to point cloud data (.las or .LiData type). Some functions without parameters(e.g., PCV, Normalization by Ground Class) can be added directly and; A function that requires input raster data as an input parameter, and ensure the sequence of function operation (generating raster data first). If DEM is required for normalization function, DEM function should be put before normalized function.

11. You can enter a function name in the searching for quick search. Please note the software language version.

Invoke batch processing by CMD

1. Open the cmd.exe command line window, drag LiBatch.exe from the installation directory of LiDAR360 software into the command line window, or enter the installation directory layer by layer to invoke LiBatch.exe, and click Enter, software information, common command line commands and a list of command-line callable batch functions (in English and Chinese) will appear.

2. The command line supports the invocation of json files, the data and functions recorded in a json file can be executed in order by inputting -jsonFile plus the file name of json, and the final result is saved in the output folder json files can be generated using the interface batch processing or modified manually. But users must keep in strict accordance with the format of relevant parameters to avoid any parsing errors. For the list of Plugin ID and Action ID used to perform specific functions in the json file, refer to the appendixID List of Json Callable Functions for Batch Processing.

   >> -jsonFile BatchProcessList.LiProcessList

3. In addition, according to the information prompt, you can enter the specific data file after -i as the input data (full path required). When inputting multiple files, users can enter -i plus multiple files separated by spaces, or -ifolder plus data type for filtering (.las or .LiData), default is LiData. It is worth noticing that users must ensure there is no space in the input file path, otherwise a parsing error will be raised. In fact, all parameter commands and specific parameters must be separated by spaces.

   >> Outlier_Rmovel -ifolder ..\data\ las

4. Users can use -o command to set a folder path, instead of a specific file path. If users do not set this parameter, the output file will be saved in the same directory as the input file by default. Users can use -threadNum command to set the number of threads. Before calling a function, users can enter -h, -H, -help or -or any command to view the parameter instructions of the specific function. Command format: command name (case sensitive) -----parameter introduction. To run a function without setting any parameters, users can use the command -default/-DEFAULT, or leave it blank.

   Outlier_Rmovel -h

5. Only one function can be called at each time. Taking outliers removal as an example, the valid input will be Outlier_Removal. The exact function name must appear in the parameter list. Input -i plus file name and hit "enter" button to run outliers removal to the input file, using default parameters, and save the output in the same folder as the input.

   >> Outlier_Rmovel -i ..\data\*.LiData

6. In the classification module, see classify ground points as an example: Input classify ground points - h, window appears classify ground points function related command line help. For classification function, - fc is starting category, according to category list behind input corresponding to the category of digital by commas, if you do not input this order, it is starting category for all classes,- tc refers to target classification, we can input the corresponding category number.

   >> Classify_ Ground_ Points -h

7. The meaning of the following command line is: Run the ground point classification function with 8 threads. The input data is ..\input*.LiData, and the output files are saved in ..\output\ (for classification functions, no new output files are generated, i.e., the class attributes are modified in the source data). The initial categories 1, 2, and 3 correspond to unclassified, ground points, and low vegetation points, respectively. The target category is ground points, with an iteration angle of 25 degrees and an iteration distance of 1.2 meters. Other parameters that are not set will use their default values.

   >> Classify_ Ground_ Points -threadNum 8 -i ..\input\*.LiData -o ..\output\ -fc 1,2,3 -tc 2 -ia 25 -id 1.2

Batch Processing - Volume Measurement

Description

This function calculates the fill and excavation volumes for one or more point clouds within specified boundaries and outputs the results. Currently, only the TIN method is supported, which involves constructing a TIN from the point cloud and then calculating the fill and excavation volumes between the TIN and a specified plane.

Example Parameter Json File

Parameter Description:

1. "Output Path": Must be specified as a folder path, not a file name. The correct format is "E:/Test". Results will be output as CSV files in this folder, with each LiData producing one CSV file. Each line in the CSV file represents the result for one polygonal area.
2. "FileList": Specifies one or more point clouds, separated by commas in JSON format. Example: "0":"1.LiData","1":"2.LiData".
3. "planeMethod": Method for defining the reference plane. Can be set to "0" or "1". "0" means the user specifies the reference plane, which can be any plane not perpendicular to the Z direction, generally a horizontal plane. "1" means the reference plane is automatically calculated based on the input polygon. When set to "0", parameters "planeDir" and "pointOnPlane" must be specified, defining the plane's direction and a point on the plane.
4. "planeDir": Plane direction in the plane-point form equation. Default is the Z-axis direction, i.e., "0","0","1". (The numbers before the colon "0","1","2" are indexes and cannot be changed.) The plane direction cannot be perpendicular to the Z-axis, otherwise, the calculation cannot be performed.
5. "pointOnPlane": A point on the plane in the plane-point form equation. Together with "planeDir", this parameter defines the plane.
6. "polygonObjectName": Specifies a vector file. In the resulting CSV file, each polygon in the vector file will generate a line of information. The results are shown in the figure below:
7. "attributeName": Optional, default is empty. If not empty and the shapefile contains this attribute field, a column will be added to the CSV file with the attribute values from the shapefile object.