2 Installing CHARM++

You can install CHARM++ as either source code or a precompiled binary package. Downloading source code is more flexible, since you can choose the options you want; but a precompiled binary is slightly easier to get running.

You begin by downloading CHARM++ from our web site: http://charm.cs.uiuc.edu/download.html

Unpack CHARM++ using a tool capable of extracting gzip'd tar files, such as tar (on Unix) or WinZIP (under Windows). CHARM++ will be extracted to a directory called ``charm''. If you choose the source distribution, read the included ``charm/README'' file for detailed instructions on building CHARM++ from source.

The main directories in a CHARM++ installation are:

charm/bin

Executables, such as charmc and charmrun, used by CHARM++.

charm/doc

Documentation for CHARM++, such as this document. Distributed as LaTeX source code; HTML and PDF versions can be built or downloaded from our web site.

charm/include

The CHARM++ C++ and Fortran user include files (.h).

charm/lib

The libraries (.a) that comprise CHARM++.

charm/pgms

Example CHARM++ programs.

charm/src

Source code for CHARM++ itself.

charm/tmp

Directory where CHARM++ is built.

charm/tools

Visualization tools for CHARM++ programs.