Request for comments: LH.transfer and LH.distribute

rickwierenga · October 8, 2025, 1:37am

PR:

github.com/PyLabRobot/pylabrobot

add LH.transfer and LH.distribute

main ← transfer-distribute

opened 01:36AM - 08 Oct 25 UTC

rickwierenga

+69 -67

two new functions: - `LH.transfer`: 1 to 1 relation between source and destin…ation. There might be multiple sources and destinations, but the number of items in each list is equal and the items at index `i` match. ```py await lh.transfer( plate_1.column(3), plate_3.column(3), vols=[50, 100, 150, 200, 250, 300, 350, 360], ) ``` - `LH.distribute`: 1 to many relation between source and destination. In a dictionary, because the number of items in the destinations might not be equal for every source. ```py await lh.distribute( { plate_1.get_item("A1"): [(plate_2.get_item("B1"), 10), (plate_2.get_item("C1"), 10)], plate_1.get_item("A2"): [(plate_2.get_item("B2"), 10), (plate_2.get_item("C2"), 10), (plate_2.get_item("D2"), 10)], plate_1.get_item("A3"): [(plate_2.get_item("B3"), 10), (plate_2.get_item("C3"), 10)], }, dead_volume=0 ) ``` TODO: - [ ] handle cases where volume exceeds tip volume (need to re-aspirate) - [ ] take a tip generator as an argument so we can pick up new tips and handle more transfers/distributions than there are channels (this is big for hardware agnosticity, we can specify the same transfer on STAR and OT and it will use one channel for the OT and 8 for the STAR.)

please comment/review in the PR