InstallΒΆ
How to install all MOLA modules:
From ROS 2 repositories
Recommended: This is the easiest way to install MOLA.
In Debian/Ubuntu systems, activate your ROS environment (setup.bash) if not done automatically
in your ~/.bashrc file, then just run:
# Install core MOLA modules and 3D LiDAR odometry
# (includes the readers for ROS 1/2 bags, rawlogs, KITTI, MulRan, ...):
sudo apt install \
ros-$ROS_DISTRO-mola \
ros-$ROS_DISTRO-mola-state-estimation \
ros-$ROS_DISTRO-mola-lidar-odometry
# (OPTIONAL) All public dataset readers (e.g. EuRoC) and the KITTI metrics tool:
sudo apt install ros-$ROS_DISTRO-mola-academic-datasets
# (OPTIONAL) Install example small datasets to run demos/unit tests:
sudo apt install ros-$ROS_DISTRO-mola-test-datasets
Check if all new nodes and apps are visible:
# For example, let's launch the mm map viewer.
# If a GUI app is opened, it means installation was successful.
mm-viewer
# You can also test the mola LO cli interface:
mola-lidar-odometry-cli --help
These are the versions available from ROS build farms for each main MOLA component:
Build from sources
Building tools
MOLA uses colcon so you need to install it first.
Note that despite ROS 2 integration, a full ROS 2 installation is actually not required for MOLA, only colcon and ament.
Get the sources
Clone the git repositories, including the submodules:
mkdir -p ~/ros2_mola_ws/src/
cd ~/ros2_mola_ws/src/
# Main MOLA modules:
git clone https://github.com/MOLAorg/mola_common.git
git clone https://github.com/MOLAorg/mp2p_icp.git --recursive
git clone https://github.com/MOLAorg/mola.git --recursive
git clone https://github.com/MOLAorg/mola_state_estimation.git
git clone https://github.com/MOLAorg/mola_test_datasets.git
git clone https://github.com/MOLAorg/mola_imu_preintegration.git
git clone https://github.com/MOLAorg/mola_sm_loop_closure.git
# MOLA lidar odometry package:
git clone https://github.com/MOLAorg/mola_lidar_odometry.git --recursive
Dependencies
Make sure you have all dependencies installed (make sure of having rosdep already installed):
cd ~/ros2_mola_ws/
rosdep install --from-paths src --ignore-src -r -y
Build and test
Now, compile as usual with colcon:
cd ~/ros2_mola_ws/
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo
Next, activate the new environment and check if all new modules are visible:
cd ~/ros2_mola_ws/
. install/setup.bash
# For example, let's launch the mm map viewer:
mm-viewer