clBLAS library provides the optimized way to perform linear-algebra operations in OpenCL version of ADDA. Currently we are only testing its virtues, but it may become linked by default in the future. ADDA requires at least clBLAS version 2.12, the following guidelines are based on version 2.12.0.

• Unix
• macOS
• Windows

• Either obtain a special package, e.g. libclblas-dev for Ubuntu.

• Or download it from the official repository.

  • Either download the source and compile it. Doing it under the user account (install directory - $HOME) can be as easy as (requires CMake):

    tar -zxvf clBLAS-2.12.tar.gz
    cd clBLAS-2.12/src
    cmake -DCMAKE_INSTALL_PREFIX=$HOME -DCMAKE_BUILD_TYPE=Release .
    make
    make install/fast
    

    cmake automatically determines if some auxiliary software is available on your system and sets up furhter installation to include only the core library or, additionally, client application and tests (ADDA need only the library). We use target install/fast instead of install, since the latter erroneously repeats the build.
  • Alternatively, download the ready binaries for x64 Linux (install directory should be extracted from the archive).
  • Additionally you also need to update the environment (this may be unnecessary after local build if you already installed other software into $HOME):
    • either add include subdirectory of the install directory to environmental variable C_INCLUDE_PATH and lib64 - to LIBRARY_PATH and LD_LIBRARY_PATH (for linking and runtime). Setting LD_LIBRARY_PATH can be replaced by modifying /etc/ld.so.conf.
    • or specify paths to ../include and ../lib64 subdirectories of the install directory in ocl/Makefile, as described in CompilingADDA. Also update LD_LIBRARY_PATH as described above.

• Or download it from the official repository. Compiling from source requires a few dependencies to be installed first. Anyway, you will also need to update the environment:

  • either add include subdirectory of the install directory to environmental variable C_INCLUDE_PATH and lib64 - to LIBRARY_PATH and LD_LIBRARY_PATH (for linking and runtime). Setting LD_LIBRARY_PATH can be replaced by modifying /etc/ld.so.conf.
  • or specify paths to ../include and ../lib64 subdirectories of the install directory in ocl/Makefile, as described in CompilingADDA. Also update LD_LIBRARY_PATH as described above.

• Get the package from Homebrew or other package manager.
• Otherwise, follow the Unix instructions.

We are not yet providing ADDA executables with clBLAS support. To compile adda_ocl on Windows yourself, do the following:

• Download and unzip the latest release for Windows.
• If you are setting up the MinGW/MSYS environment with advanced instructions follow those instructions.
• Alternatively, do the following:
  • specify paths to include and bin subdirectories of the install directory in ocl/Makefile, as described in CompilingADDA.
  • To avoid need to move DLLs together with ADDA executables add bin subdirectory to environmental variable PATH