此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 类
  • InstanceSegmentationModel
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包
最后更新
Python API: luxonis_train.config.predefined_models.instance_segmentation.v1.model实例分割模型。

类

InstanceSegmentationModel

实例分割,为每个检测到的对象预测一个掩码。
  • 吞吐量:: 384x512 时的每秒帧数。
    • light: RVC2 上 39,RVC4 上 223
    • medium: RVC2 上 19,RVC4 上 184
    • heavy: RVC2 上 7,RVC4 上 107

方法

init
Python
1def __init__(**kwargs):
从其组件名称初始化模型。所有参数均为仅关键字参数。typechecked 装饰器在运行时检查它们的类型。参数
  • backbone: 注册骨干节点的类名。
  • backbone_variant: 骨干的变体。None 构建不带变体参数的骨干。
  • head: 注册头节点的类名。
  • head_variant: 头的变体。None 构建不带变体参数的头。
  • neck: 注册颈节点的类名。None 将头连接到骨干。
  • neck_variant: 颈的变体。None 构建不带变体参数的颈。
  • loss: 注册损失的类名。模型将其以 1.0 的权重附加到头。
  • metrics: 附加到头的注册指标的类名。字符串命名一个指标。None 不附加指标。
  • main_metric: 标记为主指标的指标。训练器将此指标的最高值检查点保存在 best_val_metric 中。None 获取 metrics 中唯一的名称,或者当 metrics 为空时没有指标。不在 metrics 中的名称不标记任何指标。当配置中没有指标被标记时,ModelConfig.check_main_metric 标记第一个。
  • visualizer: 附加到头的注册可视化器的类名。None 不附加可视化器。
  • confusion_matrix_available: 头是否支持 ConfusionMatrix 指标。子类为其头设置它。
  • backbone_params: 骨干的构造函数参数。freezing 键不会到达构造函数。请参阅注释。
  • neck_params: 颈的构造函数参数,具有相同的 freezing 键。
  • use_neck: 构建颈。即使设置了 neck,False 也会省略颈,并且头从骨干读取。
  • head_params: 头的构造函数参数,具有相同的 freezing 键。
  • loss_params: 损失的构造函数参数。
  • metrics_params: metrics 中每个指标接收的构造函数参数。enable_confusion_matrix 添加的 ConfusionMatrix 指标不接收它们。
  • visualizer_params: 可视化器的构造函数参数。
  • enable_confusion_matrix: 将 ConfusionMatrix 指标附加到头,不带主指标标志。当 confusion_matrix_available 为 False 时,它没有效果。
  • confusion_matrix_params: ConfusionMatrix 指标的构造函数参数。
  • task_name: 头读取的数据集任务。它成为头节点的 task_name。
  • torchmetrics_task: metrics 中每个指标接收的 torchmetrics_task 键的值。None 不添加键。该键进入 metrics_params,因此非空的 metrics_params 字典会就地更改。此包中的任何指标都不读取该键。TorchMetricWrapper 指标读取 task 并将 torchmetrics_task 传递给 torchmetrics,后者会引发 ValueError。请改为在 metrics_params 中设置 task。
  • per_class_metrics: metrics 中每个指标接收的 per_class_metrics 键的值。None 不添加键。当 LuxonisLightningModule 构建指标时,该键成为指标类声明的每个类参数。当类未声明时,模块会删除该键并记录警告。
  • finetuning: 每个组件的微调条目。每个字典都成为该节点的 FinetuningConfig。
  • **kwargs
引发
  • ValueError: 当 main_metric 为 None 且 metrics 命名多个指标时。
get_variants
Python
1def get_variants() -> tuple[str, dict[str, Params]]:
获取默认变体名称和可用变体。默认值为 light。每个变体将 backbone_variant 和 neck_variant 设置为一种大小:
  • light: "n"
  • medium: "s"
  • heavy: "l"
每个变体还将 backbone_params 和 neck_params 中的 weights 设置为 "download"。然后,这两个节点下载并加载其变体的 COCO 检查点。变体不设置 head_params,因此头在没有检查点的情况下启动。配置中给定的 backbone_params 或 neck_params 会替换变体的整个字典。再次设置 weights 以保留 COCO 检查点。返回
  • tuple[str, dict[str, Params]]: "light" 和三个变体及其构造函数参数。