My Mac OS X workstation was just updated to Lion and I had to reinstall Python and associated scientific tools for plotting, statistics etc. What a pain.
After many trial-and-error procedures I finally found a way to get a
scientific Python environment (Python + Scipy + iPython + Numpy + matplotlib) working correctly on Mac OS X Lion. I am reporting the steps I carried out hoping that it will help other people.
You will need a Python installation (in my example I use the one that comes by default with OS X), gfortran and Xcode. Here are the steps:
- Install the requirements: Xcode which includes Python (via App Store), gfortran (via Macports), virtualenv, additional libraries required by matplotlib
- Create a python environment with virtualenv
- Install Numpy, Scipy, matplotlib, ipython with pip. Install readline with easy_install
- Create an alias in .profile or .bash_profile (depending on your shell) to run ipython
After these steps are completed, you will get a working Python environment for scientific analysis, visualization and statistics with Mac OS X Lion.
Requirements
- Xcode
- Python 2.7, which comes pre-installed by default with OS X
- gfortran
- virtualenv
- additional libraries required by matplotlib (optional)
1. How to get the requirements working
gfortran
In my case, I installed it by installing
MacPorts and installing GCC which comes with gfortran:
sudo port install gcc44
To make gfortran visible to the system I created an alias in /usr/local/bin:
cd /usr/local/bin/
sudo ln -s /opt/local/bin/gfortran-mp-4.4 gfortran
virtualenv
I went to
web page that hosts virtualenv and downloaded virtualenv.py. You will use virtualenv.py below.
Additional libraries required by matplotlib (optional)
I use the graphical backend TkAgg,
which requires the following additional libraries for matplotlib to work: tk, freetype, libpng. I installed them using macports:
sudo port install tk
sudo port install freetype
sudo port install libpng
2. Create a python environment with virtualenv
Create a directory stdpy (in my example) somewhere and issue the command
/usr/bin/python virtualenv.py stdpy
to create an isolated python environment based on the python provided by default with Mac OS X. This avoids trouble with mixing libraries. Activate the environment by running
source stdpy/bin/activate
You should now see a (stdpy) showing up in your terminal.
3. Install Numpy, Scipy, matplotlib, ipython with pip and readline with easy_install
After activating the python environment, let's proceed and install the additional modules with pip and easy_install:
pip install numpy
pip install scipy
pip install matplotlib
pip install ipython
easy_install readline
You may need to install additional libraries in order to get matplotlib compiled, depending on the kind of graphical backend that you choose. In my case, I use TkAgg which depends on Tk, freetype and libpng libraries which I installed via macports.
4. Create an alias in .profile or .bash_profile (depending on your shell) to run python
In my case I use Bash and I added the following line to the file .bash_profile in my home directory:
alias ipy='source ~/stdpy/bin/activate && ipython --pylab'
Now, when I open the terminal and issue the command
ipy
it will automatically activate the python environment and run ipython.
Changelog:
- Aug. 18th 2012: added instructions about additional libraries in matplotlib
- Sep. 1st 2012: made explanation about matplotlib dependencies clearer (hopefully)
