cwpearson/chai repository overview

⁠Chai

v1.0-alpha

⁠Overview

Chai is a benchmark suite of Collaborative Heterogeneous Applications for Integrated-architectures. The Chai benchmarks are designed to use the latest features of heterogeneous architectures such as shared virtual memory and system-wide atomics to achieve efficient simultaneous collaboration between host and accelerator devices.

Each benchmark has multiple implementations. This release includes the OpenCL-D, OpenCL-U, CUDA-D, CUDA-U, CUDA-D-Sim, and CUDA-U-Sim implementations. The C++AMP implementations are underway. If you would like early access to premature versions, please contact us.

⁠Instructions

Clone the repository:

git clone https://github.com/chai-benchmarks/chai.git
cd chai

Export environment variables:

export CHAI_OCL_LIB=<path/to/OpenCL/lib>
export CHAI_OCL_INC=<path/to/OpenCL/include>

Select desired implementation:

cd OpenCL-U

Select desired benchmark:

cd BFS

Compile:

make

Execute:

./bfs

For help instructions:

./bfs -h

⁠Citation

Please cite the following paper if you find our benchmark suite useful:

• J. Gómez-Luna, I. El Hajj, L.-W. Chang, V. Garcia-Flores, S. Garcia de Gonzalo, T. Jablin, A. J. Peña, W.-M. Hwu. Chai: Collaborative Heterogeneous Applications for Integrated-architectures. In Proceedings of IEEE International Symposium on Performance Analysis of Systems and Software (ISPASS), 2017. [bibtex]⁠

⁠Running OpenCL 1.2 benchmarks on NVIDIA with Docker

Install docker for your system.

Install nvidia-docker.

To build the docker image, use

nvidia-docker build . -t chai

To run a benchmark (for example, BS), do

nvidia-docker run -it chai bash -c "cd chai/OpenCL1.2/BS/ && ./bs"

⁠Docker: Running OpenCL 1.2 and 2.0 Benchmarks with the Intel OpenCL CPU Stacks

Install docker for your system.

To build the docker image for OpenCL 1.2 and 2.0 respectively, use

docker build . -f Dockerfile.intel_ocl1.2_cpu -t chai-intel-1.2
docker build . -f Dockerfile.intel_ocl2.0_cpu -t chai-intel-2.0

To run a benchmark (for example, BS) from the two images, use

docker run -it chai-intel-1.2 bash -c "cd BS/ && ./bs"
docker run -it chai-intel-2.0 bash -c "cd BS/ && ./bs"

To run all the benchmarks, try

docker run -it chai-intel-1.2 bash -c "test.sh"