Required packages

• h5cpp >= 0.5.0

• libpninexus >= 3.2.0

• python setuptools

• numpy

• c++ compiler

• boost-python library

• python sphinx to build the documentation

Install from sources

The code can be built with

$ python  -m pip install . -vv --no-deps --no-build-isolation

For those who are still running on the old interface it is maybe whise to install this package in a custom location with something like this

$ python -m pip install . -vv --no-deps --no-build-isolation --prefix=<path to installation prefix>

To build the documentation use

$ sphinx-build doc/sphinx build/sphinx/html

The resulting documentation can be found below build/sphinx/html in the root directory of the source distribution.

Finally, the package can be tested using

$ python -m pytest test

For Python3 just replace python with python3 in the above instructions.

Debian and Ubuntu packages

Debian trixie, bookworm, bullseye or Ubuntu resolute, noble, jammy packages can be found in the HDRI repository.

To install the debian packages, add the PGP repository key

$ sudo su
$ curl -s http://repos.pni-hdri.de/debian_repo.pub.gpg  | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/debian-hdri-repo.gpg --import
$ chmod 644 /etc/apt/trusted.gpg.d/debian-hdri-repo.gpg

and then download the corresponding source list, e.g. for trixie

$ cd /etc/apt/sources.list.d
$ wget http://repos.pni-hdri.de/trixie-pni-hdri.sources

or noble

$ cd /etc/apt/sources.list.d
$ wget http://repos.pni-hdri.de/noble-pni-hdri.list

respectively.

Finally,

$ apt-get update
$ apt-get install python3-pninexus

or

$ apt-get update
$ apt-get install python-pninexus

for python2.

Manylinux wheels from PyPI

To install pninexus in a conda or python virtual environment manylinux pip wheels can be used, e.g.

$ python3 -m venv myvenv
$ . myvenv/bin/activate

$ pip install pip --upgrade
$ pip install numpy

$ pip install pninexus -U wheel

For some versions of wheels numpy needs to be installed in advance.

Starting from v3.2.2 the pninexus wheel contains the most important external filters. In order to use them one needs to set HDF5_PLUGIN_PATH e.g. by

import pninexus

More information can be found at online documentation.

Changes for a specific version of libpninexus can be found at CHANGELOG.