Note

The recommended way to install TRIQS on Mac OS X is through the Anaconda package

Prerequisites for the TRIQS Compilation on Mac OS X¶

Disclaimer¶

We here provide instructions on how to install the dependencies of TRIQS on Mac OS X in order to be able to compile TRIQS from source.

The installation of the scientific libraries that TRIQS depends upon (mpi, hdf5, boost, fftw, ipython, ….) is not as simple as in e.g. Debian/Ubuntu, where they are packaged with the distribution itself (i.e. “part of the system”).

This general problem of scientific computing on OS X is clearly illustrated by the large number of third-party attempts to provide “easy” installation of scientific libraries, such as brew, macports, fink, or the Enthought Python distribution.

In our experience, none of these solutions is perfect, nor complete or stable: they are still very far from the quality and stability of a Linux distribution like Debian/Ubuntu. It almost works, but at the end, there are some issues, sometimes severe, in the way scientific librairies are installed.

Moreover, because there is no notion of “distribution”, the versions of the libraries are always changing e.g. in brew. As a result, the installation instructions may work on one day, and suddenly stop to work the day after.

While this has a priori nothing to do with TRIQS and its applications, it clearly impacts its installation and usage. We are looking for a more robust solution to this OS X installation mess; help welcome !.

Installation of the dependencies¶

The following installation instructions are for Mac OS X 10.14.3 (Mojave) and should be executed on the terminal. They may work (possibly with some modifications) for earlier versions of OS X.

1. Install the XCode Command Line Tools:

xcode-select --install


and make sure the latest XCode SDK is set in your environment:

export SDKROOT=$(xcrun --show-sdk-path)  2. Install homebrew. If you already had homebrew installed consider running brew doctor to resolve potential conflicts before continuing. It can further be useful to remove duplicate packages with the command brew cleanup. 3. Install the required dependencies using homebrew: brew install cmake brew install boost brew install hdf5 brew install gmp brew install fftw brew install open-mpi brew install openblas brew install python  4. Install the required python packages: pip3 install --user --upgrade matplotlib pip3 install --user --upgrade mako pip3 install --user --upgrade numpy pip3 install --user --upgrade scipy pip3 install --user --upgrade mpi4py  5. We recommend using the clang compiler by default. The following command will install llvm together with the most recent clang compiler brew install llvm  As a next step we make sure the llvm installation is available in your environment and we set clang as the default compiler export PATH=/usr/local/opt/llvm/bin:$PATH
export LIBRARY_PATH=/usr/local/opt/llvm/lib:$LIBRARY_PATH export CC=/usr/local/opt/llvm/bin/clang export CXX=/usr/local/opt/llvm/bin/clang++  To make this choice permanent, add these lines to your $HOME/.bash_profile.

You should now be set to compile TRIQS from source.