I have written a downloader and installer for QDP++ to help the students install it on their laptops. The script works on My Wife's machine under the Cygwin I installed, and also seems to work on the Linuxen at the JLab which are appropriately set up (ie libxml2-devel package is installed). It would be good to check on a Mac (Kostas can you run it maybe?)

There are some user editable features of the script at the start, but by default it builds QDP++ with no processor specific optimisations and installs it into the users homedirectory under $HOME/install/qdp++

It then tries to compile the plaquette test program to give a vague check that the build succeeded.

I am attaching it as a .tar.gz file, so hopefully the various attachment filters don't chomp it off.

download.tgz

The attachment should be saved. and untarred.

Eg: "Save As" "download.tar.gz"
then go to where it is saved and type

gunzip download.tgz
tar xf download.tar

You should be left with a script called download.sh

You should read over this script and potentially edit the user variables at the start. Each one has severla lines of comment in front of it. They are

INSTALL_ROOT=$HOME/install/qdp++
Change this to point to a different install dir if you need

CXX=g++
Change this if your gcc/3.4.x compiler's g++ is called something
other than g++ (eg g++34 or g++-3.4)

CC=gcc
change this if your gcc/3.4.x compiler's gcc is called something
other than gcc (eg gcc34 or gcc-3.4)

STARTDIR=`pwd`
the directory in which you run the script. Don't change this

BUILDDIR=${STARTDIR}/build
the directory into which the download will go and the building
will take place in. Change this if you want the building to
be done somewhere else (or don't change it just move the script)

WGET=wget
the wget program

GUNZIP=gunzip
- this is there because some versions of tar don't support the z option
to also uncompress should be no need to change it.

TAR=tar
- the tar command - should be no need to change it

MAKE="make -j 4"
- the GNU make command. Change this if your GNU make is something else like gmake. The -j 4 option should speed up the build on a fast machine by building 4 things at once. You can throttle this down to -j 2 on a slower machine or just remove the -j option altogether.

ACLOCAL, AUTOMAKE and AUTOCONF
these are used to make makefiles (Makefile.in)s. On a Cygwin system they should be OK as they are. On Linuxen there can be several of these eg automake-1.6 automake-1.9 etc. In the end I ended up not using these so leaving them alone is fine.

Once you are happy with these (as I say on Cygwin you may not need to change them at all neither on some linuxen) run the script:

./download.sh

It should download a qdp++ tar file from a web page, unpack it, configure it, build it and install it.

Afficionados who know what they are doing may mess with the configuration options to get better performance, but they should work as they are.

The build may repeat seemingly several times. This is timestamping anomaly, that I hope to solve, and all it should involve to change to a new tarball is to edit the line PKG_VERSION below the

# ==== No changes below this line ==========

comment.

If all goes well the final lines of output should say:

Running plaquette test
Finished init of RNG
Finished lattice layout
Start gaussian
Start reunit
Start mesplq
w_plaq = -0.00175385493466344
link = 0.0125174784952833
BUILD COMPLETE
qdp++ is installed in /home//install/qdp++
If all is OK you can remove

where is the directory you started in followed by /build

Give it a go! Good Luck! Let me know if it breaks so we can fix it before Laura gets back.

Modulo the analysis things, this should cover most of the preinstalled software for the exercises/demos.