Build Options {#buildOptions}

If you are building OMPL from source, there are several options that you can use to configure how OMPL is compiled. The options can be set via the command line like so: cmake -D<option>=ON ../... If you previously ran cmake in your build directory, it is safest to remove the CMakeCache.txt before re-running cmake with different options. Below is a list of all options.

Option	Default value	Description
OMPL_BUILD_DEMOS	ON	Compile the OMPL demo programs. (The binaries are never installed.)
OMPL_BUILD_PYBINDINGS	ON	Whether to compile the Python bindings (requires Py++).
OMPL_BUILD_PYTESTS	ON	Whether the Python tests should be added to the test target.
OMPL_BUILD_TESTS	ON	Wether to compile the C++ unit tests
OMPL_BUILD_VAMP	ON	Build VAMP (Vector-Accelerated Motion Planning) submodule for enhanced collision checking performance.
OMPL_REGISTRATION	ON	Whether the registration page is shown. (Disabling it might be useful for build bots.)
OMPL_VERSIONED_INSTALL	ON	Install header files in include/ompl-X.Y/ompl, where X and Y are the major and minor version numbers.
VAMP_PORTABLE_BUILD	OFF	Build VAMP with portable SIMD settings for distribution (package maintainers). When OFF, uses native SIMD for best performance.
VAMP_BUILD_PYTHON_BINDINGS	OFF	Build VAMP Python bindings (advanced feature, requires OMPL_BUILD_VAMP=ON).

There also several optional dependencies. By default, if an optional dependency is detected by cmake, support for this dependency is enabled. If this is not what you want, you can run cmake like so:

 cmake -DCMAKE_DISABLE_FIND_PACKAGE_<PackageName>=ON ../..

where <PackageName> is, e.g., pypy, flann, spot, etc.