pylabrobot.liquid_handling.backends.hamilton.STAR_backend.STAR.clld_probe_x_position_using_channel#
- async STAR.clld_probe_x_position_using_channel(channel_idx: int, probing_direction: Literal['right', 'left'], end_pos_search: float | None = None, post_detection_dist: float = 2.0, tip_bottom_diameter: float = 1.2, read_timeout=240.0) float#
Probe the x-position of a conductive material using a channel’s capacitive liquid level detection (cLLD) via a lateral X scan.
Starting from the channel’s current X position, the channel is moved laterally in the specified direction using the XL command until cLLD triggers or the configured end position is reached. After the scan, the channel is retracted inward by
post_detection_dist.The returned value is a first-order geometric estimate of the material boundary, corrected by half the tip bottom diameter assuming cylindrical tip contact.
Notes: - The XL command does not report whether cLLD triggered; reaching the end position is indistinguishable from a successful detection. - This function assumes cLLD triggers before
end_pos_search.Preconditions: - The channel must already be at a Z height safe for lateral X motion. - The current X position must be consistent with
probing_direction.Side effects: - Moves the specified channel in X. - Leaves the channel retracted from the detected object.