opentrons-gripper
Opentrons Flex Gripper - automated labware movement between deck locations, modules, waste chute, and off-deck storage with precise positioning and offset control for hands-free plate transfers
jkitchin · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add jkitchin/knowhow --skill opentrons-gripper技能说明
name: opentrons-gripper description: Opentrons Flex Gripper - automated labware movement between deck locations, modules, waste chute, and off-deck storage with precise positioning and offset control for hands-free plate transfers allowed-tools: ["*"]
Opentrons Flex Gripper
Overview
The Opentrons Flex Gripper enables fully automated labware movement without manual intervention. It moves plates, reservoirs, and tip racks between deck slots, hardware modules, trash/waste chute, and off-deck storage with precise positioning and optional offset adjustments.
Core value: Eliminate manual plate transfers during protocols. Automatically move labware between modules, enabling complex multi-step workflows without pausing for user intervention.
Platform: Opentrons Flex only (not available on OT-2)
When to Use
Use the Gripper skill when:
- Moving labware between deck locations automatically
- Transferring plates between hardware modules (Temperature, Heater-Shaker, Magnetic Block, etc.)
- Loading plates onto Absorbance Reader or Thermocycler
- Disposing labware in waste chute
- Moving labware to/from off-deck storage
- Automating workflows that would otherwise require manual intervention
Don't use when:
- Working with OT-2 robot (gripper is Flex-only)
- Labware is not grippable (lacks compatible geometry/features)
- Manual control is preferred for delicate operations
- Pipette can accomplish the task without moving entire labware
Quick Reference
| Operation | Method | Key Parameters |
|---|---|---|
| Move labware | protocol.move_labware() | labware, new_location, use_gripper=True |
| Move with offsets | protocol.move_labware() | pick_up_offset, drop_offset |
| Move to module | protocol.move_labware() | labware, module_object, use_gripper=True |
| Dispose in waste | protocol.move_labware() | labware, waste_chute, use_gripper=True |
| Move off-deck | protocol.move_labware() | labware, OFF_DECK, use_gripper=True |
| Manual movement | protocol.move_labware() | use_gripper=False (pauses for user) |
Platform Requirements
Opentrons Flex only
- API version: 2.15+ (gripper support)
- Robot type: Must specify
"robotType": "Flex"
Basic Usage
Moving Between Deck Slots
from opentrons import protocol_api
metadata = {'apiLevel': '2.19'}
requirements = {"robotType": "Flex", "apiLevel": "2.19"}
def run(protocol: protocol_api.ProtocolContext):
# Load labware
source_plate = protocol.load_labware("corning_96_wellplate_360ul_flat", "C1")
# Move labware to new deck slot
protocol.move_labware(
labware=source_plate,
new_location="D2",
use_gripper=True
)
Deck slot formats (both work):
- Coordinate format: "A1", "B2", "C3", "D1" (preferred for Flex)
- Numeric format: "1", "2", "3", etc. (OT-2 legacy, still compatible)
Moving to Hardware Module
# Load module and labware
temp_mod = protocol.load_module("temperature module gen2", "D1")
plate = protocol.load_labware("corning_96_wellplate_360ul_flat", "C2")
# Move plate to temperature module
protocol.move_labware(
labware=plate,
new_location=temp_mod,
use_gripper=True
)
Moving to Waste Chute
# Load waste chute
waste_chute = protocol.load_waste_chute()
# Dispose of used plate
protocol.move_labware(
labware=used_plate,
new_location=waste_chute,
use_gripper=True
)
Moving Off-Deck
from opentrons.protocol_api import OFF_DECK
# Move labware off the deck (to storage)
protocol.move_labware(
labware=archive_plate,
new_location=OFF_DECK,
use_gripper=True
)
# Later: bring back from off-deck storage
protocol.move_labware(
labware=archive_plate,
new_location="B3",
use_gripper=True
)
Use case: Free up deck space by temporarily storing labware off-deck
Position Offsets
Fine-tune pickup and drop positions with offset vectors:
Basic Offset Syntax
protocol.move_labware(
labware=plate,
new_location="D2",
use_gripper=True,
pick_up_offset={"x": 0, "y": 0, "z": 2}, # Lift 2mm higher when picking up
drop_offset={"x": 0, "y": 0, "z": 1} # Place 1mm higher when dropping
)
Offset units: Millimeters Coordinates:
- x: Left (-) / Right (+)
- y: Back (-) / Front (+)
- z: Down (-) / Up (+)
When to Use Offsets
Pick-up offset:
- Labware sits higher/lower than expected
- Adapters or custom labware with non-standard height
- Ensure proper gripper engagement
Drop-off offset:
- Ensure proper seating on module or adapter
- Accommodate non-standard landing surfaces
- Avoid collision with deck features
Example with Custom Labware
# Custom deep-well plate requires higher pickup
custom_plate = protocol.load_labware("custom_deepwell_96", "C1")
protocol.move_labware(
labware=custom_plate,
new_location="D1",
use_gripper=True,
pick_up_offset={"x": 0, "y": 0, "z": 3}, # Pickup 3mm higher
drop_offset={"x": 0, "y": 0, "z": 0} # Standard drop
)
Manual Movement Alternative
Set use_gripper=False to pause protocol for user to manually move labware:
# Pause for manual movement
protocol.move_labware(
labware=delicate_plate,
new_location="D3",
use_gripper=False # Protocol pauses, user moves plate manually
)
Use case: Delicate labware, non-grippable items, or troubleshooting
Module Integration
Temperature Module
temp_mod = protocol.load_module("temperature module gen2", "D1")
plate = protocol.load_labware("corning_96_wellplate_360ul_flat", "C2")
# Move to temperature module
protocol.move_labware(plate, temp_mod, use_gripper=True)
# Set temperature
temp_mod.set_temperature(4)
protocol.delay(minutes=5)
# Move off module
protocol.move_labware(plate, "C2", use_gripper=True)
temp_mod.deactivate()
Heater-Shaker Module
Critical: Open labware lat
阅读完整来源 ↗