NIPOConverter.exe - Command Line Usage Guide

Overview

NIPOConverter.exe is a command-line tool for converting various point cloud formats (LAS, LAZ, PTX, PLY, XYZ, and Nested, Indexed, Priority Octree (NIPO) data) into LPLAS pyramid hierarchies. LPLAS files are optimized for efficient spatial indexing, visualization, and analysis of large-scale point cloud datasets.

Basic Syntax

Or using a batch list of files:

Required Arguments

Optional Arguments

Output Format & Attributes

Pyramid Structure

Sampling & Processing

Processing Modes

Input Format & Projection

Web Page Generation

Classification & Priority

Logging & Notifications

Advanced Options

Usage Examples

Example 1: Basic LAS to LPLAS Conversion

nipoconverter.exe -i "C:\data\scan.las" -o "C:\output\scan_pyramid"

Example 2: Batch Processing with File List

nipoconverter.exe --list-of-files "C:\data\filelist.txt" -o "C:\output"

scan1.las
scan2.las
scan3.las

Example 3: Convert to LAS with RGB Attributes

nipoconverter.exe -i "input.las" -o "output" --output-format LAS -a RGB

Example 4: Fine-Tune Pyramid Structure

nipoconverter.exe -i "input.las" -o "output" -l 7 -s 0.5 --vpmax 5 --e0 512

Example 5: Generate Interactive Web Viewer

nipoconverter.exe -i "input.las" -o "output" -p "MyPointCloud" --material ELEVATION --edl-enabled

Example 6: Process Multiple Files Individually

nipoconverter.exe --list-of-files "files.txt" -o "C:\output" --process-by-file

Example 7: Incremental Update (Add Points)

nipoconverter.exe -i "newdata.las" -o "existing_pyramid" --incremental

Example 8: High-Resolution Pyramid

nipoconverter.exe -i "input.las" -o "output" --spacing 0.1 --levels 8 --e0 2048

Output Structure

When conversion completes, the output directory contains:

output/
├── octree.bin              # Spatial index (if BINARY format)
├── hierarchy.bin           # Hierarchy metadata (if BINARY format)
├── sources.json            # Source file information
├── output.las / output.laz # Final LAS/LAZ file (if LAS/LAZ format)
├── log.txt                 # Processing log (if --create-log)
├── LPLASConvertlog.txt     # Email notification log (if --notifyEmail)
└── pointclouds/            # Web viewer files (if -p/--generate-page)
    ├── index.html
    ├── css/
    ├── js/
    └── ...

Common Scenarios

Scenario 1: High-Volume LiDAR Processing

nipoconverter.exe --list-of-files "lidar_files.txt" -o "C:\LiDAR_Pyramid" `
  --spacing 0.25 --levels 6 --e0 1024 --process-by-file --create-log

Scenario 2: Real-Time Monitoring with Incremental Updates

nipoconverter.exe -i "initial_scan.las" -o "monitoring_pyramid"

nipoconverter.exe -i "new_scan.las" -o "monitoring_pyramid" --incremental

Scenario 3: Web-Based Visualization

nipoconverter.exe -i "terrain.las" -o "web_output" `
  -p "TerrainViewer" --title "Mountain Survey" --material ELEVATION `
  --description "High-resolution terrain model" --edl-enabled

Scenario 4: Classified Point Cloud (e.g., Vegetation)

nipoconverter.exe -i "classified.las" -o "forest_pyramid" `
  --output-format LAS -a "RGB,CLASSIFICATION" `
  --priorityclasses "4 5" --material CLASSIFICATION

Troubleshooting

Performance Tips

• For large datasets: Increase --flushingsize (e.g., 1000000) to reduce disk I/O
• For fast visualization: Use lower levels (-l 4 or 5) to reduce processing time
• For precision: Use --spacing 0.1 or lower with higher levels for detail
• For batch processing: Use --list-of-files and --process-by-file for parallel operations
• For web delivery: Use LAZ format with --output-format LAZ to reduce file size

Exit Codes

Getting Help

Display full option list:

Version: Compatible with LP360 point cloud processing framework
Platform: Windows (x86-64)
Related Tools: LP360, LPLAS pyramid viewer