Advanced Computing Platform for Theoretical Physics

README 2.88 KB
Newer Older
rbabich's avatar
rbabich committed
1
2
3

Release Notes for QUDA v0.x
---------------------------
4

5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
Overview:

QUDA is a library for performing calculations in lattice QCD on
graphics processing units (GPUs) using NVIDIA's "C for CUDA" API.
This release includes optimized kernels for applying the Wilson Dirac
operator and clover-improved Wilson Dirac operator, kernels for
performing various BLAS-like operations, and full inverters built on
these kernels.  Mixed-precision implementations of both CG and
BiCGstab are provided, with support for double, single, and half
(16-bit fixed-point) precision.


Software compatibility:

The library has been tested under linux (CentOS 5.3 and Ubuntu 8.04)
using release 2.3 of the CUDA toolkit.  There are known issues with
releases 2.1 and 2.2, but 2.0 should work if one is forced to use an
older version (for compatibility with an old driver, for example).

Under Mac OS X, the library fails to compile due to bugs in CUDA 2.3.
It might work with CUDA 2.2 or 2.0, but this hasn't been tested.


Hardware compatibility:

For a list of supported devices, see

http://www.nvidia.com/object/cuda_learn_products.html

Before building the library, you should determine the "compute
capability" of your card, either from NVIDIA's documentation or by
running the deviceQuery example in the CUDA SDK, and set GPU_ARCH in
the Makefile appropriately.  Setting 'GPU_ARCH = sm_13' will enable
double precision support.


Installation:

In the source directory, copy the template 'Makefile.tmpl' to
'Makefile', and edit the first few lines to specify the CUDA install
path, the platform (x86 or x86_64), and the GPU architecture (see
rbabich's avatar
rbabich committed
46
47
"Hardware compatibility" above).  Then type 'make' to build the
library.
48
49
50
51


Using the library:

rbabich's avatar
rbabich committed
52
53
54
Include the header file "quda.h" in your application, link against
libquda.a, and study invert_test.c for an example of the interface.
The various inverter options are enumerated in enum_quda.h.
55

56
57
58

Known issues:

59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
* One of the stages of the build process requires over 5 GB of memory.
  If too little memory is available, the compilation will either take
  a very long time (given enough swap space) or fail completely.

* For compatibility with CUDA, on 32-bit platforms the library is compiled
  with the GCC option -malign-double.  This differs from the GCC default
  and may affect the alignment of various structures, notably those of
  type QudaGaugeParam and QudaInvertParam, defined in invert_quda.h.
  Therefore, any code to be linked against QUDA should also be compiled
  with this option.


Contact information:

For help or to report a bug, please contact Mike Clark
(mikec@seas.harvard.edu) or Ron Babich (rbabich@bu.edu).

If you find this code useful in your work, a citation to the following
rbabich's avatar
rbabich committed
77
would be appreciated:
78
79
80
81

K. Barros et al., "Blasting through lattice calculations using CUDA,"
PoS LATTICE2008, 045 (2008) [arXiv:0810.5365 [hep-lat]].

rbabich's avatar
rbabich committed
82
83
84
Please also drop us a note so that we can send you updates and
bug-fixes.