Skip to content

Create PCD#

This section

This section is still under development!

PointCloudMapper#

Description#

PointCloudMapper is a tool for a vehicle based point cloud mapping in a simulation environment. It is very useful when you need a point cloud based on some location, but don't have the possibility to physically map the real place. Instead you can map the simulated environment.

Required Data#

To properly perform the mapping, make sure you have the following files downloaded and configured:

  • Lanelet2 format OSM data (*.osm file)
  • 3D model map of the area

    How to obtain a map

    You can obtain the 3D model of the area by using a Environment prefab prepared for AWSIM or by creating your own. You can learn how to create you own Environment prefab in this tutorial.

  • Configured in-simulation vehicle object with sensors attached (only the LiDAR is necessary)

    Vehicle model

    For the sake of creating a PCD the vehicle model doesn't have to be accurate. It will be just a carrier for LiDAR. The model can even be a simple box as shown earlier in this tutorial. Make sure it is not visible to the LiDAR, so it does not break the sensor readings.

Import OSM#

  1. Drag and drop an OSM file into Unity project.

    move osm file

  2. OSM file will be imported as OsmDataContainer.

Setup an Environment#

For mapping an Environment prefab is needed. The easiest way is to create a new Scene and import the Environment prefab into it. Details on how to do this can be found on this tutorial page.

Setup a Vehicle#

Create a Vehicle GameObject in the Hierarchy view.

add vehicle object

Add visual elements (optional)#

Add vehicle model by adding a Geometry Object as a child of Vehicle and adding all visual elements as children.

vehicle add geometry

Visual elements

You can learn how to add visual elements and required components like Mesh Filter or Mesh Renderer in this tutorial.

Add a Camera (optional)#

Add a Camera component for enhanced visuals by adding a Main Camera Object as a child of Vehicle Object and attaching a Camera Component to it.

  1. Add a Main Camera Object.

    vehicle camera add object

  2. Add a Camera Component by clicking 'Add Component' button, searching for it and selecting it.

    vehicle camera add component

  3. Change the Transform for an even better visual experience.

    Camera preview

    Observe how the Camera preview changes when adjusting the transformation.

    vehicle camera transform

Setup Vehicle Sensors (RGL)#

This part of the tutorial shows how to add a LiDAR sensor using RGL.

RGL Scene Manager

Please make sure that RGLSceneManager is added to the scene. For more details and instruction how to do it please visit this tutorial page.

  1. Create an empty Sensors GameObject as a child of the Vehicle Object.

    add sensors object

  2. Create a Lidar GameObject as a child of the Sensors Object.

    add lidar object

  3. Attach Lidar Sensor (script) to previously created Lidar Object by clicking on the 'Add Component' button, searching for the script and selecting it.

    Point Cloud Visualization

    Please note that Point Cloud Visualization (script) will be added automatically with the Lidar Sensor (script).

    add lidar sensor script

    lidar sensor search

  4. Configure LiDAR pattern, e.g. by selecting one of the available presets.

    Example Lidar Sensor configuration

    lidar sensor configuration example

    Gaussian noise

    Gaussian noise should be disabled to achieve a more accurate map.

  5. Attach RGL Mapping Adapter (script) to previously created Lidar Object by clicking on the 'Add Component' button, searching for the script and selecting it.

    add rgl mapping adapter script

    rgl mapping adapter search

  6. Configure RGL Mapping Adapter - e.g. set Leaf Size for filtering.

    Example RGL Mapping Adapter configuration

    rgl mapping adapter configuration example

    Downsampling

    Please note that downsampling is applied on the single LiDAR scans only. If you would like to filter merged scans use the external tool described below.

Effect of Leaf Size to Point Cloud Data (PCD) generation#

Downsampling aims to reduce PCD size which for large point clouds may achieve gigabytes in exchange for map details. It is essential to find the best balance between the size and acceptable details level.

A small Leaf Size results in a more detailed PCD, while a large Leaf Size could result in excessive filtering such that objects like buildings are not recorded in the PCD.

In the following examples, it can be observed that when a Leaf Size is 1.0, point cloud is very detailed. When a Leaf Size is 100.0, buildings are filtered out and results in an empty PCD. A Leaf Size of 10.0 results in a reasonable PCD in the given example.

Leaf Size = 1.0 Leaf Size = 10.0 Leaf Size = 100.0

Setup PointCloudMapper#

  1. Create a PointCloudMapper GameObject in the Hierarchy view.

    add point cloud mapper object

  2. Attach Point Cloud Mapper script to previously created Point Cloud Mapper Object by clicking on the 'Add Component' button, searching for the script and selecting it.

    add point cloud mapper script

    point cloud mapper search

  3. Configure the Point Cloud Mapper fields:

    • Osm Container - the OSM file you imported earlier
    • World Origin - MGRS position of the origin of the scene

      World Origin coordinate system

      Use ROS coordinate system for World Origin, not Unity.

    • Capture Location Interval - Distance between consecutive capture points along lanelet centerline
    • Output Pcd File Path - Output relative path from Assets folder
    • Target Vehicle - The vehicle you want to use for point cloud capturing that you created earlier

    Example Point Cloud Mapper configuration

    point cloud mapper configuration example

    Lanelet visualization

    point cloud mapper disabled lanelet visualizer It is recommended to disable Lanelet Visualizer by setting Material to None and Width equal to zero. Rendered Lanelet is not ignored by the LiDAR so it would be captured in the PCD.

Effect of Capture Location Interval to PCD generation#

If the Capture Location Interval is too small, it could result in a sparse PCD where some region of the map is captured well but the other regions aren't captured at all.

In the below example, Leaf Size of 0.2 was used. Please note that using a different combination of leaf size and Capture Location Interval may result in a different PCD.

Capture Location Interval = 6 Capture Location Interval = 20 Capture Location Interval = 100

Capture and Generate PCD#

If you play simulation with a scene prepared with the steps above, PointCloudMapper will automatically start mapping. The vehicle will warp along centerlines by intervals of CaptureLocationInterval and capture point cloud data. PCD file will be written when you stop your scene or all locations in the route are captured.

If the Vehicle stops moving for longer and you see the following message in the bottom left corner - you can safely stop the scene.

pcd save success

The Point cloud *.pcd file is saved to the location you specified in the Point Cloud Mapper.

PCD postprocessing#

Install required tool

The tool (DownsampleLargePCD) required for PCD conversion can be found under the link. README contains building instruction and usage.

The generated PCD file is typically too large. Therefore you need to downsample it. Also, it should be converted to ASCII format because Autoware accepts only this format. PointCloudMapper returns PCD in binary format.

  1. Change the working directory to the location with DownsampleLargePCD tool.
  2. Use this tool to downsample and save PCD in ASCII format.

    ./DownsampleLargePCD -in <PATH_TO_INPUT_PCD> -out <PATH_TO_OUTPUT_PCD> -leaf 0.2,0.2,0.2
    
    • Assuming input PCD is in your working directory and named in_cloud.pcd and output PCD is to be named out_cloud.pcd the command will be:
      ./DownsampleLargePCD -in in_cloud.pcd -out out_cloud.pcd -leaf 0.2,0.2,0.2
      
    • You can also save PCD in binary format by adding -binary 1 option.
  3. Your PCD is ready to use.

Converting PCD format without downsampling

If you don't want to downsample your PCD you can convert PCD file to ASCII format with pcl_convert_pcd_ascii_binary tool. This tool is available in the pcl-tools package and can be installed on Ubuntu with the following command:

sudo apt install pcl-tools
To convert your PCD use command:
pcl_convert_pcd_ascii_binary <PATH_TO_INPUT_PCD> <PATH_TO_OUTPUT_PCD> 0

Verify the PCD#

To verify your PCD you can launch the Autoware with the PCD file specified.

  1. Copy your PCD from the AWSIM project directory to the Autoware map directory.

    cp <PATH_TO_PCD_FILE> <PATH_TO_AUTOWARE_MAP>/
    
  2. Source the ROS and Autoware

    source /opt/ros/humble/setup.bash
    source <PATH_TO_AUTOWARE>/install/setup.bash
    
  3. Launch the planning simulation with the map directory path (map_path) and PCD file (pointcloud_map_file) specified.

    PCD file location

    The PCD file needs to be located in the Autoware map directory and as a pointcloud_map_file parameter you only supply the file name, not the path.

    Absolute path

    When launching Autoware never use ~/ to specify the home directory. Either write the full absolute path ot use $HOME environmental variable.

    ros2 launch autoware_launch planning_simulator.launch.xml vehicle_model:=sample_vehicle sensor_model:=sample_sensor_kit map_path:=<ABSOLUTE_PATH_TO_AUTOWARE_MAP> pointcloud_map_file:=<PCD_FILE_NAME>
    
  4. Wait for the Autoware to finish loading and inspect the PCD visually given the Effect of Leaf Size and Effect of Capture Location Interval.

Sample Scene#

PointCloudMapping.unity is a sample scene for PointCloudMapper showcase. It requires setup of OSM data and 3D model map of the area according to the steps above.

Sample Mapping Scene

In this example you can see a correctly configured Point Cloud Mapping Scene.