qmcpack/README

55 lines
1.9 KiB
Plaintext

h1. Getting and building QMCPACK
h2. Prerequisite
* C/C++ compilers
* cmake, build utility, http://www.cmake.org
* blas/lapack, numerical library, use platform-optimized libraries
* libxml2, XML parser, http://xmlsoft.org/
* hdf5, portable I/O library, http://www.hdfgroup.org/HDF5/
* boost, peer-reviewed portable C++ source libraries, http://www.boost.org
* einspline, 3D bspline library, http://einspline.sourceforge.net/
* fftw, FFT library, http://www.fftw.org/
h2. Building with environment variables
This method works with GNU, Intel, and IBM XLC compilers. When the libraries
are installed in standard locations, e.g., /usr, /usr/local, there is no need
to set the XYZ_HOME for XYZ package.
See http://docs.qmcpack.org for build examples on Linux, Mac OS X etc.
* Set the environments (the examples below assume bash, Intel compilers and MKL library)
export CXX=icpc
export CC=icc
export MKL_HOME=/usr/local/intel/mkl/10.0.3.020
export LIBXML2_HOME=/usr/local
export HDF5_HOME=/usr/local
export BOOST_HOME=/usr/local/boost
export EINSPLINE_HOME=/usr/local/einspline
export FFTW_HOME=/usr/local/fftw
* Move to build directory, run cmake and make
cd build
cmake ..
make
h2. Building with a toolchain file
Several toolchain files used by the developers are available in config
directory. They are used on large-scale parallel machines where setting up all
the neccesary packages can be tricky.
* AbeMvapich2.cmake for Abe cluster at NCSA
* JaguarGNU.cmake for CrayXT systems at ORNL
* KrakenGNU.cmake for CrayXT5 system at NICS
Once a sutiable toolchain file is found, follow these step (example on abe.ncsa.uiuc.edu):
* cd build
* cmake -DCMAKE_TOOLCHAIN_FILE=../config/AbeMvapich2.cmake -DCMAKE_VERBOSE_MAKEFILE=TRUE ..
* cmake -DCMAKE_TOOLCHAIN_FILE=../config/AbeMvapich2.cmake -DCMAKE_VERBOSE_MAKEFILE=TRUE ..
* make
For more informaton, consult QMCPACK pages at http://www.qmcpack.org and http://docs.qmcpack.org