README.md 1.71 KB
Newer Older
Leonardo Solis's avatar
Leonardo Solis committed
1
2
3
4
5
OCLADock-FPGA - OpenCL Accelerated Molecular Docking on FPGAs
=============================================================

<img src="logo.png" width="200">

Leonardo Solis's avatar
Leonardo Solis committed
6
7
# Description

Leonardo Solis's avatar
Leonardo Solis committed
8
9
10
OpenCL task-parallel version of AutoDock4 for Intel (Altera) FPGAs. 

It achieves speed-ups of up to 2.7x over the original single-threaded AutoDock 4.2 on CPU.
11

Leonardo Solis's avatar
Leonardo Solis committed
12
# Easy Download
Leonardo Solis's avatar
Leonardo Solis committed
13

Leonardo Solis's avatar
Leonardo Solis committed
14
15
If you are not familiar with GitLab, the easiest way to download all of OCLADock-FPGA (source code, sample input data) is to
use the Download icon (close to the top right of this webpage, just above the list of files) and use a familiar archive format (e.g., .zip) to fetch everything at once.
Leonardo Solis's avatar
Leonardo Solis committed
16

Leonardo Solis's avatar
Leonardo Solis committed
17
18
19
20
21
# Development tools

Intel (Altera) OpenCL Compiler v16.0 (Quartus upgraded and patched: 16.0.0.211).

Initialization scripts automate the tool setup-process:
22

Leonardo Solis's avatar
Leonardo Solis committed
23
```zsh
Leonardo Solis's avatar
Leonardo Solis committed
24
% source init_aoc160_gidel.sh
Leonardo Solis's avatar
Leonardo Solis committed
25
```
Leonardo Solis's avatar
Leonardo Solis committed
26

Leonardo Solis's avatar
Leonardo Solis committed
27
28
29
30
# Important commands

* See rules in [Makefile](./ofdock_taskpar_alt/Makefile)

Leonardo Solis's avatar
Leonardo Solis committed
31
**OpenCL kernels compilation**
Leonardo Solis's avatar
Leonardo Solis committed
32
33
34
35
36

```zsh
make keremu
```

Leonardo Solis's avatar
Leonardo Solis committed
37
**Design emulation**
Leonardo Solis's avatar
Leonardo Solis committed
38
39
40
41
42

```zsh
make emu
```

Leonardo Solis's avatar
Leonardo Solis committed
43
**Estimation & optimization reports generation**
Leonardo Solis's avatar
Leonardo Solis committed
44
45
46
47
48

```zsh
make kerrpt
```

Leonardo Solis's avatar
Leonardo Solis committed
49
**FPGA building**
Leonardo Solis's avatar
Leonardo Solis committed
50
51
52
53
54

```zsh
make hw
```

Leonardo Solis's avatar
Leonardo Solis committed
55
**FPGA building for hardware profiling**
Leonardo Solis's avatar
Leonardo Solis committed
56
57
58
59
60

```zsh
make hw-prof
```

Leonardo Solis's avatar
Leonardo Solis committed
61
**FPGA evaluation**
Leonardo Solis's avatar
Leonardo Solis committed
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

```zsh
make exe
```

# Documentation

For more details, go to the [Documentation](doc/readme/home.md).

# Bibliographic information for citing OCLADock

Leonardo Solis-Vasquez and Andreas Koch. 2018. A Case Study in Using OpenCL on FPGAs: Creating an Open-Source Accelerator of the AutoDock Molecular Docking Software. In Proceedings of the 5th International Workshop on FPGAs for Software Programmers (FSP), 2018. 

# License

This project is licensed under the GNU GPLv2 - see the [LICENSE](LICENSE) file for details.