Conventions used in these Instructions

Special notes

Compiling the TIFF Libraries

Compiling the MPI Libraries

Compiling the Tcl Libraries

Compiling the Tk Libraries

Compiling the PIPT Libraries

CONVENTIONS USED IN THESE INSTRUCTIONS:

TOPDIR refers to the top-level directory in which the distribution was installed. This documentation assumes that the required packages (listed below) are at the directories listed below, but your site's configuration may be different; this will not hinder the installation process, but you should be aware of the difference.

	LAM:		TOPDIR/lam60
	PIPT:		TOPDIR/PIPT-2.1.2
	Tcl:		TOPDIR/tcl8.0
	TIFF:		TOPDIR/tiff-v3.4
	Tk:		TOPDIR/tk8.0

PREFIX refers to the directory prefix where libraries, binaries, and include files will be installed. For example, most sites use /usr/local as PREFIX, so that such files are installed into:

	/usr/local/bin
	/usr/local/lib
	/usr/local/include

"make install" for all of the required packages will copy the necessary binaries, libraries, and include files to these directories.

Since the PIPT may also be used in a heterogeneous cluster of workstations, we suggest that each package be installed on *each* architecture that is in the target cluster. Since the files need to be under a logical structure for ease of use in Makefiles, we suggest the following directory structure:

	/usr/local/ARCH/bin
	/usr/local/ARCH/lib
	/usr/local/ARCH/include

where ARCH is a representation of the destination architecture, such as "sun4", "rs6000", etc. For the installations below, we highly recomend that you use /usr/local/ARCH as the PREFIX of all the packages.

Using this strategy, when compiling PIPT applications, your Makefile only needs to have:

	ARCH		= sun4
	PREFIX		= /usr/local/$(ARCH)
	INCDIRS		= -I$(PREFIX)/include -I$(PREFIX)/h
	LIBDIRS		= -L$(PREFIX)/lib

This will include and link the all the proper include files and libraries, respectively (the $(PREFIX)/h directory is included because LAM [unexplicably] installs its include file there rather than to "$(PREFIX)/include").

NOTES:

The PIPT distribution includes a sample application driver which must be configured and compiled before it can be used. The sample driver requires that the Tcl/Tk, TIFF, and PIPT libraries have already been built. The installation instructions below walk through building of the libraries in the dependancy order necessary for building the final package, the sample driver.

Since we cannot make any assumptions about the destination operating environment for the PIPT and its associated packages, we have not included any compiled binaries; each package must be configured, compiled, and installed before usage. This is because several of the packages compile hard path names into their libraries which can only be determined on the target machine.

Unfortunately, it was not possible to maintain full backward compatibility with the (serial) IPT. Several modifications must be made to source code that currently uses the IPT before it can utilize the parallel functionality of the PIPT. Documentation for these changes is provided in man pages. To view these man pages, add TOPDIR/PIPT-2.1.2/man to the MANPATH environment variable in your. .cshrc file.

The distribution has been tested in a SunOS 2.4, Solaris 2.5.1, and Solaris 2.6 environment, and a Dec Alpha 4.0 environment. Since all communications use the MPI libraries, the PIPT itself could migrate to other environments. However, not all of the bundled packages would.

INSTALLATION

There are three subsystems to the PIPT: the TIFF, MPI, and PIPT libraries. The GUI interface to the sample driver program may optionally be compiled with two additional libraries: Tk and Tcl. The latest versions of all the freely available software has been included in this distribution (source code only). All the libraries must be configured, compiled and installed to include site-dependent configurations and directory structures.

To compile the TIFF libraries:

TOPDIR/tiff-v3.4:

For the tested environments, the provided configure will generate makefiles will be sufficient. For any other type of environment or problems with the installation, check the README file for installation instructions.

Execute the following commands:

	unix% cd TOPDIR/tiff-v3.4beta024
	unix% make ; make install

To compile the MPI libraries:

We have chosen to use the public domain LAM implementation of MPI. Although any other implementation will work as well, the instructions below and elsewhere in the PIPT documentation will refer to specific LAM procedures.

TOPDIR/lam61:

As mentioned above, the LAM distribution exists in the lam61 directory under the mpi directory because there are several public domain implementations of MPI available. If you ever choose to use another one, it should be installed under the mpi directory.

For a SunOS 4.1.3 environment, in the TOPDIR/lam61/Config subdirectory, the config file should already be linked to the proper source file (config.sun4_os). Edit this file and change the value of HOME to be PREFIX. The value of the CC macro (near the end of the file) *must* be an ANSI compiler, such as gcc. Change any other macros necessary. For more specific instructions (or any problems), see TOPDIR/lam61/doc/lam-install.html.

After the necessary changes have been made, the LAM/MPI package can be built with the following commands:

	unix% cd TOPDIR/lam61
	unix% make

The LAM binaries need to be in your path. The directory is PREFIX/bin. After LAM has been made, add this into your .cshrc (or other appropriate file).

To compile the Tcl libraries:

TOPDIR/tcl8.0:

The Tcl installation is largely automated. You will need to have X11 installed for it to succeed.

NOTE: The Tcl libraries are not necessary for the sample driver program. If you do not have X11 installed, you can skip building the GUI interface to the sample driver and only build the command-line interface. If this is the case, skip the instructions for building the Tk and Tcl libraries and proceed directly to the PIPT library instructions.

The following commands will build Tcl. For more specific instructions (for details on path overrides, etc.), see TOPDIR/tcl8.0/README.

	unix% cd TOPDIR/tcl8.0
	unix% ./configure --prefix=PREFIX
	unix% make ; make install

To compile the Tk libraries:

TOPDIR/tk8.0:

The Tk installation is largely automated. You will need to have X11 installed for it to succeed.

NOTE: The Tk libraries are not necessary for the sample driver program. If you do not have X11 installed, you can skip building the GUI interface to the sample driver and only build the command-line interface. If this is the case, skip the instructions for building the Tk and Tcl libraries and proceed directly to the PIPT library instructions.

The following commands will build Tk. For more specific instructions (for details on path overrides, etc.), see TOPDIR/tk8.0/README.

	unix% cd TOPDIR/tk8.0
	unix% ./configure --prefix=PREFIX
	unix% make ; make install

To compile the PIPT libraries:

TOPDIR/PIPT-2.1.2:

The PIPT libraries depend on having the MPI and TIFF libraries which should have already been built. The TOPDIR/PIPT-2.1.2/contrib directory contains a sample driver program which may be used with or without the Tk/Tcl libraries.

The LAM binaries (PREFIX/bin) *must* be in your path before attempting to compile the PIPT directories.

To compile the PIPT libraries and the sample driver program, execute the following commands:

	unix% cd TOPDIR/PIPT-2.1.2
	unix% ./configure --with-lam --prefix=PREFIX
	unix% make 

The following addition options may be specified on the "./configure" command line (order is not important):

        --prefix=PREFIX         Specify where to install the PIPT libraries,
                                and man pages
        --with-cc=CC            Specify the C compiler to use
        --with-lam=DIR          Specify the top level LAM directory
        --with-mpich=DIR        Specify the top level MPICH directory
        --with-mpidir=DIR       Specify the top level MPI directory
                                (i.e. not LAM and not MPICH)
        --with-mpiinc=SUBDIR    Specify the dir under MPIDIR where mpi.h
                                can be found.  Used if --with-mpidir is
                                not sufficient to describe where mpi.h
                                can be found
        --with-mpilib=SUBDIR    Specify the dir under MPIDIR where
                                libmpi.a can be found.  Used if
                                --with-mpidir is not sufficient to
                                describe where libmpi.a can be found
        --with-tcldir=DIR       Specify the top level directory where
                                include/tcl.h and lib/libtcl.a can be found
        --with-tiffdir=DIR      Specify the top level directory where
                                lib/libtiff.a can be found
        --with-tkdir=DIR        Specify the top level directory where
                                include/tk.h and lib/libtk.a can be found
        --with-notktcl          Do not build the optional GUI
                                interface to the sample driver program