Basic Liquid Handling with Syringe Tool

Overview

This example demonstrates basic liquid handling operations using the syringe tool, including transferring liquid between labware and mixing.

Setup

from science_jubilee.Machine import Machine
from science_jubilee.decks import Deck
from science_jubilee.tools.Syringe import Syringe

# Connect to machine
m = Machine(address='localhost')

# Load deck configuration
deck = m.load_deck('calibrated-deck')

# Load and configure syringe tool
tool_index = 0  # Adjust based on your machine configuration
syringe = Syringe(index=tool_index,
                 name='syringe1',
                 config='10cc_syringe')
m.load_tool(syringe)
m.pickup_tool(syringe)

Loading Labware

# Load labware into specific slots
samples = m.load_labware("greiner_24_wellplate_3300ul", 0)
reservoir = m.load_labware("generic_petri_dish_100ml", 1)

# For petri dish, directly access the single well
reservoir = reservoir["A1"]

# Move to safe height for labware installation
m.move_to(z=150)

Basic Liquid Transfer

Single Transfer

# Transfer 1 mL to a single well
sample_well = samples["A1"]
syringe.transfer(vol=1,
                source=reservoir,
                destination=sample_well)

Transfer with Mixing

# Transfer with mixing after transfer
sample_well = samples["A2"]
syringe.transfer(vol=1,
                source=reservoir,
                destination=sample_well,
                mix_after=(1,2))  # Mix with 1mL, 2 times

Multiple Destination Transfer

# Transfer to multiple wells in a row
destination_wells = list(samples.row_data["C"])
syringe.transfer(vol=1,
                source=reservoir,
                destination=destination_wells,
                mix_after=(1,2))

Notes

• Always ensure the syringe is properly calibrated before liquid handling
• Use appropriate labware for your volume requirements
• Consider using mixing for better solution homogeneity
• Monitor liquid levels in source reservoirs
• Clean and maintain the syringe tool according to manufacturer guidelines