11.4.5. Using AOCL-BLAS - 5.2 English - 57404

AOCL User Guide (57404)

Document ID
57404
Release Date
2025-12-29
Version
5.2 English

AOCL-LAPACK can be linked with any Netlib BLAS compliant library when compiled with standard CMake options as provided in AOCL User Guide. However, AOCL-LAPACK provides an option to link explicitly with AOCL-BLAS library at compile time. This option enables invoking lower level AOCL-BLAS APIs directly and that could result in better performance for certain APIs on AMD “Zen” CPUs. To force AOCL-LAPACK to use AOCL-BLAS library, provide the option ENABLE_AOCL_BLAS in the CMake configuration:

$ cmake -DENABLE_AMD_AOCC_FLAGS=ON -DENABLE_AOCL_BLAS=ON ...

For this option to work, AOCL-LAPACK must be able to find AOCL-BLAS library and header files during the build. You can provide the path to AOCL-BLAS library using either of the following methods during CMake configuration:

  • Set AOCL_ROOT environment variable to the path where AOCL-BLAS library ($AOCL_ROOT/lib) and header files ($AOCL_ROOT/include) are located:

    $ export AOCL_ROOT=<path to AOCL-BLAS>
    
  • Specify root path of the AOCL-BLAS library through the CMake option AOCL_ROOT:

    $ cmake -DENABLE_AMD_AOCC_FLAGS=ON -DENABLE_AOCL_BLAS=ON
    -DAOCL_ROOT=<path to AOCL-BLAS> ...
    

The path specified in AOCL_ROOT must have the directories include and lib containing the necessary header files and binary of AOCL-BLAS, respectively.