Tutorials Home Next

Compiling and Installing libpointmatcher on your Computer (Mac OS X Instructions)

In short...

If you are used to development project, here is what you need:

Name Version
(Tested Feb. 16, 2015)
MacOS 10.10.2
Xcode todo
gcc 4.2.1
brew 0.9.5
git 1.9.3
cmake 3.0.2
doxygen (opt.)
boost 1.57.0
eigen 3.2.4
libnabo from source

Note: Other versions will most probably work but you'll have to try yourself to know for sure.

The rest of this tutorial will guide you through the different requirements step by step.

Some Basic Requirements

a. Installing Xcode via the App Store (OS X 10.10.2 and later)

Mac OS X does not come with a built-in C++ command-line compiler. You must therefore install XCode by visiting the App Store.

Once Xcode is installed on your machine, launch it. Navigate to preferences, to the downloads tab. In the components list, install the Command Line Tools component.

You should now have a working version of gcc. You can check by running the following command in your terminal:

gcc --version

A message similar to the following should appear

Configured with: --prefix=/Applications/Xcode.app/Contents/Developer/usr --with-gxx-include-dir=/usr/include/c++/4.2.1
Apple LLVM version 6.0 (clang-600.0.56) (based on LLVM 3.5svn)
Target: x86_64-apple-darwin14.1.0
Thread model: posix

b. Installing Homebrew

Because Mac OS X does not come with a built-in package manager like in Ubuntu, you need to install one on your own. A package manager is handy because it allows you to install, uninstall, update and maintain software packages with ease. There are several possibilities including Macports and Homebrew. While both are good options, we have a slight preference for homebrew which is easier to use.

You do not need a package manager to install libpointmatcher, but it simplifies things. The following instructions will make use of homebrew and will thus assume that it is installed on your system.

Installing Homebrew is extremely easy and can be done by entering the following single command in your terminal

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Once the scripts finishes installing, you are good to go!

c. Installing Boost

Boost is a widely-used C++ library and is included in most Linux distributions. Mac OS X does not ship with Boost so if you have never used it before, you probably need to install it. You can install the latest version of boost with the following homebrew command:

brew install boost

d. Installing Git

Git is a version control system similar to SVN designed for collaboration on large code projects. Because libpointmatcher is hosted on Github, you should the git application to keep track of code revisions, and bug fixes pushed to the public repository.

After installing the Xcode Command Line Tools, Git should already be installed on your system but you can check that it is there by running

git --version 

If Git is installed, you should see a message of the form

git version

If not refer to the Git homepage for installation instructions or install via homebrew by running

brew install git

e. Installing CMake

CMake is a cross-platform build system and is used for building the libpointmatcher library. Refer to the homepage for installation instructions, or you can once again use homebrew

brew install cmake

1. Installing Eigen

The Eigen linear algebra is required before installing libpointmatcher and can be found here. Either download and compile Eigen following instructions from the package website or simply install the package via homebrew by running:

brew install eigen

2. Compiling the Documentation (optional)

Libpointmatcher is documented directly in the source-code using Doxygen. If Doxygen is installed on your system, an html version of the documentation will be compiled in /usr/local/share/doc/libpointmatcher/. To install Doxygen in Ubuntu, run:

brew install doxygen

Once you have compiled libpointmatcher in step 6, you can simply open /usr/local/share/doc/libpointmatcher/api/html/index.html in a browser to view the API documentation.

3. Installing libnabo

libnabo is a library for performing fast nearest-neighbor searches in low-dimensional spaces. It can be found here. Clone the source repository into a local directory of your choice.

mkdi r ~/Libraries/
cd ~/Libraries
git clone git://github.com/ethz-asl/libnabo.git
cd libnabo

Now you can compile libnabo by entering the following commands

mkdir -p ${BUILD_DIR} && cd ${BUILD_DIR}
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo ${SRC_DIR}

To make sure that everything is working properly, run the unit tests:

make test

This will run multiple nearest-neighbor searches performances and may take some minutes.

sudo make install

Note: If Eigen or Boost are not in their regular system locations you will have to indicate their location by setting the corresponding CMake flags. You can use the following command to default flags:

ccmake .

4. Installing libpointmatcher

Clone the source repository into a local directory. As an example we reuse the Libraries directory that was created to contain the libnabo sources.

cd ~/Libraries/
git clone git://github.com/ethz-asl/libpointmatcher.git
cd libpointmatcher

Now, libpointmatcher is compiled into a /build directory.

mkdir -p ${BUILD_DIR} && cd ${BUILD_DIR}
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo ${SRC_DIR}

You can optionally verify that the version of libpointmatcher you have compiled is stable by running the unit tests.

utest/utest --path ../examples/data/

Finally, to install libpointmatcher to your system run the following:

sudo make install

Possible Caveats

If Eigen, libnabo, yaml-cpp, or GTest are not found during the installation, you will have to manually supply their installation locations by setting the CMake flags. You can do so using the ccmake tool.

cd build
ccmake ..

You can then set EIGEN_INCLUDE_DIR, NABO_INCLUDE_DIR, NABO_LIBRARY, yaml-cpp_INCLUDE_DIRS, yaml-cpp_LIBRARIES to point to your installation directories as shown in the screenshot above. Then, generate the make files by clicking generate and rerun the following inside /build:

sudo make install

Having problems?

Some dependencies changed and we don't keep track of all combinations possible. Before reporting a problem, make sure to include the versions you are using.

Here are useful commands for the different version:

MacOS version:

sw_vers -productVersion

Compiler version:

gcc --version


brew --version


brew info boost


git --version


cmake --version


brew info eigen


brew info doxygen