Large Volume Handling

Large Volume Handling#

Pipetting robots have a maximum pipetting volume that they hand transfer in one step. At the same time the EVOware and Fluent Control require the user to break down liquid transfers that exceed this volume into smaller steps.

This example shows how robotools automagically splits up large volumes, so you can create complex workflows without bothering about large volume handling.

import robotools

Defining labwares#

For this example, we’ll prepare six falcon tubes with different glucose concentrations. We start by creating the Labware/Trough objects corresponding to the labwares on the worktable:

water = robotools.Trough("water", 6, 1, min_volume=5000, max_volume=100_000, initial_volumes=20_000)
glucose = robotools.Trough("glucose", 6, 1, min_volume=5000, max_volume=100_000, initial_volumes=20_000)

# We'll prepare 6 Falcons with different glucose concentrations
falcons = robotools.Labware("falcons", 6, 1, min_volume=50, max_volume=15_000)

print(water)
print(glucose)
print(falcons)
water
[[20000.]]
glucose
[[20000.]]
falcons
[[0.]
 [0.]
 [0.]
 [0.]
 [0.]
 [0.]]

Large Volume Handling#

With 1000 µL diluters, a Freedom EVO can handle about 950 µL. The exact number depends on the liquid class, but potentially also on device-specifics such as tubing lengths.

By default, a worklist is initialized with max_volume=950 and auto_split=True, resuilting in automatic splitting of pipetting volumes larger than 950 µL.

with robotools.EvoWorklist(max_volume=950, auto_split=True) as wl:
    wl.transfer(
        glucose, glucose.wells[:, 0],
        falcons, falcons.wells[:, 0],
        [0, 500, 1000, 1500, 2500, 2750],
        label='initial glucose'
    )
    wl.transfer(
        water, water.wells[:, 0],
        falcons, falcons.wells[:,0],
        [3000, 2500, 2000, 1500, 500, 250],
        label='water up to 3 mL'
    )
    
print(falcons.report)
falcons
initial
[[0.]
 [0.]
 [0.]
 [0.]
 [0.]
 [0.]]

initial glucose (5 LVH steps)
[[   0.]
 [ 500.]
 [1000.]
 [1500.]
 [2500.]
 [2750.]]

water up to 3 mL (8 LVH steps)
[[3000.]
 [3000.]
 [3000.]
 [3000.]
 [3000.]
 [3000.]]

Because the pipetting history of large volume transfers is condensed automatically, the individual pipetting steps don’t show up. However, we can see them in the created worklist:

wl
C;initial glucose
A;glucose;;;2;;500.00;;;;
D;falcons;;;2;;500.00;;;;
W1;
A;glucose;;;3;;500.00;;;;
D;falcons;;;3;;500.00;;;;
W1;
A;glucose;;;4;;750.00;;;;
D;falcons;;;4;;750.00;;;;
W1;
A;glucose;;;5;;834.00;;;;
D;falcons;;;5;;834.00;;;;
W1;
A;glucose;;;6;;917.00;;;;
D;falcons;;;6;;917.00;;;;
W1;
B;
A;glucose;;;3;;500.00;;;;
D;falcons;;;3;;500.00;;;;
W1;
A;glucose;;;4;;750.00;;;;
D;falcons;;;4;;750.00;;;;
W1;
A;glucose;;;5;;834.00;;;;
D;falcons;;;5;;834.00;;;;
W1;
A;glucose;;;6;;917.00;;;;
D;falcons;;;6;;917.00;;;;
W1;
B;
A;glucose;;;5;;832.00;;;;
D;falcons;;;5;;832.00;;;;
W1;
A;glucose;;;6;;916.00;;;;
D;falcons;;;6;;916.00;;;;
W1;
B;
C;water up to 3 mL
A;water;;;1;;750.00;;;;
D;falcons;;;1;;750.00;;;;
W1;
A;water;;;2;;834.00;;;;
D;falcons;;;2;;834.00;;;;
W1;
A;water;;;3;;667.00;;;;
D;falcons;;;3;;667.00;;;;
W1;
A;water;;;4;;750.00;;;;
D;falcons;;;4;;750.00;;;;
W1;
A;water;;;5;;500.00;;;;
D;falcons;;;5;;500.00;;;;
W1;
A;water;;;6;;250.00;;;;
D;falcons;;;6;;250.00;;;;
W1;
B;
A;water;;;1;;750.00;;;;
D;falcons;;;1;;750.00;;;;
W1;
A;water;;;2;;834.00;;;;
D;falcons;;;2;;834.00;;;;
W1;
A;water;;;3;;667.00;;;;
D;falcons;;;3;;667.00;;;;
W1;
A;water;;;4;;750.00;;;;
D;falcons;;;4;;750.00;;;;
W1;
B;
A;water;;;1;;750.00;;;;
D;falcons;;;1;;750.00;;;;
W1;
A;water;;;2;;832.00;;;;
D;falcons;;;2;;832.00;;;;
W1;
A;water;;;3;;666.00;;;;
D;falcons;;;3;;666.00;;;;
W1;
B;
A;water;;;1;;750.00;;;;
D;falcons;;;1;;750.00;;;;
W1;
B;
%load_ext watermark
%watermark -idu
The watermark extension is already loaded. To reload it, use:
  %reload_ext watermark
Last updated: 2024-04-25T09:21:21.383190+02:00