rocAL
The AMD ROCm Augmentation Library (rocAL) is designed to efficiently decode and process images and videos from a variety of storage formats and modify them through a processing graph programmable by the user. rocAL currently provides C API. For more details, go to docs page.
Supported Operations
rocAL can be currently used to perform the following operations either with randomized or fixed parameters:
Blend | Blur (Gaussian 3x3) | Brightness | Color Temperature |
---|---|---|---|
ColorTwist | Contrast | Crop | Crop Mirror Normalization |
CropResize | Exposure Modification | Fisheye Lens | Flip (Horizontal, Vertical and Both) |
Fog | Gamma | Hue | Jitter |
Lens Correction | Pixelization | Raindrops | Random Crop |
Resize | Resize Crop Mirror | Rotation | Salt And Pepper Noise |
Saturation | Snowflakes | Vignette | Warp Affine |
Prerequisites
- Ubuntu
20.04
/22.04
- AMD RPP
- AMD OpenVX™ and AMD OpenVX™ Extensions:
VX_RPP
andAMD Media
- Boost library - Version
1.66
or higher - Turbo JPEG - Version
2.0
or higher - Half-precision floating-point library - Version
1.12.0
or higher - Google Protobuf - Version
3.11.1
or higher
Build instructions
rocAL builds and installs as part of the MIVisonX toolkit. rocAL depends on the AMD’s ROCm Performance Primitives (RPP) library, and it needs to be installed for rocAL to build. rocAL also needs the Turbo JPEG library to decode input JPEG images.
- Make sure to have the AMD’s RPP library installed. Please refer to the RPP’s page for instructions on how to install RPP.
- Make sure you’ve installed the Turbo JPEG library version 2.0 or later, refer to the section below.
- Refer to the MIVisonX page and follow build an installation steps (Build & Install MIVisionX).
Turbo JPEG installation
Turbo JPEG library is a SIMD optimized library which currently rocAL uses to decode input JPEG images. It needs to be built from the source and installed in the default path for libraries and include headers. You can follow the instruction below to download the source, build and install it. Note: Make sure you have installed nasm Debian package before installation, it’s the dependency required by libturbo-jpeg.
sudo apt-get install nasm
Note: You need wget package to download the tar file.
sudo apt-get install wget
git clone -b 2.0.6.1 https://github.com/rrawther/libjpeg-turbo.git
cd libjpeg-turbo
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr \
-DCMAKE_BUILD_TYPE=RELEASE \
-DENABLE_STATIC=FALSE \
-DCMAKE_INSTALL_DOCDIR=/usr/share/doc/libjpeg-turbo-2.0.3 \
-DCMAKE_INSTALL_DEFAULT_LIBDIR=lib \
..
make -j$nproc
sudo make install
LMDB installation
sudo apt-get install libgflags-dev libgoogle-glog-dev liblmdb-dev
Sample and test applications
- Image augmentation application demonstrates how rocAL’s C API can be used to load jpeg images from the disk, decode them and augment the loaded images with a variety of modifications.
- Augmentation unit tests can be used to test rocAL’s API individually.