VeloView: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
 
(33 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Introduction ==
== Introduction ==


VeloView performs real-time visualization of live captured 3D LiDAR data from Velodyne's HDL sensors (HDL-32E and HDL-64E).  An introduction to features of VeloView is available as a video:
VeloView performs real-time visualization and processing of live captured 3D LiDAR data from Velodyne's HDL sensors (HDL-64E, HDL-32E, VLP-32, VLP-16, Puck, Puck Lite, Puck HiRes).  An introduction to features of VeloView is available as a video:


{|
{|
Line 8: Line 8:
|}
|}


VeloView can playback pre-recorded data stored in .pcap files. The HDL sensor sweeps an array of lasers (32 or 64) 360° and a vertical field of view of 40°/26° with 5-20Hz and captures about a million points per second (HDL-32E: ~700,000pt/sec; HDL-64E: ~1.3Million pt/sec). VeloView displays the distance measurements from the HDL as point cloud data and supports custom color maps of multiple variables such as intensity-of-return, time, distance, azimuth, and laser id. The data can be exported as XYZ data in CSV format or screenshots of the currently displayed point cloud can be exported with the touch of a button.
VeloView can playback pre-recorded data stored in .pcap files, and can record live stream as .pcap file. The HDL sensor sweeps an array of lasers (16, 32, or 64) 360° and a vertical field of view of 40°/20° with 5-20Hz and captures about a million points per second (HDL-32E: ~700,000pt/sec; HDL-64E: ~1.3Million pt/sec). VeloView provides tools to display, select and measure information about the points captured from the sensor. VeloView displays the distance measurements from the Lidar as point cloud data and supports custom color maps of multiple variables such as intensity-of-return, time, distance, azimuth, dual return type, and laser id. The data can be exported as XYZ data in CSV format or screenshots of the currently displayed point cloud can be exported with the touch of a button.


== Features ==
== Features ==


* Configurable listening ports ('''new in 3.5''')
* Forward data received toward another port or/and ip address ('''new in 3.5''')
* Show the Rotation Per Minute of the current frame ('''new in 3.5''')
* Tool to select the dual returns of a selection of points ('''new in 3.5''')
* Cropping tool in Spherical and Box mode ('''new in 3.5''')
* Support for HDL-64 dual mode & on-the-fly calibration data ('''new in 3.5''')
* Support for VLP-32a, VLP-32b, VLP-32c, Puck Hi-Res and Puck LITE ('''new in 3.5''')
* Base infrastructure for georeferencing from GPS and IMU data ('''new in 3.5''')
* Base infrastructure for performing SLAM-based mapping, with and without GPS/IMU. See example below. This feature not yet fully available. ('''new in 3.5''')
* Advanced options to visualize 0-distance returns, empty frames, intensity correction and raw data (without azimuth adjustment) ('''new in 3.5''')
* User configurable playback speed ('''new in 3.5''')
* Underlying ParaView version is now version 5.1.2, providing many new tools ('''new in 3.5''')
* Input from live sensor stream or recorded .pcap file
* Input from live sensor stream or recorded .pcap file
* Visualization of LiDAR returns in 3D + time including 3d position and attribute data such as timestamp, azimuth, laser id, etc
* Visualization of LiDAR returns in 3D + time including 3D position and attribute data such as timestamp, azimuth, laser id, etc
* Spreadsheet inspector for LiDAR attributes
* Spreadsheet inspector for LiDAR attributes
* Record to .pcap from sensor
* Record to .pcap from sensor
* Export to CSV or VTK formats
* Export to CSV or VTK formats
* Record and export GPS and IMU data ('''New in 2.0''')
* Record and export GPS and IMU data
* Ruler tool ('''New in 2.0''')
* Ruler tool
* Visualize path of GPS data ('''New in 2.0''')
* Visualize path of GPS data
* Show multiple frames of data simultaneously ('''New in 2.0''')
* Show multiple frames of data simultaneously
* Show or hide a subset of lasers ('''New in 2.0''')
* Show or hide a subset of lasers
 
== Example video of a final mapping application using the new SLAM infrastructure ==
Below is some examples of using the built-in infrastructure for performing SLAM-based mapping, directly from an custom VeloView built for one of our customer BoE Systems.
{|
|-
| {{#ev:vimeo|232554153}}
| {{#ev:vimeo|232554140}}
|-
| {{#ev:vimeo|232554123}}
|}


== How to Obtain ==
== How to Obtain ==


Binary installers for VeloView are available as community contributed applications:
{| class="wikitable"
* [http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.1&type=app&os=win64&downloadFile=VeloView-2.0.0-31032014-Windows-64bit.exe Version 2.0 - Windows 64 ]
!|
* [http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.1&type=app&os=win32&downloadFile=VeloView-2.0.0-31032014-Windows-32bit.exe Version 2.0 - Windows 32]
!colspan="2" | Windows
* [http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.1&type=app&os=osx&downloadFile=VeloView-2.0.0-31032014-Darwin-64bit.dmg Version 2.0 - Mac OSX 10.8]
!| MacOSX
!colspan="2" |Linux 
|- style="border:1px solid #BBB"
! scope="col" |  !! scope="col" | 64-bits !! scope="col" | 32-bits !! scope="col" | 64-bits !! scope="col" | 64-bits !! scope="col"| 64-bits
|- style="border:1px solid #BBB"
! scope="row" |    3.5.0   
| <span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v5.1&type=app&os=win64&downloadFile=VeloView-3.5.0-Windows-64bit.exe Version 3.5.0 - Windows 64]</span>|| <span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v5.1&type=app&os=win32&downloadFile=VeloView-3.5.0-Windows-32bit.exe Version 3.5.0 - Windows 32]</span>|| <span class="plainlinks">[https://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v5.1&type=binary&os=macOS&downloadFile=VeloView-3.5.0-Darwin-64bit.dmg Version 3.5.0 - Mac OSX 10.9]</span>|| <span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v5.1&type=app&os=win32&downloadFile=VeloView-3.5.0-Linux-64bit.tar.gz 3.5.0 - tar.gz ]</span>||<span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v5.1&type=app&os=win32&downloadFile=VeloView-3.5.0-Linux-64bit.sh 3.5.0 - sh ]</span>
|-
! scope="row" | 3.1.1
| <span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.3&type=app&os=win64&downloadFile=VeloView-3.1.1-26022015-Windows-64bit.exe Version 3.1.1 - Windows 64 ]</span>|| <span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.3&type=app&os=win32&downloadFile=VeloView-3.1.1-26022015-Windows-32bit.exe Version 3.1.1- Windows 32 ]</span>|| <span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.3&type=app&os=osx&downloadFile=VeloView-3.1.1-26022015-Darwin-64bit.dmg Version 3.1.1 - Mac OSX 10.8 ]</span>|
|-
! scope="row" | 2.0
| <span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.1&type=app&os=win64&downloadFile=VeloView-2.0.0-31032014-Windows-64bit.exe Version 2.0 - Windows 64 ]</span>||<span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.1&type=app&os=win32&downloadFile=VeloView-2.0.0-31032014-Windows-32bit.exe Version 2.0 - Windows 32 ]</span>||<span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.1&type=app&os=osx&downloadFile=VeloView-2.0.0-31032014-Darwin-64bit.dmg Version 2.0 - Mac OSX 10.8 ]</span>|
|-
! scope="row" | 1.0.8
| <span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.0&type=app&os=win64&downloadFile=VeloView-1.0.8-Windows-64bit.exe Version 1.0.8 - Windows 64 ]</span>||<span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.0&type=app&os=win64&downloadFile=VeloView-1.0.8-Windows-32bit.exe Version 1.0.8 - Windows 32 ]</span>||<span class="plainlinks">[http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.0&type=app&os=osx&downloadFile=VeloView-1.0.8-Darwin-64bit.dmg Version 1.0.8 - Mac OSX 10.8 ]</span>|
|}


Previous releases are also available
The source code for VeloView is made available under the Apache 2.0 license.  To obtain the latest version clone the git repository as shown below:
* [http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.0&type=app&os=win64&downloadFile=VeloView-1.0.8-Windows-64bit.exe Version 1.0.8 - Windows 64 ]
  $ git clone https://github.com/Kitware/VeloView.git
* [http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.0&type=app&os=win64&downloadFile=VeloView-1.0.8-Windows-32bit.exe Version 1.0.8 - Windows 32]
* [http://www.paraview.org/paraview-downloads/download.php?submit=Download&version=v4.0&type=app&os=osx&downloadFile=VeloView-1.0.8-Darwin-64bit.dmg Version 1.0.8 - Mac OSX 10.8]
 
The source code for VeloView is made available under the Apache 2.0 license.  Source code is available as a .tgz file for [http://public.kitware.com/gitweb?p=VeloView.git;a=snapshot;h=3e88f28e39dcdacb6a570b690eaf313484c0207b;sf=tgz version 2.0.0].  To obtain the latest version clone the git repository as shown below:
  $ git clone git://public.kitware.com/VeloView.git


Sample data for VeloView can be obtained from [http://www.midasplatform.org/ MIDAS] in the [http://midas3.kitware.com/midas/community/29 Velodyne LiDAR collection].
Sample data for VeloView can be obtained from [http://www.midasplatform.org/ MIDAS] in the [http://midas3.kitware.com/midas/community/29 Velodyne LiDAR collection].
----
The modified source for Ubuntu-14.04 is available by hacked from mrpark@etri.re.kr
* [http://www.paraview.org/Wiki/images/4/45/VeloView-ubuntu-x64-src.tgz Version 2.0 - Ubuntu-14.04 64 ]


== How to use ==
== How to use ==
For “sensor streaming” (live display of sensor data) it is important to change the network settings of the Ethernet adapter connected to the sensor from automatic IP address to manual IP address selection and choose:
For “sensor streaming” (live display of sensor data) it is important to change the network settings of the Ethernet adapter connected to the sensor from automatic IP address to manual IP address selection and choose:


* HDL-32E
* HDL-32E and VLP-16
**IP address: 192.168.1.70  (70 as example, any number except 201 works)
**IP address: 192.168.1.70  (70 as example, any number except 201 works)
**Gateway: 255.255.255.0
**Gateway: 255.255.255.0
Line 56: Line 85:
In order for sensor streaming to work properly, it is important to disable firewall restrictions for the Ethernet port.  Disable the firewall completely for the ethernet device connected to the sensor or explicitly allow data from that Ethernet port of (including both public and private networks).
In order for sensor streaming to work properly, it is important to disable firewall restrictions for the Ethernet port.  Disable the firewall completely for the ethernet device connected to the sensor or explicitly allow data from that Ethernet port of (including both public and private networks).


When opening pre-recorded data or live sensor streaming data one is prompted to choose a calibration file.
When opening pre-recorded data or live sensor streaming data one is prompted to choose a calibration file. Please select the shipped file corresponding to your sensor model, or "HDL64 Live Corrections" if you wish to use the calibration sent over-the-network by an HDL64 sensor.
*For HDL-32E data no calibration file is needed (the HDL-32E calibration values are already incorporated in VeloView) therefore select “NONE”.
*For HDL-64E data the correct calibration file for that sensor needs to be chosen. The calibration file can be found on the individual product CD that was send with the HDL-64E sensor.


== How to build ==
== How to build ==


Detailed instructions for building and packaging are available in [http://public.kitware.com/gitweb?p=VeloView.git;a=blob_plain;f=Documentation/VeloView_Developer_Guide.pdf;h=53a6b93bd34e453f17303f1d48476492a8284596;hb=HEAD developers guide] the source code checkout under the Documentation folder.
Detailed instructions for building and packaging are available in [https://github.com/Kitware/VeloView/blob/master/Documentation/VeloView_Developer_Guide.pdf developers guide] the source code checkout under the Documentation folder.

Latest revision as of 21:17, 5 September 2017

Introduction

VeloView performs real-time visualization and processing of live captured 3D LiDAR data from Velodyne's HDL sensors (HDL-64E, HDL-32E, VLP-32, VLP-16, Puck, Puck Lite, Puck HiRes). An introduction to features of VeloView is available as a video:

VeloView can playback pre-recorded data stored in .pcap files, and can record live stream as .pcap file. The HDL sensor sweeps an array of lasers (16, 32, or 64) 360° and a vertical field of view of 40°/20° with 5-20Hz and captures about a million points per second (HDL-32E: ~700,000pt/sec; HDL-64E: ~1.3Million pt/sec). VeloView provides tools to display, select and measure information about the points captured from the sensor. VeloView displays the distance measurements from the Lidar as point cloud data and supports custom color maps of multiple variables such as intensity-of-return, time, distance, azimuth, dual return type, and laser id. The data can be exported as XYZ data in CSV format or screenshots of the currently displayed point cloud can be exported with the touch of a button.

Features

  • Configurable listening ports (new in 3.5)
  • Forward data received toward another port or/and ip address (new in 3.5)
  • Show the Rotation Per Minute of the current frame (new in 3.5)
  • Tool to select the dual returns of a selection of points (new in 3.5)
  • Cropping tool in Spherical and Box mode (new in 3.5)
  • Support for HDL-64 dual mode & on-the-fly calibration data (new in 3.5)
  • Support for VLP-32a, VLP-32b, VLP-32c, Puck Hi-Res and Puck LITE (new in 3.5)
  • Base infrastructure for georeferencing from GPS and IMU data (new in 3.5)
  • Base infrastructure for performing SLAM-based mapping, with and without GPS/IMU. See example below. This feature not yet fully available. (new in 3.5)
  • Advanced options to visualize 0-distance returns, empty frames, intensity correction and raw data (without azimuth adjustment) (new in 3.5)
  • User configurable playback speed (new in 3.5)
  • Underlying ParaView version is now version 5.1.2, providing many new tools (new in 3.5)
  • Input from live sensor stream or recorded .pcap file
  • Visualization of LiDAR returns in 3D + time including 3D position and attribute data such as timestamp, azimuth, laser id, etc
  • Spreadsheet inspector for LiDAR attributes
  • Record to .pcap from sensor
  • Export to CSV or VTK formats
  • Record and export GPS and IMU data
  • Ruler tool
  • Visualize path of GPS data
  • Show multiple frames of data simultaneously
  • Show or hide a subset of lasers

Example video of a final mapping application using the new SLAM infrastructure

Below is some examples of using the built-in infrastructure for performing SLAM-based mapping, directly from an custom VeloView built for one of our customer BoE Systems.

How to Obtain

Windows MacOSX Linux
64-bits 32-bits 64-bits 64-bits 64-bits
3.5.0 Version 3.5.0 - Windows 64 Version 3.5.0 - Windows 32 Version 3.5.0 - Mac OSX 10.9 3.5.0 - tar.gz 3.5.0 - sh
3.1.1 Version 3.1.1 - Windows 64 Version 3.1.1- Windows 32
2.0 Version 2.0 - Windows 64 Version 2.0 - Windows 32
1.0.8 Version 1.0.8 - Windows 64 Version 1.0.8 - Windows 32

The source code for VeloView is made available under the Apache 2.0 license. To obtain the latest version clone the git repository as shown below:

$ git clone https://github.com/Kitware/VeloView.git

Sample data for VeloView can be obtained from MIDAS in the Velodyne LiDAR collection.

How to use

For “sensor streaming” (live display of sensor data) it is important to change the network settings of the Ethernet adapter connected to the sensor from automatic IP address to manual IP address selection and choose:

  • HDL-32E and VLP-16
    • IP address: 192.168.1.70 (70 as example, any number except 201 works)
    • Gateway: 255.255.255.0
  • 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 Ethernet port. Disable the firewall completely for the ethernet device connected to the sensor or explicitly allow data from that Ethernet port of (including both public and private networks).

When opening pre-recorded data or live sensor streaming data one is prompted to choose a calibration file. Please select the shipped file corresponding to your sensor model, or "HDL64 Live Corrections" if you wish to use the calibration sent over-the-network by an HDL64 sensor.

How to build

Detailed instructions for building and packaging are available in developers guide the source code checkout under the Documentation folder.