Seg3D Pages

Web pages for Seg3D

View the Project on GitHub SCIInstitute/Seg3D

Table of Contents

Installing Seg3D from source

Compiler Requirements

At least C++11 64-bit compiler support is required.

Windows

The current source code must be compiled with the 64-bit version of Visual Studio 2013. Visual Studio 2015 support is coming soon. If building the installer using CPack, NSIS is required. The code has not been tested under Cygwin or MinGW compilers.

Mac OS X

The source code base was built with Xcode 5-7 as well as GNU Make and Ninja and works for both environments on OS X 10.8+. If building the installer using CPack, PackageMaker is required.

Linux

The code base has been tested for use with GCC, and this is the recommended compiler for linux. GNU Make and Ninja build systems can be used. Compiler must support C++11.

Dependencies

Qt

Seg3D 2.4 And Newer

Before building Seg3D, please make sure that Qt 5.9 has been installed on your system.

Windows

A typical Qt 5.9 build is as follows:

configure -platform win32-msvc2013 -no-gif -qt-libpng -qt-zlib -qt-libjpeg -no-openssl -skip qtwebengine -skip qtwebkit -D _BIND_TO_CURRENT_VCLIBS_VERSION=1 -debug-and-release -opensource -opengl desktop

Mac OS X

Qt binaries are available on the Qt website or can be built from source code.

Linux

Qt 5 static libraries are NOT supported. If building from source, ensure that the shared library build is enabled.

If building from source, use the following:

./configure -qt-xcb -qt-zlib -nomake examples -nomake tests -skip qtwayland -skip qtwebengine -skip qtwebkit -opengl desktop

Seg3D 2.0 to 2.3

Before building Seg3D, please make sure that Qt 4.7-4.8 has been installed on your system.

Windows

A Visual Studio binary build is available. To our knowledge the Windows Visual Studio development libraries are only available in a 32-bit version. A 64-bit version can be built from the source code download, configuring it as described on the Qt webpage. A typical Qt build is as follows:

configure.exe -platform win32-msvc2013 -no-gif -qt-libpng -qt-zlib -no-libmng -qt-libtiff -qt-libjpeg -no-openssl -no-phonon -no-phonon-backend -no-qt3support -D _BIND_TO_CURRENT_VCLIBS_VERSION=1 -debug-and-release -opensource

Mac OS X

Qt binaries are available on the Qt website or can be built from source code.

Linux

Qt is available from most package managers. Look for Qt 4.7-4.8.

CMake

CMake versions 2.8 - 3.4 are supported.

Compiling Seg3D

Once you have obtained a compatible compiler and installed Qt on your system, you need to download and install CMake (http://www.cmake.org) to actually build the software. CMake is a platform independent configuring system that is used for generating Makefiles, Visual Studio project files, or Xcode project files.

Once CMake has been installed, run CMake from your build (bin) directory and give a path to the CMake Superbuild directory containing the master CMakeLists.txt file.

You may build Seg3D with Ninja by adding the tag “-G Ninja” to your cmake command. Note: Mac users will have to install Ninja with Homebrew.

Seg3D 2.4 And Newer

CMake requires a path to the Qt 5 install directory. Typically, this directory will contain bin and lib directories. For example, for Qt installed on Mac OS X from the Qt 5 binaries on the Qt site:

cd bin

cmake -DQt5_PATH:PATH=/Users/test/Qt5.5.1/5.5/clang_64 ../Superbuild

If building on Linux, the path may be under /usr/lib or /usr/lib64.

The console version ccmake, or GUI version can also be used. Set the Qt5_PATH variable to the location of the Qt 5 installation.

After configuration is done, generate the make files or project files for your favorite development environment and build.

The build script can also be used:

./build.sh --qt5=/Users/test/Qt5.5.1/5.5/clang_64

The Seg3D application will be built in bin/Seg3D.

Seg3D 2.0 to 2.3

Running cmake on the command line:

cd bin

cmake ../Superbuild

Following the previous example, the Seg3D application will be built in bin/Seg3D.

The console version ccmake, or GUI version can also be used. You may be prompted to specify your location of the Qt installation. If you installed Qt in the default location, it should find Qt automatically.

After configuration is done, generate the make files or project files for your favorite development environment and build.

A bash build script (build.sh) is also available for Linux and Mac OS X to simplify the process. Usage information is available using the –help flag:

./build.sh --help

Optional Image Registration Tools

To build the optional python-based image registrations tools, the CMake option BUILD_MOSAIC_TOOLS must be turned on, either on the command line with the flag -DBUILD_MOSAIC_TOOLS:BOOL=ON, or in the console or GUI interfaces.

Seg3D Packages

Build the package target in Visual Studio or Xcode, or make package using GNU make on Mac OS X.

Seg3D Data

Seg3D sample data (also used in the tutorial) is available here.

Seg3D Support

For questions and issues regarding building the software from source, please email our support list: seg3d@sci.utah.edu