BUILD.md

Build instructions

This document summarizes how to build and install the project and its dependencies.

Operating system

The project is built under Linux. It is recommended to use a 64-bit operating system.
Ubuntu 20.04 LTS was used during development.

Dependencies

The project uses some third-party dependencies. These can be installed from the official repository of the given Linux distribution.

• GNU Make
• Boost, version >= 1.71
• CMake, version >= 3.16
• PCL, version >= 1.10
• OpenCV, version >= 4.0

The following command installs the packages:

sudo apt-get update
sudo apt-get install build-essential make cmake libpcl-dev libproj-dev libopencv-dev

Compilation

Submodules

The project depends on some locally built tools:

• LAStools (LASlib and LASzip)

Check out the repository, then initialize the submodules to download the locally built dependencies:

git submodule init
git submodule update

Compile the dependencies:

cd vendor
make

Note: rerun when tools change in the vendor directory.

Build the project

Configure the project:

mkdir build
cd build
cmake ../src

Compile the project:

make

Note: you may add the -j<N> flag to compile on multiple threads (where <N> is the number of threads).

Install the program

If you would like to deploy the final compiled binaries to a distinct folder, you may install the project.

mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=<install_path>
make
make install