changsubi / gstreamer-examples

This repository showcases how to create image processing pipelines using GStreamer, DeepStream and other technologies.

GSTREAMER-EXAMPLES

This repository contains both GStreamer and Deepstream related examples in Python. Directories are as follows:

• helper-package. A package that contains helper functions and classes.
• deepstream-examples. Deepstream related examples.
• hailo-examples. Hailo related examples.
• gst-examples. Gst-examples.
• docker. Docker files for generating containers.

Paul Bridger has excellent tutorials regarding how to speed up inference. For anyone interested in the subject, I recommend to take a look at:

• https://paulbridger.com/posts/video-analytics-pytorch-pipeline/
• https://paulbridger.com/posts/video-analytics-pipeline-tuning/

Helper-Package

Helpers is a Python package that contains some helper routines for creating gst-pipelines. Most of the examples, if not all, use modules from this package, so it needs to be available to Python. Easiest way to make this accessible is to install it as follows.

Make sure that you have the latest version of PyPA's build installed:

python3 -m pip install --upgrade build

In order to create the package, run the following command from the directory where the pyproject.toml is located:

cd helper-package
python3 -m build

Above command creates a new directory called dist where the package can be found. In order to install the created package, run the following command from the dist directory:

pip3 install ./helpers-0.0.1-py3-none-any.whl

Replace helpers-0.0.1-py3-none-any.whl with the actual name/path of the whl-file that was created.

Usage

Once you have installed the helpers package, you can use is as follows:

from helpers import *

Python Packages and Modules

For more information regarding Python packagaging etc., take a look at:

• https://packaging.python.org/en/latest/tutorials/packaging-projects/
• https://docs.python.org/3/tutorial/modules.html#packages
• https://python-packaging-tutorial.readthedocs.io/en/latest/setup_py.html