opentrons-heater-shaker
Opentrons Heater-Shaker Module - temperature control (37-95°C) with orbital mixing (200-3000 rpm) for cell culture, enzymatic reactions, and sample preparation requiring simultaneous heating and agitation
jkitchin · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add jkitchin/knowhow --skill opentrons-heater-shakerAbout this skill
name: opentrons-heater-shaker description: Opentrons Heater-Shaker Module - temperature control (37-95°C) with orbital mixing (200-3000 rpm) for cell culture, enzymatic reactions, and sample preparation requiring simultaneous heating and agitation allowed-tools: ["*"]
Opentrons Heater-Shaker Module
Overview
The Heater-Shaker Module combines precise temperature control (37-95°C) with orbital shaking (200-3000 rpm) for automated protocols requiring simultaneous heating and mixing. Ideal for cell culture incubation, enzymatic reactions, bacterial transformations, and any workflow needing temperature-controlled agitation.
Core value: Automate temperature-sensitive mixing protocols with reproducible timing and conditions. Replace manual incubator transfers with on-deck temperature control.
When to Use
Use the Heater-Shaker skill when:
- Performing enzymatic reactions requiring temperature control and mixing
- Incubating cell cultures or bacterial transformations
- Conducting ELISA washing steps with temperature control
- Running temperature-sensitive binding or hybridization reactions
- Protocols requiring precise timing of heating + mixing cycles
- Resuspending beads or particles with controlled agitation
Don't use when:
- Only temperature control needed (use Temperature Module instead)
- Only mixing needed (consider manual shaking or alternative approaches)
- Temperature outside 37-95°C range (or <1.5°C above ambient)
Quick Reference
| Operation | Method | Key Parameters |
|---|---|---|
| Load module | protocol.load_module() | "heaterShakerModuleV1", location |
| Set temperature (blocking) | set_and_wait_for_temperature() | celsius (37-95) |
| Set temperature (non-blocking) | set_target_temperature() | celsius |
| Wait for temperature | wait_for_temperature() | - |
| Start shaking (blocking) | set_and_wait_for_shake_speed() | rpm (200-3000) |
| Stop shaking | deactivate_shaker() | - |
| Stop heating | deactivate_heater() | - |
| Open latch | open_labware_latch() | - |
| Close latch | close_labware_latch() | - |
| Check status | .current_temperature, .current_speed | - |
Platform Compatibility
Opentrons Flex
- Allowed slots: Column 1 or Column 3 (A1, B1, C1, D1, A3, B3, C3, D3)
- No adjacent restrictions - Full deck flexibility
OT-2
- Allowed slots: 1, 3, 4, 6, 7, or 10
- Adjacent slot restrictions:
- Keep adjacent slots clear or use only low-profile labware (<53mm height)
- 8-channel pipettes cannot pipette in adjacent slots (tip racks OK if front/back)
Loading the Module
Basic Loading
from opentrons import protocol_api
metadata = {'apiLevel': '2.19'}
def run(protocol: protocol_api.ProtocolContext):
# Load Heater-Shaker in deck slot
hs_mod = protocol.load_module("heaterShakerModuleV1", location="D1") # Flex
# hs_mod = protocol.load_module("heaterShakerModuleV1", location="1") # OT-2
Loading Labware with Adapters
Two-step approach (recommended):
# Load adapter first, then labware
hs_adapter = hs_mod.load_adapter("opentrons_96_flat_bottom_adapter")
hs_plate = hs_adapter.load_labware("nest_96_wellplate_200ul_flat")
Available adapters:
opentrons_96_flat_bottom_adapter- Universal flat-bottom platesopentrons_96_pcr_adapter- PCR plates and stripsopentrons_96_deep_well_adapter- Deep-well platesopentrons_universal_flat_adapter- Custom flat-bottom labware
Pre-configured combinations (legacy):
# Load labware directly (adapter implicit)
hs_plate = hs_mod.load_labware("nest_96_wellplate_200ul_flat")
Latch Control
The labware latch MUST be closed for shaking operations.
# Close latch before shaking
hs_mod.close_labware_latch()
# Open latch for pipetting or gripper access
hs_mod.open_labware_latch()
Important:
- Pipetting is possible with latch open or closed
- Shaking requires latch closed (method will error if open)
- Gripper access requires latch open
- Always open latch before gripper operations
Temperature Control
Blocking Temperature Control
Protocol waits until temperature is reached before continuing:
# Set temperature and wait
hs_mod.set_and_wait_for_temperature(celsius=37)
# Perform operations at target temperature
protocol.delay(minutes=10)
# Turn off heater
hs_mod.deactivate_heater()
Temperature range:
- Minimum: The greater of 37°C or ambient temperature + 1.5°C (the Heater-Shaker cannot actively cool)
- Maximum: 95°C
- Resolution: 1°C
Non-Blocking Temperature Control
Set target temperature and continue with other operations while heating:
# Start heating (non-blocking)
hs_mod.set_target_temperature(celsius=75)
# Perform pipetting while heating
pipette.transfer(100, source, hs_plate.columns()[0])
# Wait for temperature before critical step
hs_mod.wait_for_temperature()
# Now at target temperature
protocol.delay(minutes=5)
Use case: Parallel pipetting during heating to save time.
Checking Temperature Status
# Get current temperature
current_temp = hs_mod.current_temperature
# Log temperature
protocol.comment(f"Heater-Shaker at {current_temp}°C")
Shaking Control
Basic Shaking
# Close latch first (required)
hs_mod.close_labware_latch()
# Start shaking and wait to reach speed
hs_mod.set_and_wait_for_shake_speed(rpm=500)
# Shake for specific duration
protocol.delay(minutes=5)
# Stop shaking
hs_mod.deactivate_shaker()
# Open latch for pipetting access
hs_mod.open_labware_latch()
Speed range:
- Minimum: 200 rpm
- Maximum: 3000 rpm
Checking Shake Speed
# Get current speed
current_speed = hs_mod.current_speed
if current_speed > 0:
protocol.comment(f"Shaking at {current_speed} rpm")
Shake Speed Guidelines
Recommended speeds by application:
- Gentle mixing: 200-500 r