DeepStream Python 应用程序

本仓库包含 DeepStream SDK 的 Python 绑定和示例应用程序。

支持的 SDK 版本：7.0

<b>此版本仅支持 Ubuntu 22.04 上的 DeepStreamSDK 7.0，搭配 Python 3.10 和 gst-python 1.20.3！Ubuntu 20.04 上的 DeepStreamSDK 6.3 与 Python 3.8 支持现已过时</b>

绑定源代码及构建说明可在 bindings 目录下找到！我们提供了一份指南用于绑定开发贡献，以及另一份指南用于高级用例，如为自定义数据结构编写绑定。

请在 DeepStream SDK 论坛 上报告任何问题或 bug。这使 DeepStream 社区能够在一个中心位置寻求帮助。

• DeepStream Python 应用程序
  • 设置
  • Python 绑定
    • Python 绑定重大 API 变更
  • 示例应用程序

设置

一旦您安装了 DeepStreamSDK 的先决条件和 DeepStreamSDK 本身，请导航到 <DS_ROOT>/sources/ 目录（即 /opt/nvidia/deepstream/deepstream/sources/），并在此处克隆 deepstream_python_apps 仓库。

最新的绑定可以从发布部分安装。 如有需要，您也可以使用 bindings readme 中的说明从源代码构建绑定。

<a name="metadata_bindings"></a>

Python 绑定

DeepStream 管道可以使用 Gst Python（GStreamer 框架的 Python 绑定）构建。为了访问 DeepStream 元数据， 本仓库提供了 Python 绑定。该模块使用 Pybind11 生成。

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/59b2ab84-f365-4f10-985d-6c20bacfdcce.png" alt="绑定管道" height="600px"/> </p>

这些绑定为元数据结构和函数提供了 Python 接口。该接口的使用在 HOW-TO 指南 中有详细说明，并在示例应用程序中进行了演示。

Python 绑定重大 API 变更

alloc_nvds_event_msg_meta() 函数的绑定现在需要一个与 NvDsEventMsgMeta 关联的 NvDsUserMeta 指针。请参考 deepstream-test4 和 bindschema.cpp 以了解详情。

<a name="sample_applications"></a>

示例应用程序

这里提供的示例应用程序演示了如何使用 Python 处理 DeepStream 管道。 示例应用程序需要 元数据绑定 才能运行。

要运行示例应用程序或编写自己的应用程序，请参阅 HOW-TO 指南

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/ddef26dd-a1ef-41ff-a87d-16c10b61a37e.png" alt="deepstream python 应用程序截图" height="400px"/> </p>

我们目前提供以下示例应用程序：

• deepstream-test1 -- 4 类物体检测管道，同时演示了对新 nvstreammux 的支持
• deepstream-test2 -- 4 类物体检测、跟踪和属性分类管道
• deepstream-test3 -- 执行 4 类物体检测的多流管道，还支持 triton 推理服务器、无显示模式、文件循环和静默模式
• deepstream-test4 -- 用于将分析结果发送到云端的消息代理
• deepstream-imagedata-multistream -- 可访问图像缓冲区的多流管道
• deepstream-ssd-parser -- 通过 Triton 服务器进行 SSD 模型推理，并在 Python 中解析输出
• deepstream-test1-usbcam -- 使用 USB 摄像头输入的 deepstream-test1 管道
• deepstream-test1-rtsp-out -- 带有 RTSP 输出的 deepstream-test1 管道，演示了如何添加软件编码器选项以支持 Jetson Orin Nano
• deepstream-opticalflow -- 光流和可视化管道，流向量以 NumPy 数组形式返回
• deepstream-segmentation -- 分割和可视化管道，分割掩码以 NumPy 数组形式返回
• deepstream-nvdsanalytics -- 带有分析插件的多流管道
• runtime_source_add_delete -- 运行时添加/删除源流
• deepstream-imagedata-multistream-redaction -- 带有人脸检测和遮蔽的多流管道
• deepstream-rtsp-in-rtsp-out -- 具有 RTSP 输入/输出的多流管道 - 包含命令行选项 "--rtsp-ts" 用于配置 RTSP 源以附加时间戳而不是使用 streammux
• deepstream-preprocess-test -- 使用 nvdspreprocess 插件和自定义 ROI 的多流管道
• deepstream-demux-multi-in-multi-out -- 使用 nvstreamdemux 插件生成单独缓冲区输出的多流管道
• deepstream-imagedata-multistream-cupy -- 以 CuPy 数组形式从 GPU 访问多流源的图像数据缓冲区 - 仅支持 x86
• deepstream-segmask -- 访问和解释来自 NvOSD_MaskParams 的分割掩码信息
• deepstream-custom-binding-test -- 演示如何使用 NvDsUserMeta 附加自定义数据结构 - 另请参阅 自定义用户元数据指南

每个应用程序的详细信息可在 apps 下的相应子目录中找到。