Skip to content

Latest commit

 

History

History

hipRAND

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
c_cpp_api
c_cpp_api
 
 
device_api
device_api
 
 
CMakeLists.txt
CMakeLists.txt
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 

README.md

hipRAND Examples

Summary

The examples in this subdirectory showcase the functionality of the hipRAND library. The examples build on both Linux and Windows for both the ROCm (AMD GPU) and CUDA (NVIDIA GPU) backends.

Prerequisites

Linux

  • CMake (at least version 3.21) OR GNU Make - available via the distribution's package manager
  • ROCm (at least version 6.x.x)
  • hipRAND
    • ROCm platform: hipRAND-dev package available from repo.radeon.com. The repository is added during the standard ROCm install procedure.
    • CUDA platform: Install hipRAND from source: instructions.
      • cuRAND is a dependency of hipRAND for NVIDIA platforms. CUB is part of the NVIDIA CUDA Toolkit.

Windows

  • Visual Studio 2019 or 2022 with the "Desktop Development with C++" workload
  • ROCm toolchain for Windows
    • The Visual Studio ROCm extension needs to be installed to build with the solution files.
  • hipRAND
    • ROCm platform: Installed as part of the ROCm SDK on Windows for ROCm platform.
    • CUDA platform: Install hipRAND from source: instructions.
      • cuRAND is a dependency of hipRAND for NVIDIA platforms. cuRAND is part of the NVIDIA CUDA Toolkit.
  • CMake (optional, to build with CMake. Requires at least version 3.21)
  • Ninja (optional, to build with CMake)

Building

Linux

Make sure that the dependencies are installed, or use one of the provided Dockerfiles to build and run the examples in a containerized environment.

Using CMake

All examples in the hipRAND subdirectory can either be built by a single CMake project or be built independently.

  • $ cd Libraries/hipRAND
  • $ cmake -S . -B build (on ROCm) or $ cmake -S . -B build -D GPU_RUNTIME=CUDA (on CUDA)
  • $ cmake --build build

Using Make

All examples can be built by a single invocation to Make or be built independently.

  • $ cd Libraries/hipRAND
  • $ make (on ROCm) or $ make GPU_RUNTIME=CUDA (on CUDA)

Windows

Visual Studio

Visual Studio solution files are available for the individual examples. To build all examples for hipRAND open the top level solution file ROCm-Examples-VS2019.sln and filter for hipRAND.

For more detailed build instructions refer to the top level README.md.

CMake

All examples in the hipRAND subdirectory can either be built by a single CMake project or be built independently. For build instructions refer to the top-level README.md.