opentrons-absorbance-reader
Opentrons Absorbance Plate Reader Module for Flex - on-deck microplate spectrophotometry with single/multi-wavelength reading (380-740nm in 10nm increments), automated lid control, and CSV data export for ELISA, cell growth, and colorimetric assays
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-absorbance-readerAbout this skill
name: opentrons-absorbance-reader description: Opentrons Absorbance Plate Reader Module for Flex - on-deck microplate spectrophotometry with single/multi-wavelength reading (380-740nm in 10nm increments), automated lid control, and CSV data export for ELISA, cell growth, and colorimetric assays allowed-tools: ["*"]
Opentrons Absorbance Plate Reader Module
Overview
The Absorbance Plate Reader Module is an on-deck microplate spectrophotometer exclusively for Opentrons Flex. It measures light absorbance in 96-well plates at up to 6 wavelengths simultaneously, enabling automated ELISA, cell density measurements, colorimetric assays, and kinetic readings without manual plate transfers.
Core value: Eliminate manual plate reader transfers. Read absorbance mid-protocol to make real-time decisions or collect kinetic data with automated timing and liquid handling.
Platform: Opentrons Flex only (not compatible with OT-2)
When to Use
Use the Absorbance Reader skill when:
- Running ELISA or other colorimetric assays requiring absorbance reading
- Measuring bacterial or cell culture growth (OD600)
- Performing kinetic assays with timed readings
- Collecting multi-wavelength absorbance data
- Protocols requiring real-time decision-making based on absorbance values
- Automating plate-based biochemical assays
Don't use when:
- Working with OT-2 robot (module is Flex-only)
- Need wavelengths outside 380-740nm range
- Require fluorescence or luminescence measurements
Quick Reference
| Operation | Method | Key Parameters |
|---|---|---|
| Load module | protocol.load_module() | "absorbanceReaderV1", "D3" (or A3-C3) |
| Close lid | close_lid() | - |
| Open lid | open_lid() | - |
| Check lid status | is_lid_on() | Returns bool |
| Initialize reader | initialize() | mode, wavelengths, reference_wavelength |
| Read plate | read() | export_filename (optional) |
Available wavelengths: 380-740nm in 10nm increments (e.g., 450nm, 562nm, 600nm, 650nm)
Platform Requirements
Opentrons Flex only
- API version: 2.21 or later
- Compatible deck slots: A3, B3, C3, D3 (column 3 only)
- Staging area: Column 4 (entire column reserved for lid storage)
Important: Cannot load any labware in column 4 (A4, B4, C4, D4) when absorbance reader is present.
Deck Layout
Column 3 (Reader) Column 4 (Staging - Reserved)
┌─────────────┐ ┌─────────────┐
│ A3 │───▶│ A4 (Lid) │
│ Reader │ │ Reserved │
│ Module │ │ │
└─────────────┘ └─────────────┘
Reader occupies column 3 - Detection unit and plate holder Column 4 reserved - Lid staging area (gripper moves lid here when open)
Loading the Module
from opentrons import protocol_api
metadata = {'apiLevel': '2.21'}
requirements = {"robotType": "Flex", "apiLevel": "2.21"}
def run(protocol: protocol_api.ProtocolContext):
# Load Absorbance Reader in column 3
reader = protocol.load_module("absorbanceReaderV1", "D3")
# Note: Column 4 is now unavailable for labware
Compatible slots: A3, B3, C3, D3 Recommended: D3 (bottom-right position for easy gripper access)
Lid Control
The gripper manages lid position automatically:
# Close lid (required before initialization)
reader.close_lid()
# Check lid status
if reader.is_lid_on():
protocol.comment("Lid is on detection unit")
# Open lid (moves to staging area in column 4)
reader.open_lid()
Lid positions:
- Closed: Lid covers detection unit on module
- Open: Lid stored in staging area (column 4)
Critical: Always call close_lid() before initialize(), even if lid is already closed.
Initialization
The initialize() method configures the reader with measurement parameters.
Single Wavelength Reading
Simplest mode - read at one wavelength:
# Initialize for single wavelength
reader.close_lid()
reader.initialize(mode="single", wavelengths=[450])
reader.open_lid()
Use case: OD600 bacterial growth, single-color ELISA
Single Wavelength with Reference
Normalize readings against a reference wavelength:
# Initialize with reference wavelength
reader.close_lid()
reader.initialize(
mode="single",
wavelengths=[450],
reference_wavelength=562
)
reader.open_lid()
Use case: Reduce background noise, normalize for plate artifacts
Multi-Wavelength Reading
Read up to 6 wavelengths simultaneously:
# Initialize for multiple wavelengths
reader.close_lid()
reader.initialize(
mode="multi",
wavelengths=[450, 562, 600, 650]
)
reader.open_lid()
Use case: Multi-analyte assays, spectral analysis, dual-wavelength ELISA
Available wavelengths: 380-740nm in 10nm increments. Common choices:
- 450nm - Blue (common ELISA substrate TMB)
- 562nm - Green (BCA protein assay)
- 600nm - Orange (bacterial growth OD600)
- 650nm - Red (alternative reference wavelength)
Maximum: 6 wavelengths per reading
Reading Plates
Basic Reading
# Move plate to reader with gripper
protocol.move_labware(assay_plate, reader, use_gripper=True)
# Close lid
reader.close_lid()
# Read plate
absorbance_data = reader.read()
# Open lid
reader.open_lid()
# Move plate off reader
protocol.move_labware(assay_plate, "C1", use_gripper=True)
Reading with CSV Export
# Read and export data
absorbance_data = reader.read(export_filename="experiment_001_plate1")
# CSV file saved to robot and accessible via Opentrons App
Export format: CSV file with plate layout, metadata (wavelengths, serial number, timestamps)
Accessing Reading Results
Results are returned as nested dictionary: {wavelength: {well: absorbance}}
# Read plate at 450nm
data = reader.read()
# Access specific well at 450nm
absorbance_a1 = data[450]["A1"]
protocol.comment(f"Well A1 absorbance at 450nm: {absorbance_a1
Read the complete source ↗