pylabrobot.resources.Trough

class pylabrobot.resources.Trough(name: str, size_x: float, size_y: float, size_z: float, max_volume: float, material_z_thickness: float | None = None, through_base_to_container_base: float = 0, category: str | None = 'trough', model: str | None = None, bottom_type: TroughBottomType | str = TroughBottomType.UNKNOWN, compute_volume_from_height: Callable[[float], float] | None = None, compute_height_from_volume: Callable[[float], float] | None = None)

Bases: Container

A trough is a container, particularly useful for multichannel liquid handling operations.

Attributes

material_z_thickness
name	Get the name of this resource.

Methods

__init__(name, size_x, size_y, size_z, ...)	Create a new container.
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.
compute_height_from_volume(liquid_volume)	Compute the height of liquid in a container relative to the container's bottom from the volume of the liquid.
compute_volume_from_height(height)	Compute the volume of liquid in a container from the height of the liquid relative to the bottom of the container.
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[, allow_marshal])	Deserialize a resource from a dictionary.
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_absolute_size_x()	Get the absolute size in the x direction.
get_absolute_size_y()	Get the absolute size in the y direction.
get_absolute_size_z()	Get the absolute size in the z direction.
get_all_children()	Recursively get all children of this resource.
get_anchor(x, y, z)	Get a relative location within the container. (Update to Resource superclass to
get_highest_known_point()	Recursively finds the highest known point in absolute space.
get_resource(name)	Get a resource by name.
get_root()	Get the root of the resource tree.
get_size_x()	Local size in the x direction.
get_size_y()	Local size in the y direction.
get_size_z()	Local size in the z direction.
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.
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.
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)

• max_volume (float)

• material_z_thickness (float | None)

• through_base_to_container_base (float)

• category (str | None)

• model (str | None)

• bottom_type (TroughBottomType | str)

• compute_volume_from_height (Callable[[float], float] | None)

• compute_height_from_volume (Callable[[float], float] | None)