Installation
Stable release (PyPI)
The preferred method for installing PyDarshan is to use pip to install stable releases directly from PyPI:
$ pip install darshan
PyDarshan releases on PyPI include manylinux and macOS binary wheels that simplify distribution of PyDarshan and its dependencies for most users. Note that these binary wheels are currently only available for x86 architectures.
From Spack
PyDarshan is also available within the Spack package manager.
$ spack install py-darshan
From sources
The sources for PyDarshan can be obtained as part of the Darshan Github repo, as shown below.
$ git clone https://github.com/darshan-hpc/darshan.git
$ cd darshan/darshan-util/pydarshan
Users can then use pip
to install the PyDarshan package from source.
$ pip install .
When building PyDarshan from sources, users need to make a copy of the darshan-util shared library available. On Linux systems, this is typically accomplished using LD_LIBRARY_PATH.
$ export LD_LIBRARY_PATH=/path/to/darshan/install/lib:$LD_LIBRARY_PATH
On macOS systems, DYLD_FALLBACK_LIBRARY_PATH should be used instead.
$ export DYLD_FALLBACK_LIBRARY_PATH=/path/to/darshan/install/lib:$DYLD_FALLBACK_LIBRARY_PATH
Refer to the darshan-util docs for details on how to install the shared library. PyPI- and Spack-based installs typically do not have to worry about this step on platforms for which we provide binary wheels. Note that PyDarshan requires a compatible darshan-util version (e.g., 3.4.2.x versions of PyDarshan requires a darshan-util version of 3.4.2).