Batch Processing

Summary

LiDAR360 users can run multi-threaded batch processing routines for multiple functions on one or more .las or .LiData point cloud datasets. Structured Tool and Command Line function calling modes are supported by the Batch Processing Toolset. The Structured Tool approach allows the user to save a workflow’s order of operations and parameter settings for future use.

Structured Tool

  1. Click the Batch Processing button to display the interface below. Point cloud datasets waiting in the processing queue will be shown in the list on the top. Supported Batch Processing functions are shown on the bottom left. A sequence of functions to be executed will be shown on the bottom right after editing.

    Batch Processing
  2. Edit point cloud files using the buttons on the right side of the file list: Click the Batch Processing button to add point clouds; Click the Batch Processing button to clear the file list; Click the Batch Processing button to remove selected point clouds (.las or .LiData type). Users can select an individual point cloud file by left clicking (hold Ctrl to select multiple files).

  3. Double click a function in the left list (or select this function and click the Batch Processing button) to add it into the execution sequence. Users must ensure that all necessary parameters are set in the pop-up window if this function is not parameter-free.

    Batch Processing
  4. (Optional) Double click a function in the execution sequence (or select this function and click the Batch Processing button) to modify the parameters, if any parameter needs to be set.

  5. (Optional) Select a function in the execution sequence, then click the Batch Processing or Batch Processing button to adjust the order of execution.

  6. (Optional) Click the Batch Processing button to clear the execution sequence.

  7. (Optional) Click the Batch Processing button to save the execution sequence and corresponding parameters to file(*.LiProcessList).

  8. (Optional) Click the Batch Processing 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 (scale 1-32, default 4). If the number of threads is set to 1, a single thread processing will be performed.

  10. Click the Execute button after setting the output path. The functions in the sequence will be executed for all point clouds in the file list. Intermediate and final results are saved under the specified 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 freely.

Some functions need extra data as input. For example, the Normalization function is based on DEM. Users should either specify an existing DEM file as input, or check the option "Use Created File", which suggests that a DEM function must be executed prior to Normalization. An improper sequence leads to failure in executing these types of functions.

Batch Processing

Command Line

  1. Open cmd.exe the command line window. Then drag LiBatch.exe from the LiDAR360 installation directory directly into the command line window or input the correct path to LiBatch.exe. Then press "Enter". Software information, common command line commands and a list of command-line callable batch functions (in English and Chinese) will appear.

    Batch Processing
  2. The command line allows calling from 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. The result will be saved to the output path. Json files can be generated using the interface batch processing or modified manually. 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 appendix ID List of Json Callable Functions for Batch Processing.

    -jsonFile BatchProcessList.LiProcessList

    Batch Processing
  3. According to the information prompt, users can enter -i plus the specific data file (full path) as input data. 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: .LiData). Users must ensure there is no space in the input file path, otherwise a parsing error will be raised. 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 -? before the function name to check the arguments of the 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 outlier 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 outlier removal to the input file, using default parameters, and save the output in the same folder as the input.

    Outlier_Rmovel -i ..\data*.LiData

    Batch Processing
  6. Taking classifying ground points as an example for the Classification module, users type in the command for classifying ground points -h, then relevant command line help will appear in the window. For classification, the command -fc stands for the class origin, followed by corresponding class number(s) according to the class list (default: all classes). The command -tc indicates the aimed class, followed by a class number as well.

    Classify Ground Points -h

    Batch Processing
  7. For instance, the command below means: Run the function to classify ground points, in 8 threads, input file path D:\15.LiData, output file folder D:\data4test\ (for classification there will not be an output file generated, however, the input point cloud data will be classified), class origins 1 (unclassified), 2 (ground point), 3 (low vegetation), aimed class ground points, iteration angle 25 degrees, iteration distance 1.2 meters, other unspecified parameters as default.

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

results matching ""

    No results matching ""