Building From Source

Requirements

• Python 2.6 or 2.7 http://www.python.org
• Qt 4.6 (or above) Open Source Edition http://qt.nokia.com/downloads
• PyQt4 (v4.7 or above) http://www.riverbankcomputing.com/software/pyqt and SIP (4.10 or above) http://www.riverbankcomputing.co.uk/software/sip
• numpy (1.4 or above) http://www.numpy.org (scipy)
• scipy (0.7 or above) http://www.scipy.org (scipy)
• matplotlib (0.99 or above) http://www.scipy.org (scipy)

For running various not-required packages and features (packages are listed last, in parentheses):

• SUDS https://fedorahosted.org/suds/ (web services) optional patch
• MySQLdb http://sourceforge.net/projects/mysql-python (accessing databases)
• VTK (5.4.2 and above) http://www.vtk.org (vtk)
• matplotlib http://matplotlib.sourceforge.net/ (pylab)

Instructions

Click here for specific instructions for Mac OS X

• Install Python
  • On most Linux distributions it comes by default.
  • On Windows: Get the msi release 2.7.x here
  • Add the installation directory to the PATH variable

• Install Python Extensions
  • Install SUDS if you plan to use web services package
• Install VTK (if you need VTK - for infovis support install the development version)
  • First you'll need CMake: get the latest release here
  • Then you can get vtk: follow the instructions to download the source code on this page
  • (Skip this step if you don't need to run CORIE workflows) Follow these instructions to add CORIE and other needed files to VTK.
  • To compile VTK follow the instructions in the file README.html in the root of VTK directory tree
  • On configuring CMake, make sure that the variables VTK_WRAP_PYTHON, VTK_USE_GUISUPPORT, VTK_USE_DISPLAY are ON and VTK_USE_QVTK is OFF
  • It is recommended to create a environment variable called PYTHONPATH
    • PYTHONPATH=<path/to/vtk_build>/Wrapping/Python:<path/to/vtk_build>/bin:.
• For Linux only: Install Qt 4.6.3 or above (Qt 4.8.X recommended)
  • You can get the open source version for all platforms here
  • Run configure then make
• For Linux only: Install SIP
  • Downloads available here.
  • Uncompress the file, and inside the directory, type python configure.py. On 64-bit Linux type python configure.py -d /usr/lib64/python2.7/site-packages/. Then make and make install
• Install PyQt4
  • Downloads of the latest stable release and latest snapshots are available here.
  • Windows only: Download the binary package that contains everything you need to run PyQt4. This will install SIP and Qt for you.
  • For Linux only: Uncompress the file, and inside the directory, type python configure.py. On 64-bit Linux type python configure.py -d /usr/lib64/python2.7/site-packages/. Then make and make install

• Install MySQLdb (Python library allowing MySQL databases access)
  • The file is available here
• Install SciPy
  • Windows
    • First download and install NumPy and then SciPy
  • Linux
    • Download and install BLAS [1] - Note: Most package managers allow easy download and installation through the native interface however; you must also get the source code and set the environment variable BLAS_SRC
    • Download and install LAPACK [2] - Note: Most package managers allow easy download and installation through the native interface however; you must also get the source code and set the environment variable LAPACK_SRC
    • Download and install numpy [3]
    • Download and install scipy [4]
• Install matplotlib
  • Windows
    • Get it here
  • Linux
    • Files are available here

• To run VisTrails from source:
  • Excute this on a terminal window or on a command prompt on Windows:

 cd /path/to/vistrails_src
 python vistrails/run.py