The PMPL library is a general code base for studying motion planning algorithms. This file lists the package dependencies for PMPL and how to install them.

Tested on Ubuntu 20.04, Ubuntu 22.04, macOS Sonoma (Intel and Apple Silicon)

Install cmake using homebrew:

brew install cmake

PPL can be built on MacOS using Conan. Install conan for Apple Silicon or Intel using the instructions below.

Install conan and set up the conan profile for your computer:

brew install conan
conan profile detect

Install PPL dependencies:

brew install ninja doxygen graphviz

Install necessary packages with conan:

conan install . --output-folder=build --build=missing -c tools.system.package_manager:mode=install -c tools.system.package_manager:sudo=true -s build_type=Debug -s compiler.cppstd=gnu17

Build PPL with Conan:

cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja -DCMAKE_TOOLCHAIN_FILE=build/conan_toolchain.cmake -B build/

Build PPL with however many cores you'd prefer using -j(number). By default, all cores will be used, which can potentially overwhelm your computer.

cmake --build build -j3

Install conan and set up the conan profile for your computer:

pip install conan
conan profile detect

Conan will install all of the packages you'll need to build PPL:

conan install . --output-folder=build --build=missing -c tools.system.package_manager:mode=install -c tools.system.package_manager:sudo=true -s build_type=Debug -s compiler.cppstd=gnu17

Build PPL with Conan:

cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja -DCMAKE_TOOLCHAIN_FILE=build/conan_toolchain.cmake -B build/

Build PPL with however many cores you'd prefer using -j(number). By default, all cores will be used, which can potentially overwhelm your computer.

cmake --build build -j3

• conan or vcpkg

• build-essential
• make
• cmake
• ninja-build
• doxygen

It is recommended to update programs on your system before continuing. However, this can sometimes break certain programs that require a specific package version, such as a graphics driver and CUDA library.

• opencv (note: can be removed but build image needs updating)
• eigen3
• cgal
• bullet3
• boost
• nlohmann-json
• qtbase
• qttools
• catch2
• tinyxml2

sudo apt-get update

sudo apt-get upgrade

sudo apt-get update

sudo apt-get install tzdata build-essential gdb python3 gperf libclang-dev gfortran ninja-build pkg-config make wget curl zip unzip software-properties-common git-all libtool autoconf-archive texinfo bison libmpfr-dev libeigen3-dev libboost-all-dev libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev libxft-dev libfontconfig1-dev libfreetype6-dev libx11-dev libx11-xcb-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev libxcb1-dev libxcb-glx0-dev libxcb-keysyms1-dev libxcb-image0-dev libxcb-shm0-dev libxcb-icccm4-dev libxcb-sync-dev libxcb-xfixes0-dev libxcb-shape0-dev libxcb-randr0-dev libxcb-render-util0-dev libxcb-util-dev libxcb-xinerama0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev libatspi2.0-dev libxrandr-dev libxcursor-dev libxdamage-dev libxinerama1 libxinerama-dev libxcomposite-dev libxkbfile-dev libxmuu-dev libxres-dev libxcb-dri3-dev libxcb-cursor-dev libssl-dev doxygen graphviz

sudo apt remove -y --purge --auto-remove cmake
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /etc/apt/trusted.gpg.d/kitware.gpg >/dev/null

For Ubuntu Jammy Jellyfish (22.04)

sudo apt-add-repository -y 'deb https://apt.kitware.com/ubuntu/ jammy main'

For Ubuntu Focal Fossa (20.04)

sudo apt-add-repository -y 'deb https://apt.kitware.com/ubuntu/ focal main'   

For Ubuntu Bionic Beaver (18.04)

sudo apt-add-repository -y 'deb https://apt.kitware.com/ubuntu/ bionic main'

sudo apt update
sudo apt install cmake

Alternate installation instructions available at https://docs.conan.io/en/latest/installation.html

pip install conan

Make sure that the installed version of conan is > 2.0

conan --version

Setup default conan profile for machine.

conan profile detect

For Ubuntu 22.04, qt/6.3.2 requires this export for C3I until conan-io/conan-center-index#13472 is fixed

export NOT_ON_C3I=1

conan install . --output-folder=build --build=missing -c tools.system.package_manager:mode=install -c tools.system.package_manager:sudo=true -s build_type=Debug -s compiler.cppstd=gnu17

Make sure to set tools.system.package_manager:sudo=false if using docker

cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja -DCMAKE_TOOLCHAIN_FILE=build/conan_toolchain.cmake -B build/

Build PPL with however many cores you'd prefer using -j(number). By default, all cores will be used, which can potentially overwhelm your computer.

cmake --build build -j3

Boost 1.82.0 vs 1.83.0 (CGAL vs PPL req.) => Change boost ver. in conanfile.py to 1.83.0 mpfr 4.1.0 vs 4.2.1 => mpfr boost ver. in conanfile.py to 4.2.1

Full instructions available at https://vcpkg.io/en/getting-started.html

cd /opt

sudo git clone https://github.com/Microsoft/vcpkg.git

sudo chmod 777 /opt/vcpkg && sudo chmod 666 vcpkg/.vcpkg-root

sudo ./vcpkg/bootstrap-vcpkg.sh

Run cmake, specify build type (e.g. Release or Debug), generator (e.g. Ninja), vcpkg installation path, source path, and output path. cd into the cloned repo

cd pmpl

cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja -DCMAKE_TOOLCHAIN_FILE=/opt/vcpkg/scripts/buildsystems/vcpkg.cmake -S . -B build

Build PPL with however many cores you'd prefer using -j(number). By default, all cores will be used, which can potentially overwhelm your computer.

cmake --build build -j3

CGAL version 5.5.2 is incompatible => Change CGAL ver. in vcpkg.json to 5.4.2

Alternatively a default docker file is provided, with the above instructions pre-built. More docker configurations and instructions are available here.

Follow the instructions on https://docs.docker.com/get-docker/ for your operating system

In order to build in a docker container, first clone this repository to your Docker host system. In the top level directory of the cloned repository, execute the following commands

docker build -t pmpl-build .
docker run -it pmpl-build 

The executable built resides in /pmpl/build/pmpl_exec within the docker container

From ppl, run

./build/tests/ppl_unit_test

To install the PPL libraries and related headers, run the following in this directory.

cmake --build build --target install

In order to have access to the dependencies of PPL, for things like header files included in PPL's header files, you should include the following commands in the CMakeLists file for your ptroject.

find_package(Qt6 CONFIG COMPONENTS Core Gui Widgets OpenGL OpenGLWidgets REQUIRED)
find_package(Eigen3 CONFIG REQUIRED)
find_package(Bullet CONFIG REQUIRED
         LinearMath Bullet3Common BulletDynamics BulletSoftBody BulletCollision BulletInverseDynamics)
find_package(modelloader CONFIG REQUIRED)
find_package(RAPID CONFIG REQUIRED)
find_package(Tetgen CONFIG REQUIRED)
find_package(PQP CONFIG REQUIRED)
find_package(gl_visualizer CONFIG COMPONENTS nonstd glutils sandbox REQUIRED)
find_package(PPL CONFIG REQUIRED)

Then you will need to link to either ppl::ppl_mp_library or ppl::ppl_library

Libraries installed with vcpkg can always be built from source. However, this can duplicate work and waste time across multiple developers or machines.

Binary caching saves copies of library binaries in a shared location that can be accessed by vcpkg for future installs. Caches can be hosted in a variety of environments. The most basic examples are a folder on the local machine or a network file share. Caches can also be stored in any NuGet feed (such as GitHub Packages or Azure DevOps Artifacts), Azure Blob Storage, Google Cloud Storage, and many other services.

https://learn.microsoft.com/en-us/vcpkg/users/binarycaching

We use doxygen for documentation, which is automatically generated when you build PPL. To view it, open docs/Doxygen/html/index.html

We provide Examples/CfgExamples.xml as an example of how to create an xml file to run a motion planning scenaio. Run the following command to use it:

./build/ppl_mp -f Examples/CfgExamples.xml