Skip to content

Latest commit

 

History

History
154 lines (110 loc) · 3.79 KB

README.md

File metadata and controls

154 lines (110 loc) · 3.79 KB

MIT licensed

rocDecode Python Binding

The rocDecode Python Binding, rocPyDecode, is a tool that allows users to access rocDecode APIs in both Python and C/C++ languages. It works by connecting Python and C/C++ libraries, enabling function calling and data passing between the two languages. The rocpydecode.so library is a wrapper that facilitates the use of rocDecode APIs that are written primarily in C/C++ language within Python.

Prerequisites

Important

gfx908 or higher GPU required

  • Install ROCm 6.2.0 or later with amdgpu-install: Required usecase - rocm

Important

sudo amdgpu-install --usecase=rocm

  • CMake 3.5 or higher

    sudo apt install cmake

  • Python3 and Python3 PIP

    sudo apt install python3-dev python3-pip

  • PyBind11

    sudo apt install pybind11-dev

  • rocDecode

    sudo apt install rocdecode-dev

  • pkg-config

    sudo apt install pkg-config

  • FFmpeg runtime and headers - for tests and samples

    sudo apt install ffmpeg libavcodec-dev libavformat-dev libavutil-dev

  • DLPack

      sudo apt install libdlpack-dev

Note

  • All package installs are shown with the apt package manager. Use the appropriate package manager for your operating system.

Prerequisites setup script

For your convenience, we provide the setup script, rocPyDecode-requirements.py, which installs all required dependencies.
Run this script only once on bare metal, if using docker please see below instructions.

python3 rocPyDecode-requirements.py

rocPyDecode install

using bare-metal

git clone https://github.com/ROCm/rocPyDecode.git
cd rocPyDecode
sudo pip3 install .

Note

sudo access is needed

creating python distribution wheel

# the generated .whl file will be located under subfolder ./dist/
git clone https://github.com/ROCm/rocPyDecode.git
cd rocPyDecode
# Create/Build the wheel and install it
sudo python3 build_rocpydecode_wheel.py
# alternative method
sudo python3 setup.py bdist_wheel

Note

sudo access is needed

using docker environment

git clone https://github.com/ROCm/rocPyDecode.git
cd rocPyDecode
python rocPyDecode-docker-install.py

Note

Do NOT use sudo

Run CTest

This will run python samples and show pass/fail.

Dependencies:

python3 -m pip install --upgrade pip
python3 -m pip install -i https://test.pypi.org/simple hip-python

Run test:

cd rocPyDecode
cmake .
ctest -VV

Run Sample Scripts

  • Sample scripts and instructions to run them can be found here

Documentation

Run the following code to build our documentation locally.

cd docs
pip3 install -r sphinx/requirements.txt
python3 -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html

For more information on documentation builds, refer to the Building documentation page.

Tested configurations

  • Linux
    • Ubuntu - 20.04 / 22.04
  • ROCm:
    • rocm-core - 6.2.0.60200-crdnnh.14042
    • amdgpu-core - 1:6.2.60200-1778439.22.04
  • rocdecode - 0.6.0.60200-crdnnh.14042
  • FFmpeg - 4.2.7 / 4.4.2-0