ALPS Project

Setup and Installation

Download

The latest version of the ALPS libraries can be downloaded from http://alps.comp-phys.org/ .

Supported Platforms and Compilers

The ALPS libraries have been tested on the following platforms and compilers:

Prerequisites

The ALPS libraries requires the source tree of version 1.32 or higher of the Boost C++ library, available at www.boost.org.
Note: it is only necessary to download and untar the Boost sources but no installation is necessary.

If support for additional features is desired, the following libraries are needed as well:

Installation

For easy setup, we have provided a configure script. Just type

./configure
in the top directory of ALPS source tree. The configure script accepts several command-line options. See Configure Options for details. After configuration, type
make
make install
to build and install all the header files, libraries, and tools. To compile example files, type
make examples
To compile and run test suites, type
make tests

Configure Options

In this section we explain important options for ALPS configure script. For complete list of options see the output of

./configure --help

Compiling User Applications

In order to develop and compile user applications on top of the ALPS libraries, user programs must include ALPS headers and be linked with ALPS libraries. ALPS header files are installed under PREFIX/include, where PREFIX is the path specified by the option to the configure script (see Configure Options). ALPS libraries are installed under PREFIX/lib. For example, you can compile and link your program as

CC -I/home/ALPS/include -L/home/ALPS/lib -o myprog myprog.C -lalps -lm
For parallel applications ppropriate linker flags for MPI should be appended (e.g. -lmpi). You should link the ALPS libraries exactly in this order. Otherwise you will have an error message from the linker.

Note that during the ALPS setup and installation, a script file named include.mk is also prepared and installed, in which useful macros for make (such as $(CPPFLAGS) and $(LIBS)) are predefined. By using this file, which is installed as PREFIX/share/alps/include.mk, you can write a simple makefile for your application, e.g.

include $(HOME)/ALPS/share/alps/include.mk
myprog : myprog.C
        $(CXX) $(CPPFLAGS) $(CXXFLAGS) -o myprog myprog.C $(LDFLAGS) $(LIBS)
  


copyright (c) 1994-2010 by Matthias Troyer

Distributed under the Boost Software License, Version 1.0. (See http://www.boost.org/LICENSE_1_0.txt)