Essentials For Linux

This page covers the process of getting Essentials for Linux and how one may run the provided examples. We do not provide a compiled binary of Essentials/Gunrock for any environment.

Minimum Requirements

• NVIDIA CUDA Supported Linux Distros, our development is on Ubuntu 18.04 and 20.04.
• Supported GCC, G++ (also listed in Table 1. Native Linux Distribution Support).
• CUDA 11.2 or higher, the latest CUDA version is recommended.
• CMake version 3.20.1 or higher.
• Thrust, CUB, ModernGPU, and CXXOpts (auto downloaded using cmake).
• (Optional) NVBench (auto downloaded using cmake)

Download

• Clone using git

git clone https://github.com/gunrock/essentials.git

• Download ZIP

wget --no-check-certificate https://github.com/gunrock/essentials/archive/refs/heads/master.zip

Building Essentials

• Once you have the correct cmake version installed, which can be checked by cmake --version, follow the following steps:

cd essentials
mkdir build && cd build
cmake .. 

• You can now build all applications using:

make

• Or build a specific application using (sssp for example):

make sssp

• All examples are compiled in bin in your build directory, to run an example:

./bin/sssp ../datasets/chesapeake/chesapeake.mtx

• Example output:

./bin/sssp ../datasets/chesapeake/chesapeake.mtx
Single Source = 0
GPU distances[:40] = 0 2 2 2 2 2 1 1 2 2 1 1 1 2 2 2 2 2 2 2 2 1 1 2 2 2 2 2 2 2 2 2 2 1 1 2 1 2 1
CPU Distances[:40] = 0 2 2 2 2 2 1 1 2 2 1 1 1 2 2 2 2 2 2 2 2 1 1 2 2 2 2 2 2 2 2 2 2 1 1 2 1 2 1
GPU Elapsed Time : 2.20403 (ms)
CPU Elapsed Time : 0.003 (ms)
Number of errors : 0