opentrons-thermocycler
Opentrons Thermocycler Module - automated PCR thermal cycling with independent block (4-99°C) and lid (37-110°C) temperature control, profile execution, and auto-sealing lid support (GEN2) for high-throughput molecular biology workflows
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-thermocyclerAbout this skill
name: opentrons-thermocycler description: Opentrons Thermocycler Module - automated PCR thermal cycling with independent block (4-99°C) and lid (37-110°C) temperature control, profile execution, and auto-sealing lid support (GEN2) for high-throughput molecular biology workflows allowed-tools: ["*"]
Opentrons Thermocycler Module
Overview
The Opentrons Thermocycler Module automates PCR thermal cycling with precise, independent control of block temperature (4-99°C) and heated lid (37-110°C). Execute complex temperature profiles with automatic cycling, integrate with liquid handling for complete PCR setup automation, and use auto-sealing lids (GEN2) for walk-away workflows.
Core value: Fully automate PCR setup and cycling. Load samples, dispense reagents, seal plates (GEN2), run thermal profiles, and collect products—all without manual intervention.
When to Use
Use the Thermocycler skill when:
- Running PCR amplification protocols
- Performing qPCR or RT-PCR reactions
- Automating DNA/RNA thermal cycling workflows
- Executing multi-step temperature incubations
- Integrating thermal cycling with automated liquid handling
- Setting up high-throughput PCR screening
Don't use when:
- Simple temperature control needed (use Temperature Module for 4-95°C range)
- Shaking/mixing required during incubation (use Heater-Shaker Module)
- Temperature outside 4-99°C range (block) or 37-110°C (lid)
Quick Reference
| Operation | Method | Key Parameters |
|---|---|---|
| Load module | protocol.load_module() | "thermocyclerModuleV2" or "thermocyclerModuleV1" |
| Open lid | open_lid() | - |
| Close lid | close_lid() | - |
| Set lid temperature | set_lid_temperature() | celsius (37-110) |
| Deactivate lid | deactivate_lid() | - |
| Set block temperature | set_block_temperature() | celsius (4-99), hold_time, block_max_volume |
| Execute profile | execute_profile() | steps, repetitions, block_max_volume |
| Deactivate block | deactivate_block() | - |
Platform Compatibility
Both Opentrons Flex and OT-2
Module Generations
- GEN1 - Original thermocycler, OT-2 only
- GEN2 - Improved plate lift mechanism, auto-sealing lid support
API compatibility: Both generations support identical API methods
Deck Position
OT-2: Spans multiple deck slots (typically slots 7, 8, 10, 11)
Flex: Dedicated thermocycler position
Loading:
# No deck slot specified - thermocycler has fixed position
tc_mod = protocol.load_module("thermocyclerModuleV2")
Loading the Module
from opentrons import protocol_api
metadata = {'apiLevel': '2.19'}
def run(protocol: protocol_api.ProtocolContext):
# Load Thermocycler Module (no location - fixed position)
tc_mod = protocol.load_module("thermocyclerModuleV2")
# Load PCR plate
pcr_plate = tc_mod.load_labware("opentrons_96_wellplate_200ul_pcr_full_skirt")
Module versions:
"thermocyclerModuleV1"- GEN1"thermocyclerModuleV2"- GEN2 (recommended)
Lid Control
Basic Lid Operations
# Open lid for pipette access
tc_mod.open_lid()
# Close lid for thermal cycling
tc_mod.close_lid()
Important for gripper (Flex):
- Always open lid before gripper operations
- Close lid only after plate is seated on thermocycler
Heated Lid
The heated lid prevents condensation during thermal cycling:
# Set lid temperature (blocks until reached)
tc_mod.set_lid_temperature(celsius=105)
# Run thermal profile
# ... cycling ...
# Turn off lid heater
tc_mod.deactivate_lid()
Lid temperature range: 37-110°C
Typical settings:
- Standard PCR: 105°C
- RT-PCR: 100-105°C
- Custom protocols: Match or exceed highest block temperature + 5-10°C
Note: Lid temperature is independent of block temperature and profiles.
Block Temperature Control
Basic Block Temperature
# Set block temperature and wait
tc_mod.set_block_temperature(
temperature=95,
hold_time_seconds=180, # Hold for 3 minutes
block_max_volume=50 # Volume in wells (µL)
)
# Block automatically maintains temperature for hold_time
Block temperature range: 4-99°C
Parameters:
temperature- Target temperature in °C (required)hold_time_seconds- Duration to hold at temperaturehold_time_minutes- Alternative duration in minutesblock_max_volume- Sample volume in µL (default: 25µL)
Hold Time Behavior
With hold_time: Protocol waits at temperature for specified duration
# Wait 5 minutes at 95°C
tc_mod.set_block_temperature(
temperature=95,
hold_time_minutes=5,
block_max_volume=50
)
# Protocol continues after 5 minutes
Without hold_time: Set temperature and continue immediately
# Set to 4°C and proceed (no hold)
tc_mod.set_block_temperature(temperature=4)
# Can perform other operations while maintaining 4°C
Block Max Volume
Specify sample volume for improved temperature accuracy:
# 50µL reactions
tc_mod.set_block_temperature(
temperature=72,
hold_time_minutes=10,
block_max_volume=50 # Optimizes heating/cooling for 50µL
)
Default: 25µL if not specified
Why it matters: Algorithm adjusts for thermal mass of liquid to ensure accurate sample temperature.
Temperature Profiles
Automate repeated temperature cycles for PCR:
Defining a Profile
# PCR profile: Denature → Anneal → Extend
pcr_profile = [
{"temperature": 95, "hold_time_seconds": 30}, # Denaturation
{"temperature": 57, "hold_time_seconds": 30}, # Annealing
{"temperature": 72, "hold_time_seconds": 60} # Extension
]
Profile structure: List of dictionaries with temperature and hold_time_seconds
Executing a Profile
# Run profile for 30 cycles
tc_mod.execute_profile(
steps=pcr_profile,
repetitions=30,
block_max_volume=50
)
**Parameters:
Read the complete source ↗