Download and install ALPS 2

Revision as of 09:32, 7 January 2011 by Parcollet (talk | contribs) (Installing the ALPS libraries and applications (Ubuntu GNU/Linux))

Jump to: navigation, search

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 library license for libraries and ALPS application license for applications.


Release candidate

Important note: make sure to completely remove any previous ALPS-2 installation before installing the prerelease.

File Approximate size Architecture Type
alps-2.0.0rc5-r5354-src.tar.gz 20 MB all Source .tar.gz
alps-2.0.0rc5-r5354-src-with-boost.tar.gz 66 MB all Source .tar.gz

including the Boost library 1.45

alps-2.0.0rc5-macosx-10.6.dmg 35 MB MacOS X 10.6


.dmg (Mac bundle)
alps-2.0.0rc5-macosx-10.5.dmg 26.8 MB MacOS X 10.5+

32 bit (Intel)

.dmg (Mac bundle)
alps-2.0.0rc5-windows.exe 30 MB Windows XP, Vista, and 7

32 bit (i586)

.exe (WIndows installer)
alps-tutorials-2.0.0rc5-r5329-src.tar.gz 0.5 MB Unix line endings .tar.gz

ALPS tutorial input files

Prerelease versions

Nightly snapshots

Nightly snapshot Approximate size Architecture Type
alps-nightly-src.tar.gz 4.9 MB all Source .tar.gz
alps-nightly-src-with-boost.tar.gz 50 MB all Source .tar.gz

including the Boost library

alps-nightly-macosx-10.6.dmg 23 MB MacOS X 10.6


.dmg (Mac bundle)
alps-nightly-macosx-10.5.dmg 14 MB MacOS X 10.5+

32 bit (Intel)

.dmg (Mac bundle)
alps-vistrails-nightly-macosx-10.5.dmg 5.5 MB MacOS X 10.5+

32 bit (Intel)

.dmg (Mac bundle)

ALPS extensions to Vistrails

alps-nightly-windows.exe 19 MB Windows XP, Vista, and 7

32 bit (i586)

.exe (WIndows installer)
alps-vistrails-nightly-windows.exe 4.0 MB Windows XP, Vista, and 7

32 bit (i586)

.exe (WIndows installer)

ALPS extensions to Vistrails

alps-nightly-tutorials.tar.gz 6.8 MB Unix line endings Tutorials

Installing the binary releases

Using the LiveALPS distribution on Linux

To make your first steps with ALPS, using the LiveALPS Linux distribution may be the easiest way to proceed.

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. The installation location is /opt/alps on MacOS and "C:Program Files\ALPS" or "C:Program Files (x86)\ALPS" on Windows.

Note: on Windows make sure to select the option to add ALPS to the PATH when asked. If you forget to do so, this can still be done manually. Choose "Control Panel" --> "System" --> "Advanced" --> "Environment Variables" and add the path to the ALPS programs (e.g. C:\Program Files\ALPS\bin) to the PATH variable.

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. The latest snapshots from here will insall VisTrails and the ALPS packages.

Important note: get a nightly snapshot of Vistrails or the MacOS and WIndows installers from here.

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.

On Windows you will need to tell Vistrails where you have installed ALPS if you use a a 64-bit version of Windows or have not installed ALPS in the default location on the C drive. To do so, launch Vistrails and select Preferences from the Edit menu. Then click the "Module Packages" tab and enable the ALPS package. After enabling the ALPS package, select alps click configure and change the alpspath variable to point to your ALPS installation. On a 64-bit version of Windows this will most likely just be changing "Program Files" to 'Program Files (x86)".

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.

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

We make binary packages of official release/prerelease for Debian GNU/Linux (sid/amd64). The following is the apt line.

deb ./
deb-src ./

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

We make binary packages of official release/prerelease for Ubuntu GNU/Linux for 10.04 (lucid) and 10.10 (maverick). To use them :

  • Add the key for authentification (optional) :

curl | sudo apt-key add -

  • Add to /etc/apt/sources.list
    • for lucid (10.04)
    deb  lucid alps
    deb-src  lucid alps
    • for maverick (10.10)
    deb   maverick alps
    deb-src maverick  alps

NB :

  • The packages are in "/main(" section if you sort them by origin in synaptic.
  • ALPS2 requires a newer boost. We therefore provide a boost 1.45 package that replaces the standard 1.42 on lucid (which is therefore uninstalled).
  • ALPS2 is split in several packages : libraries, applications, doc, tutorials, etc... for static and dynamically linked version. The simplest is to install libboost1.45-all-dev and all *alps* packages except libalps2-dbg (for debugging only).

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:

Many of the applications will also need

  • BLAS and LAPACK libraries

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

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 tebd code requires a fortran compiler and that HDF5 be built with the --enable-fortran configure option.

Get dependent libraries and tools on MacOS X 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 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.43.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. This is not required if you just want to run your compiled simulations (c++ applications), but make sure you still have python headers (specify -DALPS_BUILD_PYTHON=OFF when invoking cmake):

# yum install python-devel

3. CMake 2.8.0 or later and HDF5 1.8 or later 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. See #Get some dependent libraries and tools from source using ALPS convenience scripts

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

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 other required packages (including python headers and libssl) using Synaptic package manager.

build-essential cmake-curses-gui libhdf5-serial-dev libfftw3-dev gfortran python-dev python-scipy python-matplotlib libssl-dev liblapack-dev

On Ubuntu, Vistrails 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:

python-qt4-gl python-qt4-sql python-vtk

Get dependent libraries and tools on Ubuntu 10.10 Maverick

Install required packages using Synaptic package manager.

cmake-curses-gui libboost-all-dev libhdf5-serial-dev libfftw3-dev gfortran python-matplotlib python-scipy python-h5py liblapack-dev

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 using apt. Currently, this pulls 2.8.2
$ sudo aptitude install cmake-curses-gui
  • Install HDF5 using apt. Currently, this pulls 1.8.4-patch1.
$ sudo aptitude install libhdf5-serial-dev
  • Install Boost C++ Libraries using apt. Currently, this pulls 1.42.0. Note: Install libboost-all-dev. libboost-dev is not sufficient!
$ sudo aptitude install libboost-all-dev
  • Install FFTW using apt.
$ sudo aptitude install libfftw3-dev
  • Install Python and the needed packages h5py, numpy, scipy 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/ $HOME/opt $HOME/tmp
$ $HOME/src/alps2/script/ $HOME/opt $HOME/tmp

Build ALPS

  • Create a build directory (anywhere you have write access) and execute cmake giving the path to the alps and to the boost directory:
$ cmake -D Boost_ROOT_DIR:PATH=/path/to/boost/directory /path/to/alps/directory

In this case the installation directory will be '/opt/alps'. If you want to specify a different installation directory set the variable CMAKE_INSTALL_PREFIX. Note that for the directory you specify here, you need to have writing-rights, therefore if you do not have the right to write to '/opt/alps' you need to give this option in any case:

$ 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. You may want to take a look at the descriptions of the relevant cmake options.
$ ccmake .
  • Build and test ALPS
$ make 
$ make test
$ make install

Notes for high performance computers

On HPC machines it might be nontrivial to configure and set up ALPS with the right combination of libraries. We thus provide setup configuration files for those machines where we have successfully installed ALPS and where the setup was nontrivial. More information can be found here

Notes for Unix Servers

On Unix servers you often do not have access to the root directory, and you cannot use the default directory to install HDF5 and Cmake. Here is an example on how to install Alps 2.0 on a server in which you have writing access only to your home directory (~/)

1. Download HDF5 and install into ~/opt

2. Download and install cmake into ~/cmake

3. Download the Alps sources into your home directory and expand them using "gunzip" and "tar -xrf". From the directory that you have just created execute:

> ../cmake-2.8.1/bin/cmake  -D BLAS_LIBRARY=/usr/lib64/ 
 -D LAPACK_64_BIT=ON  -D HDF5_LIBRARIES=/srv01/condgrp/huber/opt/lib/ 
 -D HDF5_INCLUDE_DIR=/srv01/condgrp/huber/opt/include/ ~/alps-2.0.0b1-r4556-src-with-boost/alps/

4. add the following line to the ~/.bashrc file

 export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/opt/lib to .bashrc

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 (git and unzip, too) using apt
$ sudo aptitude install python-qt4-gl python-vtk git unzip
  • Download the latest Vistrails sources from [1].
  • Go to your ALPS build directory
  • Turn ALPS_INSTALL_VISTRAILS_PACKAGES on, either in the GUI or by running cmake initially as
  • 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:

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

In case of problems

Should you have any questions or inquiries about the ALPS package, please don't hesitate to consult our mailing list:


若對於 ALPS 軟件有任何疑問或質詢 , 請閣下瀏覽我們的專用質詢電郵: