Difference between revisions of "ALPS2.0:GettingStarted"

Revision as of 20:19, 1 August 2007

Downloading and Installing Subversion

You need:

• A Subversion client with SSL support
  • See http://subversion.tigris.org/project_packages.html
  • (on Mac OS X you can use e.g.: fink install svn-client-ssl)
  • (in kubuntu use: sudo apt-get install subversion)
  • you can also install subversion from the source:

 curl http://subversion.tigris.org/downloads/subversion-1.3.2.tar.gz | tar zxf -
  (optional) curl http://subversion.tigris.org/downloads/subversion-deps-1.3.2.tar.gz | tar zxf -
 cd subversion-1.3.2
 ./configure --with-ssl
 make
 sudo make install

• Have a look at ALPS subversion for dummies to get started.

Boost, Bjam and the like

• The boost libraries 1.35
  (presently this is the CVS head, go here for instructions how to access the CVS; during checkout use "boost" instead of "modulename")
• Now build boost jam, where in the last line operating-system should be copied from the output of the build, $BINDIR is the directory where you want to install the executable:

 cd boost/tools/jam/src
 sh build.sh
 (on MacOSX) install bin.operating-system/bjam $BINDIR
 (on Linux) cp bin.linuxx86/biam /usr/local/bin

• (NOT NEEDED) Next, build the boost binaries, where in the last line we assume you use the GNU compiler. In other cases, checkout here for the right toolset

 cd boost/
 bjam --toolset=gcc stage

ALPS SVN account

• Now, you must apply for an account to the ALPS subversion repository. Send your request via email to Emanuel Gull. After an account has been created for you (usually, Emanuel is very fast in doing so...), change your password here.
• You are now in the position to get the latest ALPS V1 svn-head, by using

 svn co --username your_user_name https://alps.comp-phys.org/svn/alps1/trunk/alps
 svn co --username your_user_name https://alps.comp-phys.org/svn/alps1/trunk/applications

• You may get the test repository:

 svn co --username your_user_name https://alps.comp-phys.org/svn/test_repository

You can also browse the sources just by pointing your web browser to these URLs. Important information for those users who took part in the Zurich workshop: the svn repository has been moved at the end of the workshop and the two trees ALPS and applications have both been merged into alps1.

• Setup BOOST_ROOT environment variable and user-config.jam

$ export BOOST_ROOT=/path/to/boost/directory
$ cat $HOME/user-config.jam
using gcc ; # on linux
using intel ; # on linux icc
using darwin ; # on MacOS
# The following leads to double definitions of the alps project; therefore I commented it out: 
# use-project alps : /path/to/alps/directory ;

• Then you can compile alps

$ cd /path/to/alps/directory
$ bjam

Documentation

• For the documentation, you need a few tools such as Doxygen and Boostbook, see http://www.doxygen.org and http://www.boost.org/doc/html/boostbook.html. We discuss how to get the CVS version of Doxygen and how to install it. We experienced problems with version 1.5.2 of Doxygen, but version 1.4.7 is fine as well.

$ cd $HOME
$ cvs -d:pserver:anonymous@cvs.planetsaphire.com:/cvsroot co -P doxygen
$ cd doxygen
$ ./configure
$ make
$ cp doxy* $BINDIR

where $BINDIR is your directory with executables.

• You have already downloaded Boostbook and you just have to run the setup script.

$ cd path/to/boost/tools/boostbook
$ sh setup_boostbook.sh

• you are ready now to install the ALPS documentation,

$ cd doc
$ bjam 

• The next topic is about concepts -- see http://www.boost.org/libs/concept_check/concept_check.htm -- and archetypes...

To be continued...