Ryzen AI CVML library#

The Ryzen AI CVML libraies build on top of the Ryzen AI drivers and execution infrastructure to provide powerful AI capabilities to C++ applications without having to worry about training specific AI models and integrating them to the Ryzen AI framework.

Each Ryzen AI CVML library feature offers a simple C++ application programming interface (API) that can be easily incorporated into existing applications.

The Ryzen AI CVML library is distributed through the RyzenAI-SW Github repository: amd/RyzenAI-SW

Prerequisites#

Ensure that the following software tools/packages are installed on the development system.

Visual Studio 2022 Community edition or newer, ensure “Desktop Development with C++” is installed
Cmake (version >= 3.18)
OpenCV (version=4.8.1 or newer)

Building sample applications#

This section describes the steps to build Ryzen AI CVML library sample applications.

Navigate to the folder containing Ryzen AI samples#

Download the Ryzen AI CVML sources, and go to the ‘samples’ sub-folder of the library.

git clone https://github.com/amd/RyzenAI-SW.git -b main --depth-1
chdir RyzenAI-SW\Ryzen-AI-CVML-Library\samples

OpenCV libraries#

Ryzen AI CVML library samples make use of OpenCV, so set an environment variable to let the build scripts know where to find OpenCV.

set OPENCV_INSTALL_ROOT=<location of OpenCV libraries>

Build Instructions#

Create a build folder and use CMAKE to build the sample(s).

mkdir build-samples
cmake -S %CD% -B %CD%\build-samples -DOPENCV_INSTALL_ROOT=%OPENCV_INSTALL_ROOT%
cmake --build %CD%\build-samples --config Release

The compiled sample application(s) will be placed in the various build-samples<application>Release folder(s) under the ‘samples’ folder.

Running sample applications#

This section describes how to execute Ryzen AI CVML library sample applications.

Update the console and/or system PATH#

Ryzen AI CVML library applications need to be able to find the library files. One way to do this is to add the location of the libraries to the system or console PATH environment variable.

In this example, the location of OpenCV’s runtime libraries is also added to the PATH environment variable.

set PATH=%PATH%;<location of Ryzen AI CVML library package>\windows
set PATH=%PATH%;%OPENCV_INSTALL_ROOT%\x64\vc16\bin

Adjust the aforementioned commands to match the actual location of Ryzen AI and OpenCV libraries, respectively.

Select an input source/image/video#

Ryzen AI CVML library samples can accept a variety of image and video input formats, or even open the default camera on the system if “0” is specified as an input.

In this example, a publically available video file is used for the application’s input.

curl -o dancing.mp4 https://videos.pexels.com/video-files/4540332/4540332-hd_1920_1080_25fps.mp4

Execute the sample application#

Finally, the previously built sample application can be executed with the selected input source.

build-samples\cvml-sample-depth-estimation\Release\cvml-sample-depth-estimation.exe -i dancing.mp4

Ryzen AI CVML library

Contents