pylabrobot.liquid_handling.backends.hamilton.STAR.STAR.probe_z_height_using_channel#
- async STAR.probe_z_height_using_channel(channel_idx: int, lowest_immers_pos: int = 10000, start_pos_lld_search: int = 31200, channel_speed: int = 1000, channel_acceleration: int = 75, detection_edge: int = 10, detection_drop: int = 2, post_detection_trajectory: Literal[0, 1] = 1, post_detection_dist: int = 100, move_channels_to_save_pos_after: bool = False) float #
Probes the Z-height using a specified channel on a liquid handling device. Commands the liquid handler to perform a Liquid Level Detection (LLD) operation using the specified channel (this means only conductive materials can be probed!).
- Parameters:
self – The liquid handler.
channel_idx (int) – The index of the channel to use for probing.
lowest_immers_pos (int) – The lowest immersion position in increments.
start_pos_lld_search (int) – The start position for LLD search in increments.
channel_speed (int) – The speed of channel movement.
channel_acceleration (int) – The acceleration of the channel.
detection_edge (int) – The edge steepness at capacitive LLD detection.
detection_drop (int) – The offset after capacitive LLD edge detection.
post_detection_trajectory (Literal[0, 1]) – Movement of the channel up (1) or down (0) after contacting the surface.
post_detection_dist (
int
) – Distance to move up after detection to avoid pressure build-up.move_channels_to_save_pos_after (
bool
) – Flag to move channels to a safe position after operation.
- Returns:
float – The detected Z-height in mm.
- Return type: