Installing the binary releases

From ALPS
Jump to: navigation, search

Using the LiveALPS Linux distribution

To make your first steps with ALPS, without installing it to your system, the easiest way to proceed is using the LiveALPS Linux distribution.

Installing the binary releases on Mac OS X

Installing the ALPS applications and binaries

  • Download the appropriate binary installer from the download page.
  • Open the DMG file, and install by starting the package installer.

The ALPS applications and tools will be installed in /opt/alps. To easily find the ALPS binaries in your Terminal, you still need to set the correct PATH environment variable. The following command will add the correct settings to your ~/.profile configuration.

echo "export PATH=/opt/alps/bin:$PATH" >> ~/.profile

Additionally install Vistrails and Python tools (recommended)

The following steps are recommended to get the full Python functionalities and the Vistrails provenance system.

  • Download and install the latest version of Vistrails.
    For ALPS 2.2b3 please install Vistrails 2.1.2. For ALPS 2.1 you need Vistrails 2.0.1.
  • An X11 terminal is needed to run the plotting routines of Vistrails. You can for example download XQuartz.
  • Download and install the ALPS Vistrails module from the download page.

The ALPS Python libraries should now be reachable with

$ vispython
>>> load pyalps

In the Vistrails interface you can activate the ALPS modules from the Preferences (Vistrails menu). Click the "Module Packages" tab and enable vtlcreator, matplotlib and finally alps.

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 binary releases on Windows

Installing the ALPS applications and binaries

  • Download the appropriate binary installer from the download page.
  • Start the .exe installer.

The installation location is "C:\Program Files\ALPS" on Windows. If the installer wants to install into "C:\Program Files (x86)\ALPS", then you have chosen the 32 bit version of ALPS for a 64 bit version of Windows. While this works it is not recommended.

Note: 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.

Additionally install Vistrails and Python tools (recommended)

The following steps are recommended to get the full Python functionalities and the Vistrails provenance system.

  • Download and install the latest version of Vistrails.
    For ALPS 2.2b3 please install Vistrails 2.1.2. For ALPS 2.1 you need Vistrails 2.0.1.
  • Download and install the ALPS Vistrails module from the download page.

In the Vistrails interface you can activate the ALPS modules from the Preferences (in the Edit menu). Click the "Module Packages" tab and enable vtlcreator, matplotlib and finally alps.


Note: You will need to tell Vistrails where you have installed ALPS if you use a 64-bit version of Windows and have installed the 32 bit version of ALPS. 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)". However, we recommend installing there 64-bit version instead.

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

Installing the binary releases on GNU/Linux

Unfortunately there are no binary packages provided for Linux at the time. Please compile alps from source following the instructions given here.