# node

Python API: `depthai_nodes.node`

用于推理、后处理和主机端消息处理的管道节点。

使用 `pipeline.create(...)` 创建节点并连接它们的输入和输出端口。此包中的类将原生 DepthAI 推理和解析器与 Python 后处理、图像实用程序和自定义消息处理集成在一起。

目录

内容

 * [推理和解析器选择](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)
 * [主机解析器目录](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md) *
   [目标检测](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)
    * [分类和分割](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)
    * [关键点和特征匹配](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)
    * [其他输出](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)
 * [实用节点](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md) *
   [图像和深度处理](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)
    * [检测处理](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)
    * [消息处理和上传](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)
 * [扩展包](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node.md)

## 推理和解析器选择

[ParsingNeuralNetwork](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsing_neural_network.md)
构建神经网络和 NN Archive 指定的原生 DepthAI 解析器。它通过 `out` 和 `getOutput()`
以及底层网络的直通流公开解析器输出。[HostParsingNeuralNetwork](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/host_parsing_neural_network.md)
提供相同的接口，并使用此包中的 Python
解析器实现。[ExtendedNeuralNetwork](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/extended_neural_network.md)
在 `ParsingNeuralNetwork` 周围添加了输入大小调整和可选的坐标重映射。

[ParserGenerator](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parser_generator.md)
从 NN Archive 头元数据创建解析器。其 `hostOnly=False` 默认选择原生 DepthAI 解析器；`hostOnly=True` 选择此包的实现。此标志选择实现，而不是执行它的设备。原生解析器的放置还取决于 DepthAI
和设备平台。在 RVC2 上，此包报告非检测原生解析器和带掩码输出的检测解析器在主机上运行。大多数原生解析器在 `dai.beta.node` 中；检测和分割解析器在 `dai.node` 中。

`ParsingNeuralNetwork` 通过 `nnSource` 接受存档对象、模型动物园引用或 `dai.NNModelDescription`。对于本地存档，首先构造
`dai.NNArchive(path)`。`ExtendedNeuralNetwork` 通过 `nnSource` 接受相同的源形式。有关接受的输入和配置，请参阅
[ParsingNeuralNetwork.build](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsing_neural_network.md)
和
[ExtendedNeuralNetwork.build](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/extended_neural_network.md)。

> **示例**
> 从模型动物园引用构建原生分割推理：

```text
import depthai as dai
from depthai_nodes.node import ParsingNeuralNetwork

with dai.Pipeline() as pipeline:
    camera = pipeline.create(dai.node.Camera).build()
    nn = pipeline.create(ParsingNeuralNetwork).build(
        camera,
        nnSource="luxonis/mediapipe-selfie-segmentation:256x144",
    )
    results = nn.out.createOutputQueue()
    pipeline.start()
    mask = results.get()
```

将 `ParsingNeuralNetwork` 替换为 `HostParsingNeuralNetwork` 以选择主机解析器实现。

## 主机解析器目录

主机解析器消耗 `dai.NNData` 并发出原生 DepthAI 消息。模型元数据必须与解析器预期的张量名称和形状匹配。此目录中的所有解析器都可以从 `depthai_nodes.node` 或 `depthai_nodes.node.parsers`
导入。

### 目标检测

 * [DetectionParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/detection.md)：通用边界框和分数张量。
 * [YOLOExtendedParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/yolo.md)：支持
   YOLO 检测、姿态和实例分割变体。
 * [YuNetParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/yunet.md)
   和
   [SCRFDParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/scrfd.md)：人脸检测。
 * [MPPalmDetectionParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/mediapipe_palm_detection.md)：MediaPipe
   手掌检测。
 * [PPTextDetectionParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/ppdet.md)：PaddleOCR
   文本检测。
 * [RFDETRParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/rf_detr.md)：RF-DETR
   检测和可选实例掩码。

这些解析器发出 `dai.ImgDetections`，其中包含模型支持的字段。

### 分类和分割

 * [ClassificationParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/classification.md)：`dai.beta.Classifications`
   中的类名和分数。
 * [ClassificationSequenceParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/classification_sequence.md)：`dai.beta.Classifications`
   中的每步分类，包括文本识别。
 * [SegmentationParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/segmentation.md)：`dai.SegmentationMask`
   中的语义掩码。
 * [FastSAMParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/fastsam.md)：`dai.SegmentationMask`
   中的提示分割。

### 关键点和特征匹配

 * [KeypointParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/keypoints.md)：2D
   或 3D 关键点张量。
 * [HRNetParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/hrnet.md)：来自热图的身体关键点。
 * [SuperAnimalParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/superanimal_landmarker.md)：来自热图的动物地标。

这些关键点解析器发出
`dai.beta.Keypoints`。[XFeatMonoParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/xfeat.md)
从一个源发出
`dai.TrackedFeatures`；[XFeatStereoParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/xfeat.md)
匹配两个源之间的特征并发出成对的 `dai.TrackedFeatures`。

### 其他输出

 * [LaneDetectionParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/lane_detection.md)：`dai.beta.Clusters`
   中的 UFLD 车道点。
 * [MLSDParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/mlsd.md)：`dai.beta.Lines`
   中的线检测。
 * [EmbeddingsParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/embeddings.md)：直通
   `dai.NNData` 嵌入输出。
 * [RegressionParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/regression.md)：`dai.beta.Predictions`
   中的回归值。
 * [MapOutputParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/map_output.md)：`dai.beta.Map2D`
   中的数字地图，包括深度估计。
 * [ImageOutputParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/image_output.md)：`dai.ImgFrame`
   中的图像到图像结果。

## 实用节点

### 图像和深度处理

 * [ApplyColormap](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/apply_colormap.md)：将
   2D 地图和掩码着色为 `dai.ImgFrame` 消息。
 * [ApplyDepthColormap](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/apply_depth_colormap.md)：使用百分位归一化处理深度或视差；非正值不参与归一化并显示为黑色。
 * [DepthMerger](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/depth_merger.md)：使用设备校准将
   2D 检测和对齐深度组合成 `dai.SpatialImgDetections`。
 * [HostSpatialsCalc](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/host_spatials_calc.md)：在主机上从深度区域计算空间坐标。
 * [FrameCropper](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/frame_cropper.md)：使用检测或
   `dai.ImageManipConfig` 消息组裁剪和调整帧大小，每裁剪一次发出一帧。
 * [Tiling](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/tiling.md)：生成平铺的
   `dai.ImageManipConfig` 组并接受运行时配置更改。
 * [ImgFrameOverlay](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/img_frame_overlay.md)：混合两个
   `dai.ImgFrame` 流。

### 检测处理

 * [CoordinatesMapper](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/coordinates_mapper.md)：将支持的消息从裁剪或平铺映射到目标图像变换，包括地图和掩码像素。
 * [ImgDetectionsFilter](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/img_detections_filter.md)：按标签、置信度或区域过滤原生检测，可选抑制、排序和计数限制。
 * [InstanceToSemanticMask](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/instance_to_semantic_mask.md)：用检测类标签替换实例
   ID。

> **示例**
> 使用现有管道和生成检测的 `nn.out` 流：

```text
from depthai_nodes.node import ImgDetectionsFilter

filtered = pipeline.create(ImgDetectionsFilter).build(nn.out)
filtered.keepLabels([0]).minConfidence(0.5).sortByConfidence().takeFirstK(10)
```

这将保留类别 0 的检测，按置信度降序排列，并最多保留十个。`rejectLabels([0])` 则排除类别 0。

### 消息处理和上传

 * [GatherData](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/gather_data.md)：为每个引用收集可配置数量的时间戳匹配消息，并将其收集到
   [depthai_nodes.message.GatheredData](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/message/gathered_data.md)
   中。默认计数是引用消息中的检测数量。
 * [MessageCollector](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/message_collector.md)：在半帧间隔内批量处理消息，将其收集到
   [depthai_nodes.message.Collection](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/message/collection.md)
   中，当较新的时间戳超出匹配窗口时发出。
 * [SnapsUploader](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/snaps_uploader.md)：接受
   [depthai_nodes.message.SnapData](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/message/snap_data.md)
   并将上传和可选的离线缓存委托给原生 EventsManager。

## 扩展包

[BaseHostNode](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/base_host_node.md)
为同步 `process()`
回调提供平台特定的图像格式和日志记录。[BaseThreadedHostNode](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/base_threaded_host_node.md)
为具有自己的 `run()`
循环的节点提供相同的设置。[BaseParser](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers/base_parser.md)
定义了通用的 NNData 输入和解析消息输出接口。

解析器实现将张量提取、数组计算和消息发出分开。在发出结果时，记录处理助手上的张量布局和坐标约定，并保留输入元数据。

## 子页面

 * [parsers](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsers.md)
 * [utils](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/utils.md)
 * [apply_colormap](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/apply_colormap.md)
 * [apply_depth_colormap](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/apply_depth_colormap.md)
 * [base_host_node](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/base_host_node.md)
 * [base_threaded_host_node](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/base_threaded_host_node.md)
 * [coordinates_mapper](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/coordinates_mapper.md)
 * [depth_merger](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/depth_merger.md)
 * [extended_neural_network](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/extended_neural_network.md)
 * [frame_cropper](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/frame_cropper.md)
 * [gather_data](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/gather_data.md)
 * [host_parsing_neural_network](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/host_parsing_neural_network.md)
 * [host_spatials_calc](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/host_spatials_calc.md)
 * [img_detections_filter](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/img_detections_filter.md)
 * [img_frame_overlay](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/img_frame_overlay.md)
 * [instance_to_semantic_mask](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/instance_to_semantic_mask.md)
 * [message_collector](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/message_collector.md)
 * [parser_generator](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parser_generator.md)
 * [parsing_neural_network](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/parsing_neural_network.md)
 * [snaps_uploader](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/snaps_uploader.md)
 * [tiling](/software-v3/ai-inference/inference/depthai-nodes/depthai-nodes-api-reference/node/tiling.md)
