UniteLabs
Reference

Carriers and adapters

Define custom plate carriers, tip carriers, trough carriers, and plate adapters for the deck.

Adapters

Sometimes labware is not placed directly into a carrier site, but onto an adapter. An adapter always modifies the position of the labware it holds, and can provide additional functions like magnetic separation or temperature control.

In this example, we build a magnetic plate adapter, specifically the Magnum FLX adapter from Alpaqua:

import collections.abc
import dataclasses

from unitelabs.labware import Adapter, Decimal, Labware, Spot, StandardMicroplateDimensions, Vector


@dataclasses.dataclass
class PLT_ADP_MAG_MAGNUM_FLX(
    Adapter[Spot[StandardMicroplateDimensions], StandardMicroplateDimensions], StandardMicroplateDimensions, Labware
):
    """Magnum FLX magnetic plate by Alpaqua."""

    height: Decimal = dataclasses.field(default=Decimal(default=28.55))
    children: collections.abc.Sequence[Spot[StandardMicroplateDimensions]] = dataclasses.field(
        repr=False,
        default_factory=lambda: [Spot(dimensions=Vector(x=127.76, y=85.48), location=Vector(x=0, y=0, z=28.55))],
    )

The Adapter class is generic. We parameterize it to specify two things:

  1. The Spot type: the kind of spot the adapter itself fits into (e.g., Spot[StandardMicroplateDimensions])
  2. The placeable type: what the adapter can hold (e.g., StandardMicroplateDimensions)

Multiple inheritance also applies:

  • StandardMicroplateDimensions: defines it as having a standard footprint, so it can be placed on standard carriers
  • Labware: marks it as a physical resource managed by the library

Carriers

Carriers are resources that hold other labware on the deck. They are defined with a set of CarrierSite slots, each at a specific position relative to the carrier origin. Carrier sites are 2-dimensional planes. They define x and y position only, and the z offset of a site is its height above the carrier origin.

The dimension examples below are specific to Hamilton carriers. If building for a different vendor, measure your carrier directly or consult its technical specification.

For Hamilton carriers assembled from a base plate and interchangeable modules, see Hamilton MFX carriers.

Plate Carriers

A plate carrier holds labware of the Plate type (anything with StandardMicroplateDimensions).

import collections.abc
import dataclasses

from unitelabs.labware import CarrierSite, Orientation, StandardMicroplateDimensions, Vector
from unitelabs.labware.hamilton import HamiltonCarrier, LabwareType


@dataclasses.dataclass
class PLT_CAR_L5FLEX_MD_A00(HamiltonCarrier[StandardMicroplateDimensions]):
    rows: int = 5
    dimensions: Vector = dataclasses.field(default_factory=lambda: Vector(x=157.5, y=497.0, z=130.0))
    labware: LabwareType = LabwareType.PLATES
    orientation: dataclasses.InitVar[Orientation] = Orientation.LANDSCAPE

    children: collections.abc.Sequence[CarrierSite] = dataclasses.field(
        repr=False,
        default_factory=lambda: [
            CarrierSite(dimensions=Vector(x=127.0, y=86.0)).copy(location=Vector(x=15.25, y=y, z=115.8))
            for y in [392.5, 296.5, 200.5, 104.5, 8.5]
        ],
    )

Tip Carriers

A tip carrier is built like a plate carrier, but holds labware of the TipRack type.

import collections.abc
import dataclasses

from unitelabs.labware import CarrierSite, Orientation, TipRack, Vector
from unitelabs.labware.hamilton import HamiltonCarrier, LabwareType


@dataclasses.dataclass
class TIP_CAR_480_A00(HamiltonCarrier[TipRack]):
    dimensions: Vector = dataclasses.field(default_factory=lambda: Vector(x=135.0, y=497.0, z=130.0))
    labware: LabwareType = LabwareType.TIPS
    orientation: dataclasses.InitVar[Orientation] = Orientation.LANDSCAPE

    children: collections.abc.Sequence[CarrierSite] = dataclasses.field(
        repr=False,
        default_factory=lambda: [
            CarrierSite(dimensions=Vector(x=122.4, y=82.6)).copy(location=Vector(x=6.2, y=y, z=114.95))
            for y in [394.0, 298.0, 202.0, 106.0, 10.0]
        ],
    )

Trough Carriers

A trough carrier is built like a plate carrier, but holds 50 mL reagent containers (RGT_CONT_50ml) and is typed with LabwareType.REAGENT.

import collections.abc
import dataclasses

from unitelabs.labware import CarrierSite, Orientation, Vector
from unitelabs.labware.hamilton import HamiltonCarrier, LabwareType, RGT_CONT_50ml


@dataclasses.dataclass
class RGT_CAR_5R_A00(HamiltonCarrier[RGT_CONT_50ml]):
    dimensions: Vector = dataclasses.field(default_factory=lambda: Vector(x=22.5, y=497, z=82))
    labware: LabwareType = LabwareType.REAGENT
    orientation: dataclasses.InitVar[Orientation] = Orientation.LANDSCAPE

    children: collections.abc.Sequence[CarrierSite] = dataclasses.field(
        repr=False,
        default_factory=lambda: [
            CarrierSite(dimensions=Vector(x=20, y=90)).copy(location=Vector(x=1.25, y=y, z=18.5))
            for y in [390.5, 294.5, 198.5, 102.5, 6.5]
        ],
    )

Last updated