The latest version of the ALPS libraries can be downloaded from http://alps.comp-phys.org/ .
The ALPS libraries have been tested on the following platforms and compilers:
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:
For easy setup, we have provided a configure script. Just type
in the top directory of ALPS source tree. The configure script accepts several command-line options. See Configure Options for details. After configuration, type./configure
to build and install all the header files, libraries, and tools. To compile example files, typemake
make install
To compile and run test suites, typemake examples
make tests
In this section we explain important options for ALPS configure script. For complete list of options see the output of
./configure --help
Option |
Description |
--prefix=PREFIX |
Install the files in PREFIX. The default value is $HOME/ALPS. The headers, libraries, and tools are installed in PREFIX/include, PREFIX/lib, and PREFIX/bin, respectively. |
--with-compiler=MODE |
Specify C/C++ compiler. Currently gnu, kai, intel, intel64, como, hp32, hp64, dec, sgi32, sgi64, cray, macos, macos-gnu-3.3, macos-gnu-4.0, and generic are accepted for MODE. The default value for MODE is generic. |
--with-boost=DIR |
Specify the place where the Boost C++ library main tree is installed. By default configure script will search $HOME/boost, $HOME/src/boost, PREFIX/boost, and PREFIX/src/boost, /usr/local/boost, and /usr/local/src/boost. |
--with-boost-incdir=DIR |
Specify the place where the Boost header files are installed, in case you have a precompiled Boost C++ library. |
--with-boost-libdir=DIR |
Specify the place where the Boost library (eg. libboost.a) is installed, in case you have a precompiled Boost C++ library. |
--with-boost-libs=LIBS |
Specify Boost C++ libraries (eg. -lboost_date_time -lboost_filesystem) to be linked, in case you have a precompiled Boost C++ library. |
--with-boost-toolset=TOOLSET |
Specify Boost toolset abbreviation, eg. gcc-d for gcc with debugging, il-mt for intel-linux with multi-threading etc, in case you have a precompiled Boost C++ library. For more details, please see http://www.boost.org/more/getting_started.html#Results. |
--enable-boost-config |
Use Boost user configuration header file generated by Boost configure script. By default ALPS configure script does not run Boost configure script and thus does not use Boost user configuration header. Try this option in case you have a problem with default Boost configuration. |
--disable-optimization |
Disable optimization flags passed to the C++ compiler, and generate a non-optimized version of libraries containing additional symbol information for debugger. By default optimization is enabled. |
--disable-exceptions |
By default the library is build with exception handling. This option disable exception handling. |
Normally configure script will automatically find optional libraries (MPI, HDF5, etc) installed in your system. However, if these libraries are installed in the places different from usual ones, you must specify them by the following options.
Option |
Description |
--with-mpi=DIR |
Specify the place where MPI is installed. MPI headers (eg. mpi.h) and libraries (eg. libmpi.a) are assumed to be installed in DIR/include and DIR/lib, respectivly. |
--with-mpi-incdir=DIR |
Specify the place where MPI headers (eg. mpi.h) are installed. |
--with-mpi-libdir=DIR |
Specify the place where MPI libraries (eg. libmpi.a) are installed. |
--with-mpi-libs=DIR |
Specify MPI libraries (eg. -lmpi) to be linked. |
--without-mpi |
Disable MPI support. |
--with-hdf5=DIR |
Specify the place where HDF5 is installed. HDF5 headers (eg. hdf5.h) and libraries (eg. libhdf5.a) are assumed to be installed in DIR/include and DIR/lib, respectivly. |
--without-hdf5 |
Disable HDF5 support. |
--with-expat --with-expat=DIR |
Use Expat XML parser. Headers (eg. expat.h) and libraries (eg. libexpat.a) are assumed to be installed in DIR/include and DIR/lib, respectivly, if DIR is specified. |
--with-xerces --with-xerces=DIR |
Use Xerces C++ XML parser. Headers (eg. xercesc/parsers/SAXParser.hpp) and libraries (eg. libxerces-c.a) are assumed to be installed in DIR/include and DIR/lib, respectivly, if DIR is specified. |
--with-pthread |
Enable pthread support. |
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
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.CC -I/home/ALPS/include -L/home/ALPS/lib -o myprog myprog.C -lalps -lm
Note that during the ALPS setup and installation, a script file
named
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)