Installation Guidelines

Dependencies

NIXPy is a reimplementation of the NIX library and file format for Python. Since NIX is built upon HDF5, NIXPy depends on h5py, the Python interface to the HDF5 data format.

NIXPy can also be used as an interface for the original NIX library. NIX is therefore an optional dependency, if NIXPy is to be used in this mode.

The installation instructions below describe how to build or install NIXPy as a standalone, pure Python version of NIX. To use NIXPy as a Python interface for NIX, see the advanced installation instructions.

Dependencies:

Optional dependencies (see advanced installation instructions):

Installation instructions

The latest stable release of NIXPy is available on PyPi as nixio. Therefore, the simplest way to install NIXPy is to use pip:

pip install nixio

Advanced installation

To use NIXPy as a Python interface for the NIX library it is necessary to install the NIX library before you can install or build NIXPy on your system. The following two sections explain how NIX can be installed on Windows and Linux.

Linux

If you use the latest Ubuntu LTS you can install NIX from our PPA on launchpad. First you have to add the PPA to your system:

sudo add-apt-repository ppa:gnode/nix
sudo apt-get update

Afterwards you can use apt to install the NIX package:

sudo apt-get install libnix-dev

If you want to use NIX on other distributions you have to compile and install NIX from source (see below).

Windows

To install NIX under Windows it is recommended to use the latest installer. The installer can be downloaded from the nix releases on GitHub.

Build NIX from Source

In order to build and install NIX from source please follow the build instructions in the NIX repository. Comprehensive build instructions for Linux can be found in the nix README.rst. For Windows this information can be found in the nix Win32.md file.

Install NIXPy

Once the NIX library is installed on your system you can proceed with the installation of the python bindings.

Compatibility

The NIX library as well as NIXPy undergo continuous development and improvement. Although most changes do not affect the NIX API, the compatibility between the NIX library and their bindings might still break from time to time. Therefore it is worth mentioning which assumptions can be made concerning compatibility between versions of the NIX projects.

  • The head of the master branches of the NIX library and the bindings are usually compatible to each other.
  • Nix releases of the same version and their corresponding tags in the repositories are always compatible with each other e.g. NIXPy 1.0.x is compatible with libnix 1.0.x etc.

Linux

If you use the latest Ubuntu LTS you can install NIXPy the same was as shown above for NIX from our PPA on launchpad. If the PPA was not already added to your system, you can do so by executing the following commands::

sudo add-apt-repository ppa:gnode/nix
sudo apt-get update

Once the PPA was added NIXPy can be installed via apt-get:

sudo apt-get install python-nix

If you want to use NIXPy on other distributions, please follow the instructions for building NIXPy from source (see below).

Windows

To install NIXPy under Windows it is recommended to use the Windows installer. Download the installer with the same version as your NIX installation from the NIXPy releases and execute the installer. In addition NIXPy requires numpy to be installed.

Build NIXPy from Source

If you want to use the latest development version or in cases where the provided installers or packages can’t be used, it is possible to build and install NIXPy from sources. Instructions for building NIX on Linux can be found in the NIXPy README.rst file. For the Windows platform those instructions are described in the NIXPy Win32.md file.