This file contains the instructions for building and running RegistrationShop on OS X, Linux and Windows. For Linux/Ubuntu, there is a more extended guide in the file INSTRUCTIONS_UBUNTU.md which describes every step needed for installing and running RegistrationShop on a fresh install of Ubuntu.
Please install Elastix by downloading it here. Binaries are available for all platforms. Make sure that it is reachable from your path. So you should be able to just run:
elastix --help
Install pyyaml and pyside by running the following on OS X and Linux:
pip install -U pyyaml
pip install -U PySide
You might have to install qt before being able to install PySide by running:
brew install qt # OS X
On Windows:
- Install Python 2.7
- Install PyYaml (packages available at http://pyyaml.org/wiki/PyYAML)
- Install PySide (http://wiki.qt.io/PySide_Binaries_Windows)
python pip install -U PySide
Download VTK at https://github.com/berendkleinhaneveld/VTK/tree/release and build with Cmake and make sure that Python wrappings are on. Please make sure you download the zip file instead of cloning the repo, because the wrong branch is checked out.
After building VTK successfully, make sure you have the following system variables and make sure that they contain the following paths:
On OS X (add to ~/.profile) and Linux (add to ~/.bashrc):
# Add Elastix folder to PATH
export PATH=/path/to/elastix/bin:$PATH
# Specify VTK build folder
export VTK_DIR=/path/to/vtk/build/folder
export PYTHONPATH=$VTK_DIR/bin:$VTK_DIR/lib:$VTK_DIR/Wrapping/Python:$PYTHONPATH
export PATH=$VTK_DIR/bin:$VTK_DIR/Wrapping/Python:$VTK_DIR/Wrapping/PythonCore:$PATH
export LD_LIBRARY_PATH=$VTK_DIR/bin:$LD_LIBRARY_PATH
On Windows:
VTK_DIR:
{VTKBUILDDIR}\bin\Release
PYTHONPATH:
{VTKBUILDDIR}\Wrapping\Python
{VTKBUILDDIR}\Wrapping\Python\vtk
{VTKBUILDDIR}\bin\Release
PATH:
{VTKBUILDDIR}\bin\Release
C:\Python27
Note: it might be that not all paths are needed, but at least this configuration should work.
Download RegistrationShop at https://github.com/berendkleinhaneveld/Registrationshop.
You should now be able to run:
python RegistrationShop.py
Please send an email or open an issue if you have troubles with any of these steps: I'm happy to help out!