pylabrobot.liquid_handling.backends.hamilton.STAR.STAR.clld_probe_z_height_using_channel#

async STAR.clld_probe_z_height_using_channel(channel_idx: int, lowest_immers_pos: float = 99.98, start_pos_search: float = 330.0, channel_speed: float = 10.0, channel_acceleration: float = 800.0, detection_edge: int = 10, detection_drop: int = 2, post_detection_trajectory: Literal[0, 1] = 1, post_detection_dist: float = 2.0, move_channels_to_save_pos_after: bool = False) → float#

Probes the Z-height below the specified channel on a Hamilton STAR liquid handling machine using the channels ‘capacitive Liquid Level Detection’ (cLLD) capabilities. N.B.: this means only conductive materials can be probed!

Parameters:

  • channel_idx (int) – The index of the channel to use for probing. Backmost channel = 0.

  • lowest_immers_pos (float) – The lowest immersion position in mm.

  • start_pos_lld_search – The start position for z-touch search in mm.

  • channel_speed (float) – The speed of channel movement in mm/sec.

  • channel_acceleration (float) – The acceleration of the channel in mm/sec**2.

  • detection_edge (int) – The edge steepness at capacitive LLD detection.

  • detection_drop (int) – The offset after capacitive LLD edge detection.

  • post_detection_trajectory (0, 1) – Movement of the channel up (1) or down (0) after contacting the surface.

  • post_detection_dist (float) – Distance to move into the trajectory after detection in mm.

  • move_channels_to_save_pos_after (bool) – Flag to move channels to a safe position after operation.

  • start_pos_search (float)

Returns:

The detected Z-height in mm.

Return type:

float