Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
5a08885
`io.USB`: a serial number is read through the descriptor, not PyUSB's…
cmoscy Nov 11, 2026
94910a7
`resources`: Beckman Coulter Biomek labware
cmoscy Nov 11, 2026
89cfcf0
`resources`: sort Beckman Coulter import blocks for ruff I001
cmoscy Nov 17, 2026
3083c2e
`resources`: a tip mounting shaft's state is the tip it carries
cmoscy Nov 12, 2026
86ff6e4
`resources`: narrow restored tip to Tip before reading its tracker
cmoscy Nov 17, 2026
766ca41
`Biomek i7`: ACE boards over USB: framing, messages and read-only dis…
cmoscy Nov 11, 2026
9ed3216
`Biomek i7`: sort imports for ruff I001
cmoscy Nov 17, 2026
f0c0f35
`Biomek i7`: the declared configuration, motor tables and units
cmoscy Nov 11, 2026
5bc4f1f
`Biomek i7`: sort imports for ruff I001
cmoscy Nov 17, 2026
f06ab9b
`Biomek i7`: the declared configuration made from Biomek's files, and…
cmoscy Nov 11, 2026
687c97c
`Biomek i7`: configuring, the interlock, faults, pause and stop
cmoscy Nov 11, 2026
f14bdc1
`Biomek i7`: Home All, coordinated moves, and the rail and self-colli…
cmoscy Nov 11, 2026
09bcb33
`Biomek i7`: reword Home All runs for typos and sort imports
cmoscy Nov 17, 2026
09bcd2f
`Biomek i7`: the deck, the device and the pods' models
cmoscy Nov 12, 2026
ec9d1ad
`Biomek i7`: sort imports for ruff I001
cmoscy Nov 17, 2026
3f7910c
`Biomek i7`: the Span-8: tips, priming, aspirate and dispense
cmoscy Nov 12, 2026
2b779bc
`Biomek i7`: sort imports for ruff I001
cmoscy Nov 17, 2026
0eb8d91
`Biomek i7`: the 96-channel head: tips, aspirate and dispense
cmoscy Nov 12, 2026
28e1325
`Biomek i7`: sort imports for ruff I001
cmoscy Nov 17, 2026
6f3bb4a
`Biomek i7`: the gripper on both pods
cmoscy Nov 12, 2026
0062e9a
`Biomek i7`: sort imports for ruff I001
cmoscy Nov 17, 2026
26d6301
`Biomek i7`: Biomek's techniques and liquid types as plain arguments
cmoscy Nov 12, 2026
332c219
`Biomek i7`: sort imports for ruff I001
cmoscy Nov 17, 2026
288f811
`Visualizer3D`: a boundary is an outline with no fill
cmoscy Nov 15, 2026
9ec0493
`Biomek i7`: deck collision and Biomek's planner
cmoscy Nov 15, 2026
02f0bee
`Biomek i7`: instrument obstacles are boundaries
cmoscy Nov 15, 2026
e7a293b
`Biomek i7`: drop unused traverse imports and satisfy mypy in plannin…
cmoscy Nov 17, 2026
03da30a
`Biomek i7`: avoid reusing OpenSet test loop variable for Hashable pops
cmoscy Nov 17, 2026
894413a
`Biomek i7`: the user guide, the API page and the device registry entry
cmoscy Nov 15, 2026
0b318e3
`Biomek i7`: fix Sphinx docstrings and sort remaining imports
cmoscy Nov 17, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/_static/devices.json
Original file line number Diff line number Diff line change
Expand Up @@ -222,6 +222,22 @@
"manager": "https://discuss.pylabrobot.org/u/rickwierenga",
"oem": "https://www.azenta.com/products/automated-plate-seal-remover-formerly-xpeel"
},
{
"id": "beckman-biomek-i7",
"vendor": "Beckman Coulter",
"name": "Biomek i7",
"kind": "liquid handler",
"capabilities": [
"liquid handling",
"arm"
],
"status": "mostly",
"api": "pylabrobot.beckman_coulter.biomek_i7.device.BiomekI7",
"api_version": "v1",
"code_slug": "beckman_coulter/biomek_i7",
"doc_slug": "beckman_coulter/biomek_i7/hello-world",
"notes": "A 96-channel head and a Span-8, each with a gripper, over USB with no Beckman software; tested on one instrument, motion checked against the Master Controller's logs."
},
{
"id": "beckman-cytoflex-s",
"vendor": "Beckman Coulter",
Expand Down
38 changes: 38 additions & 0 deletions docs/api/pylabrobot.beckman_coulter.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
.. currentmodule:: pylabrobot.beckman_coulter.biomek_i7

pylabrobot.beckman_coulter package
==================================

Biomek i7
---------

.. autosummary::
:toctree: _autosummary
:nosignatures:
:recursive:

device.BiomekI7
device.BiomekI7Device
deck.BiomekI7Deck
layouts.place_labware
driver.master.BiomekI7Driver
driver.features.pod.Pod
driver.features.head96.Head96
driver.features.pipettes.Pipettes
driver.features.gripper.Gripper
driver.configuration.DeviceConfiguration
driver.configuration.PodConfiguration
techniques.BiomekTechnique
techniques.BiomekLiquidType
techniques.TipTouch
techniques.MixHeights
session_log.start_session_log
driver.planning.check.PodCollisionError
driver.planning.check.DeckCollisionError
driver.x_rail.RailCollisionError
driver.errors.AceError
driver.errors.InterlockTrippedError
driver.errors.NotHomedError
driver.errors.MotionError
driver.errors.GripCheckError
driver.errors.TipCheckError
1 change: 1 addition & 0 deletions docs/api/pylabrobot.rst
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ Manufacturers

pylabrobot.agilent
pylabrobot.azenta
pylabrobot.beckman_coulter
pylabrobot.big_bear
pylabrobot.bmg_labtech
pylabrobot.brooks
Expand Down
1 change: 1 addition & 0 deletions docs/resources/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,6 +175,7 @@ library/agenbio
library/agilent
library/alpaqua
library/azenta
library/beckman_coulter
library/bioer
library/biorad
library/boekel
Expand Down
45 changes: 45 additions & 0 deletions docs/resources/library/beckman_coulter.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Beckman Coulter

Company page: [Beckman Coulter Life Sciences](https://www.beckman.com)

Transcribed from the tip and labware classes of Biomek 5, Beckman Coulter's software for its Biomek
liquid handlers. The labware is defined as Biomek defines it, under Biomek's class names (in
quotes), whoever makes it. Tips are `BiomekTip`s, which also carry the tip's cone; wells are
`BiomekWell`s, which also carry Biomek's outline of the well by height.

## Tips

| Description | Image | PLR definition |
|-|-|-|
| 'T50F'<br>Biomek tip, 50 uL, filter | | `beckman_coulter_biomek_tip_50uL_filter` |
| 'T190F'<br>Biomek tip, 190 uL, filter | | `beckman_coulter_biomek_tip_190uL_filter` |
| 'T230'<br>Biomek tip, 230 uL, no filter | | `beckman_coulter_biomek_tip_230uL` |
| 'T1025F'<br>Biomek tip, 1025 uL, filter | | `beckman_coulter_biomek_tip_1025uL_filter` |
| 'T1070'<br>Biomek tip, 1070 uL, no filter | | `beckman_coulter_biomek_tip_1070uL` |

## Tip racks

| Description | Image | PLR definition |
|-|-|-|
| 'BC50F'<br>Part no.: B85888<br>Biomek tip box: 96 T50F tips | | `beckman_coulter_biomek_96_tiprack_50uL_filter` |
| 'BC190F'<br>Part no.: B85911<br>Biomek tip box: 96 T190F tips | | `beckman_coulter_biomek_96_tiprack_190uL_filter` |
| 'BC230'<br>Part no.: B85906 (sterile), B85903 (non-sterile)<br>Biomek tip box: 96 T230 tips | | `beckman_coulter_biomek_96_tiprack_230uL` |
| 'BC1025F'<br>Part no.: B85955<br>Biomek tip box: 96 T1025F tips | | `beckman_coulter_biomek_96_tiprack_1025uL_filter` |
| 'BC1070'<br>Part no.: B85945 (sterile), B85940 (non-sterile)<br>Biomek tip box: 96 T1070 tips | | `beckman_coulter_biomek_96_tiprack_1070uL` |

## Plates

| Description | Image | PLR definition |
|-|-|-|
| 'Thermo96VB_PP'<br>96 round, V-bottomed wells; with its 'TiterplateLid' | | `beckman_coulter_biomek_96_wellplate_vb` |
| 'BCFlat96'<br>Part no.: 609844<br>96 round, flat-bottomed wells; with its 'TiterplateLid' | | `beckman_coulter_biomek_96_wellplate_flat` |
| 'BCDeep96Square'<br>Part no.: 140504<br>96 deep, square, V-bottomed wells | | `beckman_coulter_biomek_96_deepwell_square` |
| 'Thomson_24w_Square_RB'<br>Part no.: 931568<br>24 square, round-bottomed wells; with its lid | | `beckman_coulter_biomek_24_wellplate_square_rb` |

## Reservoirs

| Description | Image | PLR definition |
|-|-|-|
| 'ThermoNUNC_350CB'<br>one flat-bottomed section; with its 'TiterplateLid' | | `beckman_coulter_biomek_reservoir_350cb` |
| 'Reservoir'<br>Part no.: 148033<br>one flat-bottomed section | | `beckman_coulter_biomek_reservoir` |
| 'ModularReservoir'<br>Part no.: 372795 (frame)<br>four V-bottomed sections | | `beckman_coulter_biomek_modular_reservoir` |
198 changes: 198 additions & 0 deletions docs/user_guide/beckman_coulter/biomek_i7/hello-world.ipynb
Original file line number Diff line number Diff line change
@@ -0,0 +1,198 @@
{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Beckman Coulter Biomek i7\n",
"\n",
"The Biomek i7 is a liquid handler with two pods on one X rail: on this instrument a 96-channel\n",
"head (the Multichannel) on the left and a Span-8 on the right, each with a gripper. PyLabRobot\n",
"drives its boards directly over USB, with no Beckman software in the loop: it plans each move as\n",
"Biomek's planner does, checks it against the deck before sending it, and keeps the two pods apart.\n",
"\n",
"This page runs on a simulated instrument, so it needs no hardware."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Set up\n",
"\n",
"`BiomekI7(simulation=True)` builds a simulated instrument with the package's generic configuration.\n",
"Labware is Biomek's own (`pylabrobot.resources.beckman_coulter`), placed by class name and deck\n",
"position as in a Biomek method's Instrument Setup."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"from pylabrobot.beckman_coulter.biomek_i7.device import BiomekI7\n",
"from pylabrobot.beckman_coulter.biomek_i7.layouts import place_labware\n",
"from pylabrobot.resources import set_tip_tracking, set_volume_tracking\n",
"\n",
"set_tip_tracking(True)\n",
"set_volume_tracking(True)\n",
"\n",
"biomek = BiomekI7(simulation=True)\n",
"deck = biomek.deck\n",
"place_labware(deck, [\n",
" {\"position\": \"TL4\", \"class\": \"BC230\", \"name\": \"tips_96\"}, # the 96-head loads tips only on a tip-loading position\n",
" {\"position\": \"P5\", \"class\": \"BC230\", \"name\": \"tips_span8\"},\n",
" {\"position\": \"P8\", \"class\": \"ThermoNUNC_350CB\", \"name\": \"reservoir\"},\n",
" {\"position\": \"P6\", \"class\": \"Thermo96VB_PP\", \"name\": \"plate\"},\n",
"])\n",
"tips_96, tips_span8 = deck.get_resource(\"tips_96\"), deck.get_resource(\"tips_span8\")\n",
"reservoir, plate = deck.get_resource(\"reservoir\"), deck.get_resource(\"plate\")\n",
"reservoir.get_item(0).set_volume(50_000.0)"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"await biomek.setup()\n",
"head96, pipettes = biomek.head96, biomek.pipettes"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## The 96-channel head\n",
"\n",
"A transfer from the reservoir to every well of the plate, the tips back into their box."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"await head96.pick_up_tips(tips_96)\n",
"await head96.aspirate(reservoir, 150.0, liquid_height=2.0)\n",
"await head96.dispense(plate, 150.0, liquid_height=1.0)\n",
"await head96.drop_tips(tips_96)\n",
"plate.get_well(\"A1\").tracker.get_used_volume()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## The Span-8\n",
"\n",
"Eight probes on one X, spread evenly in Y. First its pumps are primed: their lines filled from the\n",
"system liquid, which also homes them."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"await pipettes.prime(2)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The left pod stands in the way of the Span-8's tips and plate: before the right pod moves there,\n",
"the left one is moved aside just far enough, as Biomek does."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"channels = list(range(8))\n",
"await pipettes.pick_up_tips(tips_span8[\"A1:H1\"], use_channels=channels)\n",
"await pipettes.aspirate(plate[\"A1:H1\"], [50.0] * 8, use_channels=channels, liquid_heights=[1.0] * 8)\n",
"await pipettes.dispense(plate[\"A7:H7\"], [50.0] * 8, use_channels=channels, liquid_heights=[2.0] * 8)\n",
"await pipettes.discard_tips()\n",
"[well.tracker.get_used_volume() for well in plate[\"A7:H7\"]]"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## The gripper\n",
"\n",
"Each pod has a gripper. The right one moves the plate from P6 to P9."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"gripper = biomek.right_x_arm.gripper\n",
"await gripper.pick_up_resource(plate)\n",
"await gripper.place_resource(deck.get_position(\"P9\"))"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": [
"await biomek.park()\n",
"await biomek.stop()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## On an instrument\n",
"\n",
"The driver needs the instrument's own configuration, made from its Biomek files: the instrument\n",
"file (`.bif`) and the Master Controller's instrument record. It is made once and checked against\n",
"the instrument at every setup:\n",
"\n",
"```python\n",
"from pylabrobot.beckman_coulter.biomek_i7.driver.configuration import DeviceConfiguration\n",
"\n",
"configuration = DeviceConfiguration.from_biomek(\n",
" r\"C:\\Users\\Public\\Documents\\Biomek5\\Biomek_i7.bif\",\n",
" master_controller_db=r\"C:\\ProgramData\\Beckman Coulter\\Biomek Master Controller\\Log.db3\",\n",
")\n",
"configuration.save(\"biomek_i7_configuration.json\")\n",
"\n",
"biomek = BiomekI7(declared_configuration_json=\"biomek_i7_configuration.json\")\n",
"```\n",
"\n",
"Only one program can hold the instrument's boards: stop the Biomek Master Controller service before\n",
"`setup()`. Before anything moves, clear the deck of everything but the method's labware, make sure\n",
"the light curtain works, and have someone at the emergency stop. `stop()` moves nothing: it rests\n",
"the arms by tripping the interlock."
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"name": "python"
}
},
"nbformat": 4,
"nbformat_minor": 5
}
7 changes: 7 additions & 0 deletions docs/user_guide/beckman_coulter/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Beckman Coulter

```{toctree}
:maxdepth: 1

biomek_i7/hello-world
```
1 change: 1 addition & 0 deletions docs/user_guide/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ generic/index

agilent/index
azenta/index
beckman_coulter/index
big_bear/index
bmg_labtech/index
brooks/index
Expand Down
1 change: 1 addition & 0 deletions pylabrobot/beckman_coulter/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
"""Beckman Coulter devices."""
1 change: 1 addition & 0 deletions pylabrobot/beckman_coulter/biomek_i7/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
"""Beckman Coulter Biomek i7, driven over USB through its ACE boards."""
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
"""Reading an instrument's Biomek files into its declared configuration
(`DeviceConfiguration.from_biomek`): Biomek's instrument file (`instrument_file.py`, over the
variant-tree reader `variant_tree.py`) and the Master Controller's instrument record
(`master_controller.py`), put together and checked against each other by `importer.py`. Read-only
on every Biomek file, and standard library only."""
Loading
Loading