pylabrobot.resources.TubeRack

class pylabrobot.resources.TubeRack(name: str, size_x: float, size_y: float, size_z: float, items: List[List[Tube]] | None = None, ordered_items: Dict[str, Tube] | None = None, model: str | None = None)

Bases: ItemizedResource[Tube]

Tube rack resource.

Attributes

items
name	Get the name of this resource.
num_items
num_items_x	The number of items in the x direction, if the resource is a full grid.
num_items_y	The number of items in the y direction, if the resource is a full grid.

Methods

__init__(name, size_x, size_y, size_z[, ...])	Initialize a TubeRack resource.
assign_child_resource(resource[, location, ...])	Assign a child resource to this resource.
center([x, y, z])	Get the center of this resource.
centers([xn, yn, zn])	Get equally spaced points in the x, y, and z directions.
copy()
deregister_did_assign_resource_callback(callback)	Remove a callback that will be called after a resource is assigned to this resource.
deregister_did_unassign_resource_callback(...)	Remove a callback that will be called after a resource is unassigned from this resource.
deregister_state_update_callback(callback)	Remove a callback that will be called when the state of the resource changes.
deregister_will_assign_resource_callback(...)	Remove a callback that will be called before a resource is assigned to this resource.
deregister_will_unassign_resource_callback(...)	Remove a callback that will be called before a resource is unassigned from this resource.
deserialize(data)	Deserialize a resource from a dictionary.
disable_volume_trackers()	Disable volume tracking for all tubes in the rack.
enable_volume_trackers()	Enable volume tracking for all tubes in the rack.
get_absolute_location([x, y, z])	Get the absolute location of this resource, probably within the pylabrobot.resources.Deck.
get_absolute_rotation()	Get the absolute rotation of this resource.
get_all_children()	Recursively get all children of this resource.
get_all_items()	Get all items in the resource.
get_anchor(x, y, z)	Get a relative location within the resource.
get_item(identifier)	Get the item with the given identifier.
get_items(identifiers)	Get the items with the given identifier.
get_resource(name)	Get a resource by name.
get_size_x()
get_size_y()
get_size_z()
get_tube(identifier)	Get the item with the given identifier.
get_tubes(identifier)	Get the tubes with the given identifier.
index_of_item(item)	Return the index of the given item in the resource, or None if the resource was not found.
load_all_state(state)	Load state for this resource and all children.
load_from_json_file(json_file)	Loads resources from a JSON file.
load_state(state)	Load state for this resource only.
load_state_from_file(fn)	Load the state of this resource and all children from a JSON file.
make_grid([occupied_func])
print_grid([occupied_func])
register_did_assign_resource_callback(callback)	Add a callback that will be called after a resource is assigned to this resource.
register_did_unassign_resource_callback(callback)	Add a callback that will be called after a resource is unassigned from this resource.
register_state_update_callback(callback)	Register a callback that will be called when the state of the resource changes.
register_will_assign_resource_callback(callback)	Add a callback that will be called before a resource is assigned to this resource.
register_will_unassign_resource_callback(...)	Add a callback that will be called before a resource is unassigned from this resource.
rotate([x, y, z])	Rotate counter-clockwise by the given number of degrees.
rotated([x, y, z])	Return a copy of this resource rotated by the given number of degrees.
save(fn[, indent])	Save a resource to a JSON file.
save_state_to_file(fn[, indent])	Save the state of this resource and all children to a JSON file.
serialize()	Serialize this resource.
serialize_all_state()	Serialize the state of this resource and all children.
serialize_state()	Serialize the state of this resource only.
set_tube_liquids(liquids)	Update the liquid in the volume tracker for each tube in the rack.
traverse(batch_size, direction[, repeat])	Traverse the items in this resource.
unassign()	Unassign this resource from its parent.
unassign_child_resource(resource)	Unassign a child resource from this resource.

Parameters:

• name (str)

• size_x (float)

• size_y (float)

• size_z (float)

• items (List[List[Tube]] | None)

• ordered_items (Dict[str, Tube] | None)

• model (str | None)