概览硬件软件云平台
此页面由 AI 自动翻译。查看英文原版
OAK 应用
DepthAI
AI
软件栈
故障排除

本页目录

  • 工作原理
  • 安装
  • 运行工具
  • 可用操作
  • 自定义选项
  • 节点命名
  • 与图交互

DepthAI Pipeline Graph

DepthAI Pipeline Graph 工具可创建 DepthAI pipeline 的动态可视化。它是调试的理想工具，可提供对 pipeline 结构和流程的深入了解。

工作原理

在 DepthAI 框架中，pipeline 由各种节点以及它们之间的连接组成。在代码中定义 pipeline 后，通常会将其传递给设备。此时，pipeline 配置将被序列化为 JSON 并发送到 OAK 设备。如果在运行代码之前设置了环境变量 DEPTHAI_LEVEL=debug，则 JSON 配置将打印到控制台：
Command Line
1[2022-06-01 16:47:33.721] [debug] Schema dump: {"connections":[{"node1Id":8,"node1Output":"passthroughDepth","node1OutputGroup":"","node2Id":10,"node2Input":"in","node2InputGroup":""},...]
pipeline_graph 工具执行以下步骤：
  • 设置 DEPTHAI_LEVEL=debug
  • 执行您的代码
  • 从输出中捕获 schema dump
  • 使用修改版的 NodeGraphQt 解析 schema 以创建可视化图

安装

要安装该工具，请运行：
Command Line
1pip install git+https://github.com/luxonis/depthai_pipeline_graph.git
如果缺少 Qt 绑定（例如 PySide2），您将收到错误。可以通过安装 PySide2 来解决此问题：
Command Line
1pip install PySide2

运行工具

安装后，可以通过键入以下命令来使用该工具：
Command Line
1pipeline_graph -h
这将显示可用操作，包括 run、from_file 和 load。

可用操作

  • Run: 实时执行您的 DepthAI 脚本并生成 pipeline 图。
Command Line
1pipeline_graph run "python your_script.py"
使用 -dnk 选项允许您的脚本在捕获 schema 后继续运行：
Command Line
1pipeline_graph run "python your_script.py" -dnk
  • From File: 从日志文件或 JSON schema 生成 pipeline 图：
Command Line
1pipeline_graph from_file path/to/your/log_or_json_file
  • Load: 加载和编辑先前保存的 pipeline 图：
Command Line
1pipeline_graph load path/to/your/saved_graph.json

自定义选项

节点命名

默认情况下，节点根据其类型命名（例如 ColorCamera (0)），索引表示创建顺序。 如果存在许多相同类型的节点，请使用 -var 或 --use_variable_names 选项将索引替换为代码中的变量名，以获得更好的清晰度。
Command Line
1pipeline_graph run "python your_script.py" -var
该工具必须知道 pipeline 的变量名。“pipeline”是默认值。使用 -p 或 --pipeline_name 参数指定其他名称。
Command Line
1pipeline_graph run "python your_script.py" -var -p custom_pipeline_name

与图交互

显示图后，您可以执行多项操作来自定义它：
  • 重新排列节点: 如果默认位置不符合您的需求，只需拖放节点即可调整其布局。
  • 重命名节点: 双击节点的名称进行直接编辑。
  • 更改节点外观: 双击节点本身（在名称区域之外），将打开一个窗口，您可以在其中修改其颜色和名称。
  • 上下文菜单选项: 在图上的任意位置右键单击以调出菜单。您可以从这里将图保存为 JSON 文件、加载先前保存的图或访问其他选项。
致谢此工具是使用 jchanvfx 的 NodeGraphQt 框架构建的。