Installing pptk

Install from PyPI

Install pptk directly from PyPI

>>> pip install pptk

Note

pptk requires 64-bit Python and is only pip install-able on versions of Python that have a corresponding pptk wheel file on PyPI.

Or install from the .whl file that results from building pptk from source.

>>> pip install <.whl file>

Building from source

pptk source code is available on GitHub

Build is mostly automated via CMake scripts, but the user must manually prepare dependencies and record their paths in the following CMake cache variables.

  • Numpy_INCLUDE_DIR
  • PYTHON_INCLUDE_DIR
  • PYTHON_LIBRARY
  • Eigen_INCLUDE_DIR
  • TBB_INCLUDE_DIR
  • TBB_tbb_LIBRARY
  • TBB_tbb_RUNTIME
  • TBB_tbbmalloc_LIBRARY
  • TBB_tbbmalloc_RUNTIME
  • Qt5_DIR

To set these variables, either use one of CMake’s GUIs (ccmake or cmake-gui), or provide an initial CMakeCache.txt in the target build folder (for examples of initial cache files, see the CMakeCache..txt files)

Requirements

Listed are versions of libraries used to develop pptk, though earlier versions of these libraries may also work. pptk requires 64-bit versions of these libraries.

Windows

Check out source code

>>> git clone https://github.com/heremaps/pptk.git <source_folder>

Create an empty build folder

>>> mkdir <build_folder>

Create an initial CMakeCache.txt under <build_folder> and use it to provide values for the CMake cache variables listed above. (e.g. see CMakeCache.win.txt)

Type the following…

>>> cd <build_folder>
>>> cmake -G "NMake Makefiles" <source_folder>
>>> nmake
>>> python setup.py bdist_wheel
>>> pip install dist\<.whl file>

Linux

Similar to building on Windows.

Mac

Similar to building on Windows.