rocThrust

rocThrust Examples

Summary

The examples in this subdirectory showcase the functionality of the rocThrust library. The examples build on Linux using the ROCm platform and on Windows using the HIP on Windows platform.

Prerequisites

Linux

• CMake (at least version 3.21)
• OR GNU Make - available via the distribution's package manager
• ROCm (at least version 5.x.x)
• rocThrust: rocthrust-dev package available from repo.radeon.com. The repository is added during the standard ROCm install procedure.

Windows

• Visual Studio 2019 or 2022 with the "Desktop Development with C++" workload
• ROCm toolchain for Windows (No public release yet)
  • The Visual Studio ROCm extension needs to be installed to build with the solution files.
• rocThrust: installed as part of the ROCm SDK on Windows
• 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 the provided Dockerfile to build and run the examples in a containerized environment that has all prerequisites installed.

Using CMake

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

• $ cd Libraries/rocThrust
• $ cmake -S . -B build
• $ cmake --build build

Using Make

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

• $ cd Libraries/rocThrust
• $ make

Windows

Visual Studio

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

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

CMake

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