15.1.1. Requirements - 5.2 English - 57404

AOCL User Guide (57404)
Document ID
57404
Release Date
2025-12-29
Version
5.2 English

Building AOCL-ScaLAPACK library requires linking to the following libraries installed using pre-built binaries or built from source:

  • AOCL-BLAS

  • AOCL-LAPACK

  • AOCL-Utils

Following are the software prerequisites for building AOCL-ScaLAPACK: - CMake - An MPI library such as OpenMPI, MPICH, or Intel MPI - Compiler:

  • On Linux: AOCC and/or (gcc, g++, gfortran)

  • On Windows: Intel MPI compiler

For more information on validated versions of the compilers and CMake, refer to Validation Matrix.

The following table provides an overview of the CMake flags that should be considered when building AOCL-ScaLAPACK.

Table 15.1 AOCL-ScaLAPACK CMake Parameter List#

Build Feature

CMake Command

Select debug or Release mode build

CMAKE_BUILD_TYPE=Debug/Release

Shared library

  • BUILD_SHARED_LIBS=ON

  • BUILD_STATIC_LIBS=OFF

Static library

  • BUILD_STATIC_LIBS=ON

  • BUILD_SHARED_LIBS=OFF

Provide AOCL-BLAS library

BLAS_LIBRARIES=<Path to AOCL-BLAS lib>

Provide AOCL-LAPACK library

LAPACK_LIBRARIES=<Path to AOCL-LAPACK lib>

Note

Include the AOCL-Utils library path too, as AOCL-LAPACK relies on it.

Integer bit length

  • ENABLE_ILP64=ON => 64-bit integer length

  • ENABLE_ILP64=OFF => 32-bit integer length

Build only the library

SCALAPACK_BUILD_SOURCE=ON

Build only the test project

SCALAPACK_BUILD_TESTS=ON

(If this option is set and SCALAPACK_BUILD_SOURCE is OFF, then it requires path to AOCL-ScaLAPACK library to be set using SCALAPACK_LIBRARY_PATH)

Flags disabled by default

USE_OPTIMIZED_LAPACK_BLAS

Set OpenMP library path

OpenMP_libomp_LIBRARY=<path to OpenMP library>

Enable Trace and Log feature

ENABLE_DTL=OFF

Flag enabled by default

ENABLE_WRAPPERS=ON (Disable if using CDEFS values other than NoChange)

Configurable flag for Windows builds

  • CDEFS = NoChange (Fortran to C interface API’s called with small case)

  • CDEFS = UpCase (Fortran to C interface API’s called with upper case)

  • CDEFS = Add_ (Fortran to C interface API’s called with small case and underscore)

Note

Default is NoChange. When ENABLE_WRAPPERS=ON, CDEFS must be set to NoChange. If ENABLE_WRAPPERS=OFF, then CDEFS can be set to any of the other values.