/deepstream_python_apps

A project demonstrating use of Python for DeepStream sample apps given as a part of SDK (that are currently in C,C++).

Primary LanguageJupyter NotebookMIT LicenseMIT

DeepStream Python Apps

This repository contains Python bindings and sample applications for the DeepStream SDK.

SDK version supported: 5.1

Download the latest release package complete with bindings and sample applications from the release section.

Please report any issues or bugs on the Deepstream SDK Forums.

Python Bindings

DeepStream pipelines can be constructed using Gst Python, the GStreamer framework's Python bindings. For accessing DeepStream MetaData, Python bindings are provided in the form of a compiled module which is included in the DeepStream SDK. This module is generated using Pybind11.

bindings pipeline

These bindings support a Python interface to the MetaData structures and functions. Usage of this interface is documented in the HOW-TO Guide and demonstrated in the sample applications.
This release adds bindings for decoded image buffers (NvBufSurface) as well as inference output tensors (NvDsInferTensorMeta).

Sample Applications

Sample applications provided here demonstrate how to work with DeepStream pipelines using Python.
The sample applications require MetaData Bindings to work.

To run the sample applications or write your own, please consult the HOW-TO Guide

deepstream python app screenshot

We currently provide the following sample applications:

Of these applications, the following have been updated or added in this release:

  • deepstream-test2: added option to enable output of past frame tracking data
  • deepstream-test4: callback functions are registered only once to avoid race condition
  • deepstream-imagedata-multistream: the probe function now modifies images in-place in addition to saving copies of them
  • deepstream-opticalflow: new sample application to demonstrate optical flow functionality
  • deepstream-segmentation: new sample application to demonstrate segmentation functionality
  • deepstream-nvdsnalaytics: new sample application to demonstrate analytics functionality

Detailed application information is provided in each application's subdirectory under apps.