CIBC:Seg3D:Documentation:Building

From SCIRun Documentation Wiki

These instructions are for building Seg3D on a OSX or Linux machine only.

• Prerequisites
  • You must have Subversion installed to download the Seg3D source code.
  • You must have a compiler (XCode on OSX, gcc on Linux)

From a terminal execute the following commands to get the last release target:

svn co https://code.sci.utah.edu/svn/SCIRun/cibc/tags/Seg3D-1.10.0

Alternatively to get the latest unstable development branch:

svn co https://code.sci.utah.edu/svn/SCIRun/cibc/trunk/SCIRun

This will take awhile to download the source code to your machine.

Next compile the source by typing the following:

cd Seg3D-1.10.0
./build.sh --seg3d-only --with-wxwidgets --get-cmake --cmake-args=-DWITH_MPEG=OFF -j2

If all goes well then the script should take care of the rest for you. It takes about an hour to build Seg3D on a modern machine, but your time may vary quite differently from the figure listed above. The '-j2' flag tells the machine to build with two concurrent jobs. If you have a multi-core processor, such as a Pentium Core Duo, run two jobs per core or gigabyte of memory, whichever is smaller.

Note that the build.sh script is only meant for the initial build. If you make changes to the Seg3D source code you can recompile it by just typing 'make' from the bin directory.

When the build is successful, you can find the Seg3D executable in the 'bin' directory. On OSX, an application bundle is built and the Seg3D executable is in the 'bin/Seg3D.app/Contents/MacOS/' directory.

To run on Linux:

cd bin
./Seg3D

To run on OSX:

open bin/Seg3D.app

On OSX, the Seg3D.app bundle can safely be moved anywhere on the machine and run from the Finder by double clicking the icon.

If you experience any errors. Please email them to Michael Callahan. I will try to fix them as quickly as possible.

Additional information on building Seg3D is available with the SCIRun building web pages.

• Compiling Seg3D - Follow the appropriate SCIRun build documentation to build Seg3D.
  • You'll need to build/install ITK - Seg3D requires the Insight Toolkit (ITK).