From 47ec378da7b806df8a78cf660cbe189c11f9c320 Mon Sep 17 00:00:00 2001 From: Pieter Ghysels Date: Mon, 15 Apr 2024 16:52:38 -0700 Subject: [PATCH] Doc update --- doc/doxygen/pages/GPU_support.txt | 3 ++- doc/doxygen/pages/Installation.txt | 16 +++++++++++++--- 2 files changed, 15 insertions(+), 4 deletions(-) diff --git a/doc/doxygen/pages/GPU_support.txt b/doc/doxygen/pages/GPU_support.txt index b70ae8bd..52456e7b 100644 --- a/doc/doxygen/pages/GPU_support.txt +++ b/doc/doxygen/pages/GPU_support.txt @@ -55,7 +55,8 @@ There is also support for AMD GPUs through HIP and the ROCm libraries, rocSOLVER and hipBLAS. Support for HIP can be enabled through the CMake build using: \code {.bash} -> cmake ../ -DSTRUMPACK_USE_HIP=ON -DHIP_HIPCC_FLAGS=--amdgpu-target=gfx906 + > export HIP_DIR=.... + > cmake ../ -DSTRUMPACK_USE_HIP=ON -DCMAKE_HIP_ARCHITECTURES=gfx90a -DCMAKE_CXX_COMPILER=hipcc \endcode where the user can specify the specific GPU architecture. If the CMake build system detects CUDA support, then HIP will be diff --git a/doc/doxygen/pages/Installation.txt b/doc/doxygen/pages/Installation.txt index c44f8cd1..fb02b8ae 100644 --- a/doc/doxygen/pages/Installation.txt +++ b/doc/doxygen/pages/Installation.txt @@ -112,9 +112,9 @@ export METIS_DIR=`pwd`/install \code {.bash} > cmake ../ -DSTRUMPACK_USE_CUDA=ON -DCMAKE_CUDA_ARCHITECTURES="75" \endcode - which is enabled by default, and will look for the CUDA compiler and - libraries in the default locations. Additionally, one can specify - the CUDAToolkit_ROOT path to the CUDA libraries: + which will look for the CUDA compiler and libraries in the default + locations. Additionally, one can specify the CUDAToolkit_ROOT path + to the CUDA libraries: \code {.bash} > cmake ../ -DSTRUMPACK_USE_CUDA=ON -DCMAKE_CUDA_ARCHITECTURES="75" -DCUDAToolkit_ROOT=/some/path \endcode @@ -127,6 +127,16 @@ or See the page on \link GPU_Support GPU Support \endlink for more details. +- __HIP__ and __ROCm__ can be used to accelerate the sparse direct + solver on AMD GPUs: +\code {.bash} + > export HIP_DIR=.... + > cmake ../ -DSTRUMPACK_USE_HIP=ON -DCMAKE_HIP_ARCHITECTURES=gfx90a -DCMAKE_CXX_COMPILER=hipcc +\endcode + For full GPU support in the distributed memory sparse direct solver, + one should also compile with support for SLATE with the HIP backend, + see below. \n See the page on \link GPU_Support GPU Support \endlink + for more details. - __MPI__ (Message Passing Interface) library. Support for MPI is enabled by default in STRUMPACK, but can be disabled by adding