Waste configuration
Prerequisites
- A powered-on Hamilton Vantage device
- A running Hamilton Vantage connector (see the Hamilton Microlab VANTAGE device guide for installation and setup)
- Basic understanding of the liquid handler class (See the liquid handler tutorial)
Overview
Hamilton Vantage liquid handlers support the following waste types for pipettes:
- Universal Waste (
VantageUniversalWaste) - This large waste can accommodate tips from multiple Vantage modules (1000 µL pipettes, 5 mL XL channels, CO-RE 96 head, plates discarded with the IPG, etc.). It takes up 8 tracks of deck space and is similar in construction to the STAR waste block. For pipettes, the Universal Waste uses a SHIFT discard method where pipetting channels shift sideways when ejecting tips. - 2T Waste (
Vantage2TWaste) - This slim waste takes 2 tracks of deck space and can be used with channels (1000 µL pipettes, 5 mL XL channels) only. The correct ejection plate must be used to accommodate different channel configurations. The 2T Waste uses a DROP discard method where tips drop straight down without channel shifting. - CO-RE 96 head Waste - The CO-RE 96 head can either use the Universal Waste as discard location or have its own dedicated waste, typically in a waste chute left of the pipetting deck.
Additionally, the CO-RE 96 head discard location is configured separately (see CO-RE 96 Head Waste).
Waste Configuration
Information about the waste system is not stored in the instrument firmware, therefore waste has to be manually configured before initializing the Vantage liquid handler. If you are not sure about waste configuration of your system, consult the manufacturer.
Vantage Waste can only be placed on certain deck positions, depending on your instrument type:
| Waste Type | Waste Type Enum | 1.3m Instrument | 2.0m Instrument |
|---|---|---|---|
| Universal | WasteType.UNIVERSAL | 20, 30, 40 | 34, 50, 60, 70 |
| 2T | WasteType.TWO_T | 25, 35, 45 | 39, 55, 65, 75 |
Universal Waste Configuration
To configure Universal Waste, you need to specify the waste type and track location in the vantage configuration and then call configure() method:
from unitelabs.liquid_handling.hamilton import Vantage, WasteType
vantage = Vantage(name="My Vantage")
# Configure Universal Waste at track 40
config = await vantage.get_configuration()
config.waste_type = WasteType.UNIVERSAL
config.waste_track = 40
await vantage.configure()
This defines the discard locations for the pipettes (standard and XL). The Universal Waste also carries a dedicated spot for the CO-RE 96 head. For tracks other than 40, change waste_track in the example above and look up the spot's position after configuring the waste:
spot = vantage.deck.waste_block.core96_discard_spot
print(spot.absolute_location)
# Vector(x=959.7, y=268.4, z=178.0)
Use this lookup to determine core96_discard_location for your track, then set it before the single configure() call in your final script (see CO-RE 96 Head Waste). For track 40, use the value shown above without a lookup. The SDK does not set the head's discard location from the Universal Waste automatically.
2T Waste Configuration
For 2T waste, the ejection plate must be specified based on the instrument hardware.
The following ejection plates are supported for Hamilton Vantage: PIP_1000UL, PIP_1000UL_MAGPIP.
from unitelabs.labware.hamilton.waste import Hamilton2TEjectionPlate
from unitelabs.liquid_handling.hamilton import WasteType
# Configure 2T Waste with PIP_1000UL ejection plate
config = await vantage.get_configuration()
config.waste_type = WasteType.TWO_T
config.waste_track = 35
config.ejection_plate = Hamilton2TEjectionPlate.PIP_1000UL
await vantage.configure()
2T waste does not change the default discard location for the CO-RE 96 head.
CO-RE 96 Head Waste
The CO-RE 96 head discard location needs to be configured separately from the pipettes waste. The location is defined as the position of the head's A1 tip at the moment tips are ejected. For z, that is the tip end position, the same convention the head uses for get_position() and pipetting locations.
The default waste location is set to Vector(x=-70, y=180.2, z=250.0), a typical location for a Vantage with an extended left cover. If your Vantage has a normal left cover or you use Universal Waste, set core96_discard_location before configure():
from unitelabs.labware import Vector
from unitelabs.liquid_handling.hamilton import WasteType
config = await vantage.get_configuration()
config.waste_type = WasteType.UNIVERSAL
config.waste_track = 40
config.core96_discard_location = Vector(x=959.7, y=268.4, z=178.0)
await vantage.configure()
print(vantage.core96.discard_location)
# Vector(x=959.7, y=268.4, z=178.0)
The position above is the CO-RE 96 spot of a Universal Waste on track 40. For other tracks, look up the spot's position as described in Universal Waste Configuration and use that value instead.
initialize() always ejects any tips the CO-RE 96 head holds at this location.Discarding Tips
To discard tips, call discard_tips() on the module holding the tips. The SDK automatically uses the spots of the configured waste block, or the fallback positions if no waste is configured:
# Discard tips from all channels that have tips
await vantage.pipettes.discard_tips()
# Discard from specific channels
await vantage.pipettes.discard_tips(channels=[0, 1])
await vantage.pipettes_xl.discard_tips(channels=[0, 1])
# Discard the tips held by the CO-RE 96 head at core96_discard_location
await vantage.core96.discard_tips()
Accessing Waste Spot Locations
The waste block on the deck exposes its discard spots grouped by channel type. vantage.deck.waste_block is None until a waste is configured via waste_type and waste_track, so guard access accordingly:
# Get the waste block
waste_block = vantage.deck.waste_block
assert waste_block is not None, "No waste configured"
# Access spots by channel type
pip_spots = waste_block.spots.get("pip", []) # Standard pipetting
xl_spots = waste_block.spots.get("xl", []) # XL channels
core96_spots = waste_block.spots.get("core96", []) # CoRe 96 head
# Iterate over spots
for spot in pip_spots:
print(f"Waste spot at: {spot.absolute_location}")
Which keys are present depends on the waste: the Universal Waste provides pip, xl and core96 spots, the 2T waste provides pip spots.
Defining Custom Waste
Because Vantage Wastes are defined as labware dataclasses, any type of custom waste can be defined and used by the user by creating a custom labware dataclass and passing it to the Vantage configuration.
In the following example, a custom universal waste with limited ejection space (only front half of the waste is used for tip ejection) is defined and used:
from decimal import Decimal
import dataclasses
import typing
from unitelabs.labware import Vector
from unitelabs.labware.hamilton.waste import VantageUniversalWaste
from unitelabs.labware.hamilton.waste.vantage_waste import UNIVERSAL_DIMENSIONS
from unitelabs.liquid_handling.hamilton import Vantage, WasteType
vantage = Vantage(name="My Vantage")
@dataclasses.dataclass
class CustomUniversalWaste(VantageUniversalWaste):
y_min: typing.ClassVar[Decimal] = Decimal("201.6")
y_max: typing.ClassVar[Decimal] = Decimal("290")
dimensions: Vector = dataclasses.field(
default_factory=lambda: Vector(
x=UNIVERSAL_DIMENSIONS.x,
y=Decimal("290") - Decimal("201.6"),
z=UNIVERSAL_DIMENSIONS.z
)
)
config = await vantage.get_configuration()
config.waste_track = 40
config.waste_type = CustomUniversalWaste
await vantage.configure()
CO-RE 96 Head Home Location
The default home location of the CO-RE 96 head is Vector(x=0, y=540, z=390). Like the discard location, it is defined as the position of the head's A1 tip. The head parks at the maximum height the connector accepts (390 mm).
To change the home location, use the following code:
from unitelabs.labware import Vector
config = await vantage.get_configuration()
config.core96_home_location = Vector(x=180, y=540, z=390)
await vantage.configure()
config = await vantage.get_configuration()
print(config.core96_home_location)
# Vector(x=180, y=540, z=390)
For the heights the head travels at and how to move it, see CO-RE 96 head.
Last updated