Building SCIRun

  1. Run SCIRun's configure script. Do this from a sub-directory of directory SCIRun (but not SCIRun/src) as follows:

    mkdir SCIRun/build-dir
    cd SCIRun/build-dir
    
    ../src/configure --with-thirdparty=third-party-dir \
    --enable-package="package-name1 package-name2 …"
    	

    in which case SCIRun is built in the directory SCIRun/build-dir.

    Build-dir is often bin or a name that reflects the machine architecture.

    Above, replace third-party-dir by the path given to the third-party installation script.

    Replace "package-name1 package-name2 …" by a list of package names, e.g. "BioPSE MatlabInterface". An example configure command is:

    ../src/configure \
    --with-thirdparty=/usr/local/SCIRun/Thirdparty_osx \
    --enable-package="BioPSE MatlabInterface" \
    --with-png=/sw
    	

    Option --with-png is needed if PNG support is desired and PNG libraries are not in /usr/lib. Option --with-png above tells SCIRun to find PNG libraries in /sw's lib directory.

    Use option --with-unipetsc to add support for PETSc. For example:

    ../src/configure \
    --with-thirdparty=/usr/local/SCIRun/Thirdparty_osx \
    --enable-package="BioPSE MatlabInterface" \
    --with-unipetsc=/usr/local/petsc \
    --with-png=/sw
    	

    Use option --with-insight to add support for Insight. Packages Teem and Insight must also be enabled when using --with-insight. For example:

    ../src/configure \
    --with-thirdparty=/usr/local/SCIRun/Thirdparty_osx \
    --enable-package="BioPSE Teem Insight" \
    --with-insight=/usr/local/lib/InsightToolkit \
    --with-png=/sw
    	

    Use option --with-hdf5 to add HDF5 support. Use option --with-mdplus to add MDSplus support. Also enable packages Teem and DataIO. For example:

    ../src/configure \
    --with-thirdparty=/usr/local/SCIRun/Thirdparty_osx \
    --enable-package="Fusion Teem DataIO" \
    --with-hdf5=/usr/local/hdf5 \
    --with-mdsplus=/usr/local/mdsplus \
    --with-png=/sw
    	

    Support for TrueType (scalable anti-aliased) fonts in PowerApp BioImage and module ViewSlices is enabled with option --with-freetype=path-to-freetype-lib-directory. Path-to-freetype-lib-directory is the path to a directory containing freetype2 libraries, for example /sw/lib. Option --with-freetype is not needed when freetype2 libraries exist in /usr/lib.

    Not all of configure's options have been mentioned. Running configure --help lists them all.

  2. Run GNU make from build-dir.

    cd build-dir
    make
    	

    Be sure that make invokes GNU make. GNU make is sometimes named gmake or gnumake.

    For a multiprocessor system GNU make's -j option can be used to reduce the build time:

    make -j N
    	

    where N is the number of processors available for use by make. Using this option on a multiprocessor machine can significantly reduce the time to build SCIRun.

After a successful build, build-dir will contain the scirun and PowerApp executables.

Tip

It is possible to build SCIRun for multiple machine architectures and multiple sets of configure options within the same source code directory. See Appendix B, Single Source, Multiple Binaries for details.

Read “Before Starting SCIRun” before starting SCIRun.