https://github.com/kitware/lidarview
LidarView performs real-time reception, recording, visualization and processing of 3D LiDAR data. This repository is a mirror of https://gitlab.kitware.com/LidarView/lidarview.
https://github.com/kitware/lidarview
Last synced: 4 months ago
JSON representation
LidarView performs real-time reception, recording, visualization and processing of 3D LiDAR data. This repository is a mirror of https://gitlab.kitware.com/LidarView/lidarview.
- Host: GitHub
- URL: https://github.com/kitware/lidarview
- Owner: Kitware
- License: apache-2.0
- Created: 2019-06-09T08:07:39.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-05-06T12:16:20.000Z (9 months ago)
- Last Synced: 2025-05-26T06:09:07.982Z (8 months ago)
- Language: C++
- Homepage: https://www.paraview.org/lidarview/
- Size: 28.5 MB
- Stars: 274
- Watchers: 20
- Forks: 68
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Introduction
LidarView performs real-time reception, recording, visualization and processing of 3D LiDAR data.
LidarView currently supports a variety of LiDAR models from multiple manufacturers, including:
- `Velodyne`: VLP-16, VLP-32, HDL-32, HDL-64, Puck LITE, Puck Hi-Res and Alpha Prime (VLS-128).
- `Hesai`: Pandar40P, Pandar40M, Pandar64, Pandar20A, Pandar20B, PandarQT, PandarXT-16, PandarXT-32, PandarXTM and Pandar128.
- `Robosense`: RS16, RS32, BPerl, Helios (16 & 32), Ruby (48, 80 & 128), Ruby Plus (48, 80 & 128), M1, M2 and E1.
- `Livox`: Mid-40, Tele-15, Horizon, Mid-70, Avia, Mid-360 and HAP.
- `Leishen`: C16, C32 and MS_C16.
Additional sensor models may be supported upon request, provided that the drivers or specifications are publicly available.
This open-source codebase, developed by Kitware, is widely adopted by many LiDAR vendors, often rebranded under different names, to display their live LiDAR data.
Many of these LiDAR sensors sweep an array of lasers (often 8 to 128) 360°
with a vertical field of view of tens of degrees at a 5-20Hz spinning frequency,
capturing about a million points per second.
LidarView can display live sensors' streams or playback pre-recorded data stored in `.pcap` files.
LidarView displays the distance measurements from the LiDAR as point cloud
data and custom color maps for multiple variables such as
intensity-of-return, time, distance, azimuth, and laser id.
The processed data can be exported in multiple file formats (CSV, PLY, LAS, ...),
and screenshots of the currently displayed point cloud can be easily exported with the help of a button.
As a [Paraview](https://www.paraview.org/) based application, LidarView can effortlessly offer Paraview's features and plugins.
Lidar data processed by [Kitware's SLAM](#slam) within LidarView
# Features
- Input from live sensor stream or recorded `.pcap` file
- Visualization of timestamped LiDAR returns in 3D
- Spreadsheet inspector for LiDAR attributes (timestamp, azimuth, laser id, etc)
- Record to `.pcap` from sensor
- Export to CSV, PLY, PCD, LAS or VTK formats
- Grid and Ruler tools
- Show or hide lasers subsets
- Show multiple frames of data simultaneously and aggregate them
- Apply 3D transforms to pointclouds
- Run SLAM to estimate the trajectory of the LiDAR in the scene and build a 3D map of the environment
Many other features can be added using Plugins, some can be found on [this page](https://gitlab.kitware.com/LidarView/plugins).
Feel free to reach out at kitware@kitware.com for support or new features development.
# How to install
See associated download links in the [Release](https://gitlab.kitware.com/LidarView/lidarview/-/releases) page of this repository.
Nightly (master) packages are available [here](https://gitlab.kitware.com/LidarView/lidarview-superbuild/-/pipelines?scope=all&source=schedule&ref=master). (click on `Download artifacts`)
More detailed installation instructions are available on the [`LVCore/Documentation/INSTALLATION.md`](https://gitlab.kitware.com/LidarView/lidarview-core/-/blob/master/Documentation/INSTALLATION.md) page.
## Build from source
Detailed Instructions to build and package LidarView are available under [LidarView-superbuild README](https://gitlab.kitware.com/LidarView/lidarview-superbuild/-/blob/master/README.md).
Most of the LidarView common codebase lies within:
* [LVCore](https://gitlab.kitware.com/LidarView/lidarview-core) repository.
* [LidarView-superbuild](https://gitlab.kitware.com/LidarView/lidarview-superbuild) repository.
# How to use
## Sensor streaming
Specific network configuration is required for sensor livestream.
The ethernet adapter connected to the sensor has to be switched from dynamic IP address assignment to static IP address selection and correct IP adress and gateway must be specified.
For example:
* Velodyne HDL-32E
* IP address: 192.168.1.70 (70 as example, any number except 201 works)
* Gateway: 255.255.255.0
* Velodyne HDL-64E
* IP address: 192.168.3.70 (70 as example, any number except 43 works)
* Gateway: 192.168.3.255
In order for sensor streaming to work properly, it is important to
disable firewall restrictions for the chosen ethernet port and allow inbound traffic.
Alternatively, completely disable the firewall for the ethernet device connected to the sensor (including both public and private networks).
When opening pre-recorded data or live sensor streaming data,
one is prompted to choose a calibration file.
This calibration can either be directly embedded in LidarView,
or may be loaded from a custom location.
More [instructions](https://gitlab.kitware.com/keu-computervision/slam/-/blob/master/paraview_wrapping/doc/How_to_SLAM_with_LidarView.md) can be found on the [LidarSlam repository](https://gitlab.kitware.com/keu-computervision/slam).
Have a look also at the [How to SLAM with LidarView](https://vimeo.com/524848891) webinar.
# Sample data
LiDAR data samples for LidarView can be obtained from:
* [MIDAS](http://www.midasplatform.org/) in the [Velodyne LiDAR collection](http://midas3.kitware.com/midas/community/29)
* Kitware's demos shared [drive](https://drive.google.com/drive/folders/1yrNUelUsjKcXdC8FH8DpXeOPTyiB_pLS?usp=sharing)
# For Github users
[Github](https://github.com/Kitware/LidarView) is a mirror of the
[official repository](https://gitlab.kitware.com/LidarView/LidarView).
We do not actively monitor issues or pull request on Github. Please use the
[official repository](https://gitlab.kitware.com/LidarView/LidarView) to report issues or contributes fixes.
# License
The source code for LidarView is made available under the Apache 2.0 license.
See [LICENSE](LICENSE).