SuperAPI AI 工具集

opentrons-gripper

通用与其它

查看项目

更新于 10-27 12:33

技能介绍

用途

Opentrons Flex Gripper 用于在 Opentrons Flex 平台上实现实验室耗材的全自动移动,无需人工干预。它可以在甲板槽位、硬件模块、废弃物滑槽和甲板外存储之间搬运微孔板、储液槽和吸头盒,并支持精确的定位和可选的偏移调整。其核心价值在于消除协议执行过程中的人工移板操作,自动在模块之间移动耗材,从而支持复杂的多步骤工作流而无需暂停等待用户介入。

平台要求

  • 仅适用于 Opentrons Flex,不适用于 OT-2。
  • API 版本:2.15 及以上(支持抓板器)。
  • 机器人类型:必须指定 "robotType": "Flex"。

主要能力

  • 在甲板槽位之间移动耗材。
  • 将耗材移动到硬件模块(Temperature Module、Heater-Shaker、Magnetic Block、Thermocycler、Absorbance Reader 等)。
  • 将耗材丢入废弃物滑槽。
  • 将耗材移出甲板(OFF_DECK)以释放空间,之后可再移回。
  • 通过 pick_up_offset 和 drop_offset 调整取放位置,单位为毫米,坐标轴 x 为左(-)/右(+),y 为后(-)/前(+),z 为下(-)/上(+)。
  • 设置 use_gripper=False 可暂停协议,由用户手动移动耗材。

使用方式

核心方法为 protocol.move_labware()。基本用法示例:

from opentrons import protocol_api

metadata = {'apiLevel': '2.19'}
requirements = {"robotType": "Flex", "apiLevel": "2.19"}

def run(protocol: protocol_api.ProtocolContext):
    source_plate = protocol.load_labware("corning_96_wellplate_360ul_flat", "C1")
    protocol.move_labware(
        labware=source_plate,
        new_location="D2",
        use_gripper=True
    )

甲板槽位支持坐标格式(如 "A1"、"B2",Flex 推荐)和数字格式(如 "1"、"2",OT-2 旧格式仍兼容)。

移动到模块:

temp_mod = protocol.load_module("temperature module gen2", "D1")
plate = protocol.load_labware("corning_96_wellplate_360ul_flat", "C2")
protocol.move_labware(labware=plate, new_location=temp_mod, use_gripper=True)

移动到废弃物滑槽:

waste_chute = protocol.load_waste_chute()
protocol.move_labware(labware=used_plate, new_location=waste_chute, use_gripper=True)

移出甲板:

from opentrons.protocol_api import OFF_DECK
protocol.move_labware(labware=archive_plate, new_location=OFF_DECK, use_gripper=True)

位置偏移示例:

protocol.move_labware(
    labware=plate,
    new_location="D2",
    use_gripper=True,
    pick_up_offset={"x": 0, "y": 0, "z": 2},
    drop_offset={"x": 0, "y": 0, "z": 1}
)

手动移动替代:

protocol.move_labware(labware=delicate_plate, new_location="D3", use_gripper=False)

模块集成注意事项

  • Heater-Shaker:在抓板器操作前必须打开锁存器(open_labware_latch),移动后再关闭锁存器进行振荡。
  • Thermocycler:在抓板器操作前必须打开盖子(open_lid),移动后再关闭盖子运行 PCR。
  • Absorbance Reader:在抓板器操作前必须打开盖子(open_lid),读取时关闭盖子。
  • Magnetic Block:可直接移动,用于磁珠分离。
  • Temperature Module:可直接移动,设置温度后延时,再移出。

适用场景

  • 在甲板位置之间自动移动耗材。
  • 在硬件模块之间转移微孔板。
  • 将微孔板装载到 Absorbance Reader 或 Thermocycler。
  • 将耗材丢入废弃物滑槽。
  • 将耗材移入或移出甲板外存储。
  • 自动化原本需要人工介入的工作流。
  • 多模块工作流(如 DNA 提取:裂解、磁珠结合、洗脱)。
  • 多板顺序处理(如依次读取多块板)。
  • 动态甲板空间管理(将不用的耗材移出甲板以释放空间)。

限制

  • 仅适用于 Opentrons Flex,不适用于 OT-2。
  • 抓板器只能移动具有兼容几何特征的耗材,例如带有抓板器兼容边缘、侧面抓取特征或经 Opentrons 认证的耗材。非常小的试管、形状不规则的容器、无抓取特征的自定义耗材以及易碎物品可能无法抓取。
  • 非兼容耗材应使用 use_gripper=False 手动移动,或使用适配器。
  • 移动到已占用的位置会报错,需先移走原有耗材。
  • 忘记指定 use_gripper=True 时默认 use_gripper=False,协议会暂停等待手动操作。
  • 移动前需确保模块盖子或锁存器已打开,否则会报碰撞错误。
  • 使用 OFF_DECK 需导入 OFF_DECK 常量,并跟踪耗材位置。

最佳实践

  • 在抓板器移动前打开模块盖子或锁存器。
  • 使用描述性变量名跟踪耗材。
  • 先在模拟环境中测试抓板器移动。
  • 添加协议注释说明移动原因。
  • 规划甲板布局,减少不必要的移动。
  • 策略性使用 OFF_DECK 释放空间。
  • 部署前检查耗材兼容性。
  • 谨慎使用偏移,仅在必要时调整。
  • 准备手动回退方案(use_gripper=False)用于故障排查。
  • 使用废弃物滑槽处理用过的耗材。