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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
# Important commands

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

## OpenCL kernel compilation

```zsh
make keremu
```

## Design emulation

```zsh
make emu
```

## Estimation & optimization reports generation

```zsh
make kerrpt
```

## FPGA building

```zsh
make hw
```

## FPGA building for hardware profiling

```zsh
make hw-prof
```

## FPGA evaluation

```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.