Quick start installation guide

Quick start installation guide#

This topic discusses how to quickly build hipFORT from source.

Prerequisites#

hipFORT requires a Fortran compiler that supports at least the Fortran 2003 standard. AMD amdflang (ROCm’s LLVM Flang, bundled with ROCm) is the recommended default; gfortran version 7.5.0 or newer (see the GFortran website) is also supported. Please open an issue at ROCm/hipfort#issues if you run into problems.

Building and testing hipFORT from source#

  1. Ensure you have installed a Fortran compiler (amdflang or gfortran), git, cmake, and HIP.

  2. Build, install, and test hipFORT from source using the following commands:

    git clone https://github.com/ROCm/hipfort.git
cd hipfort
cmake -S. -Bbuild -DCMAKE_INSTALL_PREFIX=/tmp/hipfort -DBUILD_TESTING=ON
cmake --build build
cmake --install build
ctest --test-dir build

To build with a specific compiler and backend, pass one of the provided toolchain files, for example -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains/amdflang.cmake. See the detailed install guide for the full list.

Contents