macos_install.rst

Mac OS Installation

Some additional steps beyond the standard installation instructions may be required for certain Mac OS systems.

The steps detailed in this document have been tested for Mac OS 10.13.3.

Contents

1. Requirements
   1. Homebrew
2. Troubleshooting
   1. PyQtGraph
   2. Matplotlib

Requirements

The following packages are required in order to build PySAP:

1. gcc

Or any c/c++ compiler that supports OpenMP. (Note that the native Mac OS clang does not)

2. cmake

Homebrew

The above listed requirements can be readily installed on Mac OS using Homebrew.

$ brew install gcc cmake

Note that the commands gcc and g++ default to clang. Before installing PySAP you should export the environment variables CC and CXX.

e.g.

$ export CC="/usr/local/bin/gcc-7"
$ export CXX="/usr/local/bin/g++-7"

Troubleshooting

The following subsections propose solutions to some known issues.

PyQtGraph

Some issues may arise with regards to the installation of pyqtgraph. The easiest solution to this problem is to install the package using Anaconda.

$ conda install pyqtgraph

Alternatively see the PyQtGraph homepage for help.

Matplotlib

If you see the following error or something similar

**RuntimeError**: Python is not installed as a framework...

simply create a matplotlibrc file and specify a backend.

e.g.

echo "backend: Agg" >> ~/.matplotlib/matplotlibrc