Revision as of 08:17, 21 May 2010

Download ALPS 2.0

ALPS 2.0 comes as a single package containing both libraries and applications. Unless stated otherwise, the ALPS Libraries are distributed under the ALPS License version 2.0.

Releases

Prerelease versions

ALPS 2.0 is not yet released, but you can download nightly source snapshots and binary builds:

Nightly snapshots

Installing the binary releases

Installing the ALPS libraries and applications (MacOSX and Windows)

To install the binary releases for MacOS X and Windows just download the appropriate installer above and install it on your system.

Installing the ALPS libraries and applications (Debian GNU/Linux)

We make daily snapshot binary package for Debian GNU/Linux (sid). The following is the apt line.

deb http://alps.comp-phys.org/static/software/debian/sid ./
deb-src http://alps.comp-phys.org/static/software/debian/sid ./

Installing Vistrails and the ALPS Vistrails extensions

To use the full Python functionality or the Vistrails provenance system, download and install the latest version of Vistrails and then download install the appropriate ALPS Vistrails extension from the list above. This will install the ALPS packages into Vistrails and update your Vistrails installation to the latest pre-release version of Vistrails that is needed for ALPS.

Install Vistrails also if you just want to use the ALPS Python tools without Vistrails, since the binary packages have been compiled against the Python installation that comes with Vistrails.

Non-default install locations for the binary packages

If you install it in a non-default location you will have to

• set the environment variable ALPS_XML_DIR to point the the directory containing the ALPS XML and XSL files (the lib/xml subdirectory of the ALPS installation
• On MacOS X set the environment variable DYLD_LIBRARY_PATH to include the lib directory of the ALPS installation so that the dynamic libraries can be found.

Building ALPS from source on MacOS X and Unix

Libraries and tools needed to build ALPS

ALPS will need the following libraries and tools in addition to the ALPS sources:

• CMake version 2.8 or higher as a build system.
• Boost C++ Libraries version 1.41.0, 1.42.0, or 1.43.0
• HDF5 version 1.8.2 or higher.

Many of the applications will also need

• BLAS and LAPACK libraries

To use the evaluation tools you will need Python and some Python packages

• Python 2.5 or 2.6
• Numpy
• Matplotlib
• Scipy
• h5py

All these packages and tools can be installed from source. In the following we will give more instructions for packaged installations on various platforms.

The directed loop SSE code also needs

• LPSolve version 3.2 or 4.0, which can be downloaded here. Depending on your version of bison there might be a compilation problem with lp_solve. To solve this problem, comment out line 17 "extern int yyleng" of the file lpglob.h.

Get dependent libraries and tools on MacOS X using Mac Ports

• Get and install Mac Ports

• Install CMake either using the binary on http://www.cmake.org/ or using Mac Ports:

$ sudo port install cmake

• Install HDF5 1.8.2 or higher.

$ sudo port install hdf5-18

• If you want Python support without Vistrails install Python and scientific Python packages:

$ sudo port install py26-numpy py26-scipy py26-matplotlib py26-h5py python26
$ sudo python_select python26

Alternatively you can also just install the ALPS Vistrails extensions

• Download and unpack the Boost C++ Libraries library sources 1.41.0 or higher if you have not downloaded them with the ALPS sources. NOTE: just download and unpack but do not build Boost

Get dependent libraries and tools on CentOS 5.4 (should be identical with RHEL 5.4 and essentially all 5.* versions)

1. Make sure you have all the usual compilers installed. The following should pull in all required dependencies (including some libraries):

# yum install gcc-c++ gcc-gfortran

2. If you want to use the evaluation tools, you will need to install a newer version of Python than the provided 2.4. You can install from source or use an unofficial repository for binary RPMs. If you just want to run your compiled simulations, this is not required, but make sure you still have python headers:

# yum install python-devel

3. CMake 2.8.0 and HDF5 1.8 need to be installed from source since there are no packages in the standard repositories. You can however use the install scripts in the script directory to save some work.

4. More recent Boost packages are required. Use the ALPS package that includes them or get them separately.

5. If you don't have some version installed already, you will also need BLAS/LAPACK:

# yum install blas-devel lapack-devel

Get dependent libraries and tools on Ubuntu 9.10 karmic

1. CMake 2.8.0 and HDF5 1.8 need to be installed from source since there are no packages in karmic. It is easier with the next release (lucid), see below.

Get dependent libraries and tools on Ubuntu 10.04 lucid

Download ALPS with the Boost sources included, as Ubuntu 10.04 only ships with Boost 1.40. Install required packages (including python headers and libssl):

$ sudo aptitude install build-essential cmake-curses-gui libhdf5-serial-dev libfftw3-dev gfortran python-dev python-h5py python-numpy python-scipy python-matplotlib libssl-dev

If you don't have some BLAS/LAPACK installed already, also install these:

$ sudo aptitude install liblapack-dev

On Ubuntu, Vistrail is able to automatically install additional packages. If you however do not have administrative rights, you might need your administrator to install also the following packages:

$ sudo aptitude install python-qt4 python-qt4-gl python-qt4-sql python-vtk

Get dependent libraries and tools on Debian GNU/Linux (sid)

(2010/04/08) You can now create ALPS binary (except SSE, #68) without external source!

• Install build-essential package using apt. This will pull g++, make, etc.

$ sudo aptitude install build-essential

• Install CMake 2.8.0 or higher using apt.

$ sudo aptitude install cmake

• Install HDF5 1.8.2 or higher using apt.

$ sudo aptitude install libhdf5-serial-dev

• Install Boost C++ Libraries 1.41.0 or higher using apt. Note: Install libboost1.42-all-dev, NOT libboost1.42-dev.

$ sudo aptitude install libboost1.42-all-dev

• Install FFTW using apt.

$ sudo aptitude install libfftw3-dev

• Install Python and the needed packages h5py, numpy, ncipy and matplotlib using apt.

$ sudo aptitude install python-h5py python-numpy python-matplotlib python-scipy

• Install gfortran using apt for LAPACK/BLAS autodetection.

$ sudo aptitude install gfortran

Get some dependent libraries and tools from source using ALPS convenience scripts

We have provided some shell scripts that can simplify building some of the dependent libraries from source:

• Checkout the ALPS source from subversion. (assume e.g. at $HOME/src/alps2)
• Install CMake and HDF5 using scripts, building in $HOME/tmp and installing into $HOME/opt

$ $HOME/src/alps2/script/cmake.sh $HOME/opt $HOME/tmp
$ $HOME/src/alps2/script/hdf5.sh $HOME/opt $HOME/tmp

Build ALPS

• Create a build directory (anywhere you have write access) and execute cmake.

$ cmake /path/to/alps/directory

If you downloaded the Boost sources separately (and not with the ALPS sources) specify the root directory as follows:

$ cmake -D Boost_ROOT_DIR:PATH=/path/to/boost/directory /path/to/alps/directory

If you want to specify a different installation directory set the variable CMAKE_INSTALL_PREFIX

$ cmake -DCMAKE_INSTALL_PREFIX=/path/to/install/directory /path/to/alps/directory

If you want to link against a 64-bit LAPACK version turn the LAPACK_64_BIT option on in cmake by adding the option -D LAPACK_64_BIT=ON

• Optionally look at or edit the CMake configuration settings using the CMake GUI or ccmake. This lets you set include and library paths for libraries which cmake did not find automatically.

$ ccmake .

• Build and test ALPS

$ make 
$ make test
$ make install

Building Vistrails and ALPS Vistrails packages from source on Linux

Setting up ALPS-enabled Vistrails on Debian GNU/Linux (sid)

• Install python-qt4-gl and python-vtk using apt

$ sudo aptitude install python-qt4-gl  python-vtk

• Download the latest version of Vistrails from [1] -- 1.4.2 revision 1736 is *not* new enough, please use the nightly build.

• Go to your ALPS build directory

• Turn ALPS_INSTALL_VISTRAILS_PACKAGES on, either in the GUI or by running cmake initially as

 $ cmake -DALPS_INSTALL_VISTRAILS_PACKAGES =ON

• Set theCMake VISTRAILS_APP_DIR variable to point to the directory containing vistrails.

• Build and install ALPS. This will build both a full ALPS installation and install the ALPS Vistrails extensions into Vistrails

If you have problems...

f you've had previous versions of Vistrails installed, it might be confused by some old files in ~/.vistrails. Try renaming that folder and start again.

Advanced builds

Instructions for advanced build versions are available on the developer Wiki:

• Building from source on Windows https://alps.comp-phys.org/trac/wiki/AlpsOnWindows

• Building the documentation from source https://alps.comp-phys.org/trac/wiki/Documentation

• Building binary and source packages https://alps.comp-phys.org/trac/wiki/Packages

• Build using llvm https://alps.comp-phys.org/trac/wiki/LLVM

• Build Vistrails packages on MacOS and Windows https://alps.comp-phys.org/trac/wiki/AlpsVistrails

If you want to build the Python extensions against a non-standard Python installation set the CMake variable PYTHON_INTERPRETER to point to the Python interpreter you want to use