How to build proteusGraphical

proteusGraphical is a Python package that connects the data structures in proteus to vtk and provides a simple GUI for displying the solutions as they are being computed. It relies on the Qt user interface framework, the PyQt bindings to Qt, and VTK, all of which need to be installed.

1. Download and install the Qt libraries for your system from http://qt.nokia.com. You don't need the Qt SDK.
2. Download the latest release of sip and PyQt into $PROTEUS/externalPackages and name the directories 'sip' and 'pyqt'
3. Do 'make install_ipython'. That command will build sip, pyqt, matplotlib, ipython, and several more dependencies
4. Download ParaView with git clone --recursive git://paraview.org/ParaView.git
5. Download and install cmake from http://cmake.org/
6. Configure, build and and install Paraview. This is tricky, and I can't figure out a way to automate it. The basic ide is to turn on vtk, python wrappers, parallel support, and qt. Here are some heuristics:

• BUILD_SHARED_LIBS:BOOL=ON
• CMAKE_INSTALL_PREFIX:PATH= set to $PROTEUS_PREFIX so you can install without root
• MPIEXEC:FILEPATH= set to your mpiexec
• MPI_CXX etc., make sure they all point to the right mpi compilers, include, lib dirs, cmake gets this stuff wrong sometimes
• CMAKE_OSX_ARCHITECTURES:STRING= e.g. x86_64,
• CMAKE_OSX_DEPLOYMENT_TARGET:STRING= e.g. 10.6, 10.7
• PARAVIEW_ENABLE_PYTHON:BOOL=ON
• PARAVIEW_ENABLE_PYTHON_FILTERS:BOOL=ON
• PARAVIEW_INSTALL_DEVELOPMENT:BOOL=ON
• generally search on python variables, cmake often gets these wrong, here's how they should look on a mac
• PYTHON_EXECUTABLE:FILEPATH=/Users/cekees/proteus/darwinclang/Library/Frameworks/Python.framework/Versions/Current/bin/python
• PYTHON_INCLUDE_DIR:PATH=/Users/cekees/proteus/darwinclang/Library/Frameworks/Python.framework/Headers
• PYTHON_LIBRARY:FILEPATH=/Users/cekees/proteus/darwinclang/Library/Frameworks/Python.framework/Versions/Current/lib/libpython2.7.dylib
• QMake --set this to the qmake you installed, probably /usr/bin/qmake, it will set the rest of the qt libs/
• sip and pyqt --also tricky, here's the way the look on a mac
• SIP_EXECUTABLE:FILEPATH=/Users/cekees/proteus/darwinclang/Library/Frameworks/Python.framework/Versions/Current/bin/sip
• SIP_INCLUDE_DIR:PATH=/Users/cekees/proteus/darwinclang/Library/Frameworks/Python.framework/Headers
• SIP_PYQT_DIR:PATH=/Users/cekees/proteus/darwinclang/Library/Frameworks/Python.framework/Versions/Current/share/sip/PyQt4
• VTK_WRAP_PYTHON_SIP:BOOL=ON

7. cd $PROTEUS/proteusExtensions/proteusGraphical
8. python setup.py install