-
Notifications
You must be signed in to change notification settings - Fork 0
Installing the IPython qtconsole in Mac OS X
I had a hell of a time getting the qtconsole for the new IPython 0.11 to work in Mac OS X, so I'm noting everything I did here. I did this all in Lion, but it should also work in Snow Leopard.
-
First, make sure that you do everything with the latest version of the system Python. This should be
/Library/Frameworks/Python.framework/Versions/2.7/bin/python2.7
.Make sure that this is 64-bit. You can check this by running
print '32-bit' if isinstance(int(2**42), long) else '64-bit'
in Python. You can also just run
python -c "print '32-bit' if isinstance(int(2**42), long) else '64-bit'"
. If it isn't 64-bit, download the 10.6/10.7 installer at http://www.python.org/download/. -
Now, you need to install IPython. A simple
pip install ipython
oreasy_install ipython
should do it. Alternately, you can download the source, or clone the git repo and install from that.Now, you have the new IPython. It will work with the terminal out of the box. You may want to play around with the new configuration (it should tell you about this the first time you start IPython).
To get the qtconsole, you need to install some dependencies.
-
First, you will need Xcode to compile some stuff. In Lion, just install it from the App store (note, this installs an installer, which you then need to run). I used Xcode 4, but this might also work with Xcode 3.
-
Next, you need to install QT. Install the QT Library (not the SDK) for Mac OS X from http://qt.nokia.com/downloads. If you installed the right one, there should now be a QT folder in
/Developer/Applications
. -
Here is the hard part: pyqt. Don't even try compiling this yourself; it won't work (or at least that's what I've been told; I haven't tried it since a few months ago when I was using Mac OS X 10.6, when it didn't work). You want to rather use homebrew to compile it for you (alternately, you can try manually applying the homebrew formula for it; I haven't tried this myself).
Install homebrew by running
/usr/bin/ruby -e "$(curl -fsSL https://raw.github.com/gist/323731)"
(see https://github.com/mxcl/homebrew/wiki/installation). This will guide you to do some stuff. If you have fink or macports installed, it will warn you. I have fink installed, and this all worked.
-
Now, install pyqt by running
brew install pyqt
. Make sure you extend yourPATH
as it tells you, or else Python won't be able to find it.Test that you have done this right so far by running
$ ipython qtconsole
If you did it right, it should tell you you need pyzmq. If it tells you you need pyside or pyqt, you didn't install pyqt correctly.
Now, to get pyzmq.
-
First, install zeromq. I compiled this from the master of the git repository. The tarball from http://www.zeromq.org/intro:get-the-software should work too. I think you need version 2, not 3.
Compile this using
./autogen.sh # you may not need this one if you use the tarball ./configure make make check sudo make install
Note that I had some errors when I did
make check
, but it doesn't seem to be a problem.You can also use homebrew. Do
brew install zeromq --universal
. I didn't do this, so I can't say if it works, though it should.7a. Supposedly,
easy_install pyzmq
will install both zeromq and pyzmq, so you can do that instead of this and the next step. I didn't do this, though, so I can't personally verify this. -
Now, get pyzmq. Again, you can go tarball or git.
pip
won't work because it builds from source and you need to specify the zmq path when you build (but you can try it).easy_install
might work. They didn't for me, though, which is why I installed it from git.8a. Note, if you use git, you will first need to install cython (you might as well use git for this too).
To build pyzmq, do
sudo python setup.py install --zmq="/usr/local"
. -
If you did this all right, you should now be able to use the qtconsole. Try
$ ipython qtconsole
If it works, the Python rocketship application should open, and a GUI window with a IPython shell should open up. This is the qtconsole!
-
./setup.py clean
doesn't work very well in most repositories (such as IPython). If you are using git, you can clean everything better usinggit clean -Xdn
first (this is a dry run), and thengit clean -Xdf
if you are OK with what it will delete. -
If you use fink, or for whatever reason have some other version of Python from the system one in your
PATH
, make sure you always explicitly call/Library/Frameworks/Python.framework/Versions/2.7/bin/python2.7
in all thesetup.py install
steps. If you installed something but it still can't find it, this is likely the culprit. Do a hard clean (see above) and try again. -
To use the qtconsole with SymPy, run
ipython qtconsole --profile=sympy
. This makes the qtconsole run similar to isympy.It's also supposed to use LaTeX for the math, though this hasn't been the case for me.See below for how to make LaTeX printing work. -
This is all just how I did it. Hopefully I didn't forget anything. Your milage may vary.
To get LaTeX printing for SymPy, you need matplotlib. This in turn requires numpy. So do
-
sudo pip install numpy
-
sudo pip install matplotlib
did not work for me. Rather, I had to clone the git repo and install from that
git clone git://github.com/matplotlib/matplotlib.git
cd matplotlib
sudo python setup.py install
You can test that the latex printing works by first cd'ing out of the matplotlib directory, and doing
ipython qtconsole --profile=sympy
and then typing something like
Integral(sin(1/x), x)
If this works, you should see something like
[\int \sin\left(\frac{1}{x}\right),dx]
(only it will look kind of crappy because matplotlib LaTeX rendering sucks).