AOCL User Guide#

Advanced Micro Devices

Contents

1. Introduction
- 1.1. Feature Support Matrix
2. Validation Matrix
3. Installing AOCL
- 3.1. Building from Source
- 3.2. Installing AOCL Binary Packages
4. AOCL-BLAS
- 4.1. Installation
- 4.2. Application Development Using AOCL-BLAS
  - 4.2.1. Linking Application with AOCL-BLAS
  - 4.2.2. AOCL-BLAS Usage in Fortran and C
- 4.3. Migrating/Porting
- 4.4. Using AOCL-BLAS Library Features
- 4.5. Debugging and Troubleshooting
- 4.6. LPGEMM in AOCL-BLAS
5. AOCL-LAPACK
- 5.1. Installing on Linux
  - 5.1.1. Building AOCL-LAPACK from Source
  - 5.1.2. Using Pre-Built Libraries
- 5.2. Usage on Linux
  - 5.2.1. Use by Applications
- 5.3. Building AOCL-LAPACK from Source on Windows
- 5.4. Checking AOCL-LAPACK Operation Progress
6. AOCL-FFTW
- 6.1. Installing
- 6.2. Usage
7. AOCL-LibM
- 7.1. Library Contents
  - 7.1.1. Scalar Functions
  - 7.1.2. Fast Scalar and Vector Variants
- 7.2. Installation
- 7.3. Using AOCL-LibM
8. AOCL-ScaLAPACK
- 8.1. Installation
  - 8.1.1. Building AOCL-ScaLAPACK from Source on Linux
  - 8.1.2. Using Pre-Built Libraries
- 8.2. Usage
- 8.3. Building AOCL-ScaLAPACK from Source on Windows
- 8.4. Checking AOCL-ScaLAPACK Operation Progress
- 8.5. Additional Features
9. AOCL-RNG
- 9.1. Installation
  - 9.1.1. Using Pre-Built Libraries on Linux
  - 9.1.2. Using Pre-Built Libraries on Windows
- 9.2. Using AOCL-RNG Library
  - 9.2.1. Using on Linux
  - 9.2.2. Using on Windows
- 9.3. Using AOCL-RNG Library Features
10. AOCL-SecureRNG
- 10.1. Installation
  - 10.1.1. Using Pre-Built Libraries on Linux
  - 10.1.2. Using Pre-Built Libraries on Windows
- 10.2. Using AOCL-SecureRNG Library
  - 10.2.1. Using on Linux
  - 10.2.2. Using on Windows
11. AOCL-Sparse
- 11.1. Installation
- 11.2. Usage
12. AOCL-LibMem
- 12.1. Building AOCL-LibMem for Linux
- 12.2. Running an Application
13. AOCL-Cryptography
- 13.1. Requirements
- 13.2. Installation
  - 13.2.1. Building AOCL-Cryptography from Source on Linux
  - 13.2.2. Building AOCL-Cryptography from Source on Windows
- 13.3. Using AOCL-Cryptography in a Sample Application
14. AOCL-Compression
- 14.1. Requirements
- 14.2. Installation
  - 14.2.1. Using Pre-Built Libraries
  - 14.2.2. Building from Source
- 14.3. Running AOCL-Compression Test Bench on Linux
- 14.4. Running AOCL-Compression Test Bench on Windows
- 14.5. API Reference
- 14.6. Optional Build Parameters
- 14.7. Optional Runtime Parameters
  - 14.7.1. Instruction Set Selection
15. AOCL-Utils
- 15.1. Requirements
- 15.2. Clone and Build the AOCL-Utils Library
- 15.3. Using AOCL-Utils
16. AOCL-Data Analytics
- 16.1. Installation
  - 16.1.1. Building from Source
- 16.2. Usage
  - 16.2.1. Calling the C or C++ APIs
  - 16.2.2. Calling the Python APIs
17. Linking AOCL to Applications
- 17.1. High-Performance LINPACK Benchmark (HPL)
  - 17.1.1. Configuring HPL.dat
  - 17.1.2. Running the Benchmark
- 17.2. MUMPS Sparse Solver Library
  - 17.2.1. Enabling AOCL with MUMPS
18. Support
19. References
20. Appendix
- 20.1. Check AMD Server Processor Architecture
  - 20.1.1. On Linux
  - 20.1.2. On Windows
- 20.2. Application Notes
  - 20.2.1. AOCL-BLAS
  - 20.2.2. AOCL-FFTW

Legal Notice#

Trademarks

AMD, the AMD Arrow logo, and combinations thereof are trademarks of Advanced Micro Devices, Inc. Dolby is a trademark of Dolby Laboratories.

ENERGY STAR is a registered trademark of the U.S. Environmental Protection Agency. HDMI is a trademark of HDMI Licensing, LLC.

HyperTransport is a licensed trademark of the HyperTransport Technology Consortium.

Microsoft, Windows, Windows Vista, Windows Server, Visual Studio,and DirectX are registered trademarks of Microsoft Corporation.

MMX is a trademark of Intel Corporation.

OpenCL is a trademark of Apple Inc. used by permission by Khronos. PCIe is a registered trademark of PCI-Special Interest Group (PCI-SIG).

Other product names used in this publication are for identification purposes only and may be trademarks of their respective companies.

Dolby Laboratories, Inc.

Manufactured under license from Dolby Laboratories.

Rovi Corporation

This device is protected by U.S. patents and other intellectual property rights. The use of Rovi Corporation’s copy protection technology in the device must be authorized by Rovi Corporation and is intended for home and other limited pay-per-view uses only, unless otherwise authorized in writing by Rovi Corporation.

Reverse engineering or disassembly is prohibited.

USE OF THIS PRODUCT IN ANY MANNER THAT COMPLIES WITH THE MPEG-2 STANDARD IS EXPRESSLY PROHIBITED WITHOUT A LICENSE UNDER APPLICABLE PATENTS IN THE MPEG-2 PATENT PORTFOLIO, WHICH LICENSE IS AVAILABLE FROM MPEG LA, L.L.C., 6312 S. FIDDLERS GREEN CIRCLE, SUITE 400E, GREENWOOD VILLAGE, COLORADO 80111.

Revision History#

Date	Revision	Description
October 2024	5.0	Added Chapters 16, 17 Tuning Guidelines separated out as an independent document Release specific updates and general edits
February 2024	4.2	Re-organized Chapter 11 Release specific updates and general edits
August 2023	4.1	Added Chapter 15 Added sections 4.7, 8.5, 11.5, 14.1.1, and 14.1.2
November 2022	4.0	Added sections 9.3, 10.3, 17.1.2.1, and 17.6 Updated section 4.4.1.3 Added Chapter 14 Removed the chapter AOCL-Spack recipes
July 2022	3.2	Added chapters 12 and 13, sections 5.4, 8.4, and 16.1 Added Multi-thread support information in chapter 11
December 2021	3.1	Initial version

Indices and tables#

Index
Module Index
Search Page

AOCL User Guide (57404) - 5.0 English - 57404

AOCL User Guide (57404)

AOCL User Guide#

Legal Notice#

Revision History#

Indices and tables#