Skip to content

GraphBLAS/python-suitesparse-graphblas

Repository files navigation

python-suitesparse-graphblas

Version License Build Status Code style

Python CFFI Binding around SuiteSparse:GraphBLAS

This is a base package that exposes only the low level CFFI API bindings and symbols. This package is shared by the syntax bindings pygraphblas and python-graphblas.

Installation from pre-built wheels

Pre-built wheels for common platforms are available from PyPI and conda. These bundle a compiled copy of SuiteSparse:GraphBLAS.

pip install suitesparse-graphblas

or

conda install -c conda-forge python-suitesparse-graphblas

Installation from source

If you wish to link against your own copy of SuiteSparse:GraphBLAS you may build from source.

Specify the location of your SuiteSparse:GraphBLAS installation in the GraphBLAS_ROOT environment variable then use the standard pip build from source mechanism. This location must contain include/GraphBLAS.h and lib/.

export GraphBLAS_ROOT="/path/to/graphblas"
pip install suitesparse-graphblas-*.tar.gz

You may also have to appropriately set LD_LIBRARY_PATH to find libgraphblas at runtime.

For example, to use Homebrew's SuiteSparse:GraphBLAS on macOS, with the sdist from PyPI, and with all dependencies using wheels:

GraphBLAS_ROOT="$(brew --prefix suitesparse)" pip install --no-binary suitesparse-graphblas suitesparse-graphblas