Building Internal Third Party Software

Internal third party software is distributed with SCIRun and is required for SCIRun to run properly. It must be built before building SCIRun. This section provides instruction for building internal third party software.

Note

Python (version 1.5.2 or later) and GNU make (version 3.79 or later) must be present to proceed with source installation.

Follow these steps to build the internal third-party distribution:

  1. cd to the third-party software directory:

    cd Thirdparty_install.x.x.x
    	

  2. Optional: Enable PNG support in the Teem third party library. To enable PNG support in the Teem third party library set the TEEM_ZLIB and TEEM_PNG environment variables:

    For sh-type shells:

    TEEM_ZLIB=1
    TEEM_PNG=1
    export TEEM_ZLIB TEEM_PNG	
        

    for csh-type shells:

    setenv TEEM_ZLIB
    setenv TEEM_PNG
        

    If these variables are not set, PNG support will be omitted.

    If PNG support is enabled and PNG libraries (and corresponding header files) are not installed in a standard location (/usr/lib) then environment variables TEEM_PNG_IPATH and TEEM_PNG_LPATH must be set. For example, if PNG libraries and headers are installed in /usr/local then TEEM_PNG_IPATH and TEEM_PNG_LPATH are set as follows:

    For sh-type shells:

    TEEM_PNG_LPATH=-I/usr/local/lib
    TEEM_PNG_IPATH=-I/usr/local/include
    export TEEM_PNG_LPATH TEEM_PNG_IPATH
        

    for csh-type shells:

    setenv TEEM_PNG_LPATH -I/usr/local/lib
    setenv TEEM_PNG_IPATH -I/usr/local/include
        

    If ZLIB libraries (and corresponding header files) are not installed in a standard location (/usr/lib) then environment variables TEEM_ZLIB_IPATH and TEEM_ZLIB_LPATH must be set. For example, if ZLIB libraries and headers are installed in /usr/local then TEEM_ZLIB_IPATH and TEEM_ZLIB_LPATH are set as follows:

    For sh-type shells:

    TEEM_ZLIB_LPATH=-I/usr/local/lib
    TEEM_ZLIB_IPATH=-I/usr/local/include
    export TEEM_ZLIB_LPATH TEEM_ZLIB_IPATH
        

    for csh-type shells:

    setenv TEEM_ZLIB_LPATH -I/usr/local/lib
    setenv TEEM_ZLIB_IPATH -I/usr/local/include
        

  3. Run the third party installation script.

    The simplest script invocation requires a single argument:

    python install dir
    	

    where dir is the location you wish to install the third-party installation.

    The installation script takes additional optional arguments:

    python install dir bits jobs
    	

    dir is the third-party installation directory. bits is either 32 or 64 and specifies one of 32 bit or 64 bit binaries. jobs is the number of processors availabe for make's use when building the software. For example:

    python install /usr/local/SCIRun/Thirdparty 64 2
    	

    or

    python install /usr/local/SCIRun/Thirdparty 32 1
    	

    When finished, the installation script displays the complete path of the third-party software installation directory. Make note of this value, it is used in the configure step of the SCIRun build process described in “Building SCIRun”.

The complete path name of the third-party installation directory reflects the parameters given to the install script. This allows the user to maintain multiple third-party installations for different operating systems and machine architectures. For example, on a Linux machine, the installation command:

python install /usr/local/SCIRun/Thirdparty

    

creates the installation under:

/usr/local/SCIRun/Thirdparty/1.8/Linux/gcc-3.2-32bit

    

All, or part, of the third-party software may be reinstalled by repeating the install command line. The script asks for a y or n response to each tarball in the distribution. Answer y to reinstall.

Proceed to “Building External Thirdparty Software”.