This is a short procedure to install Dionysus 2 on OS X written for people who aren’t necessarily comfortable installing C++ libraries and the like.
We’ll install:
the C++ compilers and some tools to help manage things.
cmake- which Dionysus uses to build it’s C++ library.boost- which Dionysus uses to expose an API in the Python programming language.
Compilers and tools
First let’s make sure you have all the compilers installed.
xcode-select --installThis will either prompt ask you to agree to the license agreement and download the appropriate package or, if you already have things installed, display a message like this:
xcode-select: error: command line tools are already installed, use “Software Update” to install updates.
Once you have the compilers installed you can use Homebrew to install the other tools and libraries. Homebrew is a package manager which can install many common open source packages on OS X.
If you already have the brew command (run it on a Terminal and see!)
you can skip ahead. If not, open Terminal.app and follow the
instruction in the Install Homebrew section of
the Homebrew website.
Installing Dionysus and dependencies
Dionysus depends on cmake and boost-python. You can install them
both with brew install.
brew update
brew install cmake
brew install boost-pythonNow with the dependencies installed you should be able to install Dionysus with the normal Python installation tools:
pip install dionysusMaking sure it works
You should now be able to run the python command to get a Python
prompt and run the import dionysus statement as described in the
Dionysus tutorial:
[thsutton@laptop TDA]$ python
Python 2.7.10 (default, Oct 23 2015, 19:19:21)
[GCC 4.2.1 Compatible Apple LLVM 7.0.0 (clang-700.0.59.5)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import dionysus
>>> print dionysus.__version__
2.0.4
>>> exit()
[thsutton@laptop TDA]$ pythonInstalling Dionysus version 1.0 is quite a bit more fiddly. If you find these instructions helpful, I would suggest just using version 2.0 as installed here.