science_jubilee.decks.Deck

Module Contents

Classes

Slot	Class that defines a slot on the Jubilee deck.
SlotSet	Class that defines a set of slots on the Jubilee deck.
Deck	Class that defines the Jubilee deck.

class science_jubilee.decks.Deck.Slot

Class that defines a slot on the Jubilee deck. Each slot has a unique index, offset, and can have a labware associated with it.

Parameters:

• slot_index (int) – The unique index of the slot, usually a number between 0 and 5.

• offset (Tuple[float]) – The (x,y) offset of the slot from the origin of the deck/machine.

• has_labware (bool) – A boolean that indicates whether a labware has been loaded into the slot.

• labware (Labware) – The Labware object that has been loaded into the slot.

slot_index: int

offset: Tuple[float]

has_labware: bool

labware: str

class science_jubilee.decks.Deck.SlotSet

Class that defines a set of slots on the Jubilee deck.

Parameters:

• slots (Dict[str, Slot]) – A dictionary of Slot objects, where the key is the slot’s index.

• bedType (str) – The type of bed that the slots are arranged in. Usually ‘fixed’ or ‘removable’.

slots: Dict[str, Slot]

__repr__()

Return repr(self).

__getitem__(id_)

Allows the user to select a Slot object by its index or key.

Parameters:

id (str or int) – The index or key representing the slot.

Returns:

The Slot object associated with the index or key.

Return type:

Slot

class science_jubilee.decks.Deck.Deck(deck_filename, path: str = os.path.join(os.path.dirname(__file__), 'deck_definition'))

Bases: SlotSet

Class that defines the Jubilee deck.

The deck is a set of slots that can have labware loaded into them. The deck is defined by a configuration file that specifies the number of slots, their offsets, and the type of bed they are arranged in.

Parameters:

• deck_filename (str) – The name of the deck configuration file.

• path (str, optional) – The path to the deck configuration .json files for the labware, defaults to the ‘deck_definition/’ in the science_jubilee/decks directory.

property bedType

Function that returns the type of bed loaded onto Jubilee.

Returns:

The name/type of deck loaded onto Jubilee, e.g., Lab Automation Deck, Heated Deck, etc.

Return type:

str

property totalslots

Function that returns the total number of slots on the deck.

Returns:

The total number of slots on the deck.

Return type:

int

property slotType

Function that returns the type of slot arrangement the deck might have.

Returns:

The slot arrangement type. This is inidcated in the configuration file. Standard is “SLAS”.

Return type:

str

property offsetFrom

Function that returns which corner or the slot to apply to a labware loaded on it.

Returns:

The corner of the slot to apply to the labware. This is inidcated in the configuration file.

Return type:

str

property deck_material

Function that returns the material that the deck and possible mask are made of.

Returns:

The material that the deck is made of, as well as any mask that is applied to it.

Return type:

Dict[str, str]

property safe_z

Function that returns the movement clearance height of the deck.

Returns:

The height at which the pipette can freely move without colliding with labware on the deck.

Return type:

float

_get_slots()

Function that creates a dictionary of Slot objects from the deck configuration file.

Returns:

A dictionary of Slot objects, where the key is the slot’s index.

Return type:

Dict[str, Slot]

load_labware(labware_filename: str, slot: int, path=os.path.join(os.path.dirname(__file__), '..', 'labware', 'labware_definition'), order: str = 'rows')

Function that loads a labware and associates it with a specific slot on the deck.

The slot offset is also applied to the labware asocaite with it.

Parameters:

• labware_filename (str) – The name of the labware configuration file.

• slot (int) – The index of the slot to load the labware into.

• path (str, optional) – The path to the labware configuration .json files for the labware, defaults to the ‘labware_definition/’ in the science_jubilee/labware directory.

• order (str, optional) – The order in which the labware is arranged on the deck. Can be ‘rows’ or ‘columns’, defaults to ‘rows’.

Returns:

The Labware object that has been loaded into the slot.

Return type:

Labware