How to build the DD package

The DD package is divided into two packages: otools and DD. The standard distribution contains them both. otools is a loose collection of a few useful classes that can also be used in standalone mode. DD is the proper DD package.

• Directory Structure
  You get a data, doc, inc and src file for the data, documentation, include files and source code. The data directory contains some data files (eg example configuration files). The Makefile produces the binaries in bin/OS.PROC.VER, where OS is the operating system (eg SunOS, IRIX), PROC the processor type (eg sparc) and VER the version. These variables are obtained from the unix command uname. The documentation is generated into the directory doc/html (for html files) and doc/tex (for the latex documentation). Java class files are put into the directory classes.

• setup.com file
  This files should be sourced before using the DD package. The user must adjust the environment variable DD_MAIN.

• Building the package
  The top directory contains a text file INSTALL.txt that guides you through the installation.

• flags.mk and rules.mk
  There are flags.mk and rules.mk in the DD and otools package that allow to define the correct flags and rules depending on the platform.

• Makefile
  The Makefile has a global flag PHENIX that should be set to zero if the code is built outside the PHENIX environment. Currently the only PHENIX specific item in the Makefile is the use of the PHENIX messaging system (module dd_phenix_msg.cc). Just make sure that this variable is commented out in your Makefile (package DD and otools).

• Exception handling
  The exception handling can be enabled or disabled depending whether the compiler directive -DDD_NOEXCEPTION is set.

• Documentation
  gmake documentation generates the documentation in html as well as tex (if latex and dvips are in the path).

• gmake clean and gmake distclean
  cleans the directory of the current platform (or all platforms).

• gmake distmake
  Creates a gzipped tar file of all the entire code (package DD and otools).

• test programs
  The Makefile for the DD and otools package also builds several test programs to test various code pieces. All test executables are in the bin directory and start with test_....

Alphabetic index Hierarchy of classes