opentrons-temperature-module
Opentrons Temperature Module - precise heating and cooling (4-95°C) for sample storage, enzyme reactions, and temperature-sensitive protocols with aluminum block adapters for plates, tubes, and PCR strips
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-temperature-moduleAbout this skill
name: opentrons-temperature-module description: Opentrons Temperature Module - precise heating and cooling (4-95°C) for sample storage, enzyme reactions, and temperature-sensitive protocols with aluminum block adapters for plates, tubes, and PCR strips allowed-tools: ["*"]
Opentrons Temperature Module
Overview
The Opentrons Temperature Module provides precise temperature control (4-95°C) for maintaining samples at specific temperatures during automated protocols. Ideal for keeping reagents cold, pre-warming reaction components, temperature-sensitive incubations, and any workflow requiring stable thermal conditions without mixing.
Core value: Eliminate ice buckets and water baths. Maintain precise, reproducible temperatures on-deck for reagents, samples, and reaction components throughout your protocol.
When to Use
Use the Temperature Module skill when:
- Keeping reagents cold during protocol (e.g., enzymes at 4°C)
- Pre-warming reaction components (e.g., buffers at 37°C)
- Maintaining samples at specific temperatures
- Temperature-sensitive enzyme reactions without mixing
- Cooling samples after thermal processing
- Any protocol requiring stable temperature control (4-95°C)
Don't use when:
- Need mixing/shaking during temperature control (use Heater-Shaker Module)
- Require PCR thermal cycling (use Thermocycler Module)
- Temperature outside 4-95°C range
- Precise temperature ramping or cycling needed
Quick Reference
| Operation | Method | Key Parameters |
|---|---|---|
| Load module | protocol.load_module() | "temperature module gen2", location |
| Set temperature | set_temperature() | celsius (4-95) |
| Get current temperature | .temperature | Read-only property |
| Check status | .status | Returns "holding at target" or "idle" |
| Deactivate | deactivate() | - |
Platform Compatibility
Both Opentrons Flex and OT-2
Module Generations
- GEN1 - Original temperature module
- GEN2 - Improved cooling performance, better isolation (recommended)
Key GEN2 improvements:
- Plastic insulation around plate
- Shrouds for aluminum blocks
- Better cooling when sharing deck with running Thermocycler
- Same API as GEN1
Loading the Module
from opentrons import protocol_api
metadata = {'apiLevel': '2.19'}
def run(protocol: protocol_api.ProtocolContext):
# Load Temperature Module GEN2
temp_mod = protocol.load_module("temperature module gen2", "D1") # Flex
# temp_mod = protocol.load_module("temperature module gen2", "4") # OT-2
# Load labware on module
cold_plate = temp_mod.load_labware("opentrons_96_aluminumblock_generic_pcr_strip_200ul")
Module versions:
"temperature module gen2"- GEN2 (recommended)"temperatureModuleV1"- GEN1 (legacy)
Deck slot: Any compatible slot (Flex: A1-D3, OT-2: 1-11)
Loading Labware
Standalone Adapters (API 2.15+)
Recommended approach - Load adapter first, then labware:
# 96-well aluminum block
temp_block = temp_mod.load_adapter("opentrons_96_well_aluminum_block")
sample_plate = temp_block.load_labware("opentrons_96_wellplate_200ul_pcr_full_skirt")
Available adapters:
| Adapter Name | Compatible Labware |
|---|---|
opentrons_96_well_aluminum_block | 96-well plates, PCR plates |
opentrons_aluminum_flat_bottom_plate | Flat-bottom plates |
opentrons_96_deep_well_temp_mod_adapter | Deep-well plates |
Block-and-Tube Combinations
For tube racks with aluminum blocks:
# 24-well block with various tube types
tubes_nest = temp_mod.load_labware("opentrons_24_aluminumblock_nest_1.5ml_snapcap")
tubes_generic = temp_mod.load_labware("opentrons_24_aluminumblock_generic_2ml_screwcap")
Legacy Block-and-Plate Combinations
# Pre-configured combinations (older API versions)
plate_combo = temp_mod.load_labware("opentrons_96_aluminumblock_biorad_wellplate_200ul")
Recommendation: Use standalone adapters (API 2.15+) for better flexibility.
Temperature Control
Setting Temperature
# Set temperature and wait until reached
temp_mod.set_temperature(celsius=4)
# Protocol waits here until 4°C is reached
# Perform operations at target temperature
pipette.transfer(100, cold_reagent, dest_plate.wells())
Temperature range: 4-95°C (1°C resolution)
Behavior: Protocol execution blocks (waits) until target temperature is reached.
Temperature Status
# Get current temperature
current_temp = temp_mod.temperature
protocol.comment(f"Module at {current_temp}°C")
# Check status
status = temp_mod.status
# Returns: "holding at target" or "idle"
if status == "holding at target":
protocol.comment("Temperature stable, proceeding")
Deactivating
# Turn off temperature control
temp_mod.deactivate()
Important: Module does not automatically deactivate at protocol end. Must be manually turned off via Opentrons App if protocol completes or is cancelled.
Common Patterns
Keeping Reagents Cold
# Keep enzymes and master mix cold throughout protocol
temp_mod = protocol.load_module("temperature module gen2", "D1")
reagent_block = temp_mod.load_adapter("opentrons_24_aluminumblock_nest_1.5ml_snapcap")
# Set to 4°C before starting
temp_mod.set_temperature(4)
# Reagents stay cold during entire protocol
pipette.transfer(10, reagent_block["A1"], dest_plate.wells())
# ... rest of protocol ...
# Turn off at end
temp_mod.deactivate()
Pre-Warming Reaction Components
# Pre-warm buffer to 37°C
temp_mod = protocol.load_module("temperature module gen2", "C2")
warm_block = temp_mod.load_adapter("opentrons_96_well_aluminum_block")
warm_plate = warm_block.load_labware("corning_96_wellplate_360ul_flat")
# Set to reaction temperature
temp_mod.set_temperature(37)
# Use pre-warmed components
pipette.transfer(50, warm_plate["A1"], reaction_plate
Read the complete source ↗