pylabrobot.liquid_handling.backends.hamilton.STAR.STAR.probe_z_height_using_channel

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:

float