pylabrobot.liquid_handling.backends.hamilton.STAR_backend.STAR.aspirate#

async STAR.aspirate(ops: List[SingleChannelAspiration], use_channels: List[int], jet: List[bool] | None = None, blow_out: List[bool] | None = None, lld_search_height: List[float] | None = None, clot_detection_height: List[float] | None = None, pull_out_distance_transport_air: List[float] | None = None, second_section_height: List[float] | None = None, second_section_ratio: List[float] | None = None, minimum_height: List[float] | None = None, immersion_depth: List[float] | None = None, surface_following_distance: List[float] | None = None, transport_air_volume: List[float] | None = None, pre_wetting_volume: List[float] | None = None, lld_mode: List[LLDMode] | None = None, gamma_lld_sensitivity: List[int] | None = None, dp_lld_sensitivity: List[int] | None = None, aspirate_position_above_z_touch_off: List[float] | None = None, detection_height_difference_for_dual_lld: List[float] | None = None, swap_speed: List[float] | None = None, settling_time: List[float] | None = None, mix_position_from_liquid_surface: List[float] | None = None, mix_surface_following_distance: List[float] | None = None, limit_curve_index: List[int] | None = None, use_2nd_section_aspiration: List[bool] | None = None, retract_height_over_2nd_section_to_empty_tip: List[float] | None = None, dispensation_speed_during_emptying_tip: List[float] | None = None, dosing_drive_speed_during_2nd_section_search: List[float] | None = None, z_drive_speed_during_2nd_section_search: List[float] | None = None, cup_upper_edge: List[float] | None = None, ratio_liquid_rise_to_tip_deep_in: List[float] | None = None, immersion_depth_2nd_section: List[float] | None = None, minimum_traverse_height_at_beginning_of_a_command: float | None = None, min_z_endpos: float | None = None, hamilton_liquid_classes: List[HamiltonLiquidClass | None] | None = None, liquid_surfaces_no_lld: List[float] | None = None, probe_liquid_height: bool = False, auto_surface_following_distance: bool = False, mix_volume: List[float] | None = None, mix_cycles: List[int] | None = None, mix_speed: List[float] | None = None, immersion_depth_direction: List[int] | None = None)#

Aspirate liquid from the specified channels.

For all parameters where None is the default value, STAR will use the default value, based on the aspirations. For all list parameters, the length of the list must be equal to the number of operations.

Parameters:
  • ops (List[SingleChannelAspiration]) – The aspiration operations to perform.

  • use_channels (List[int]) – The channels to use for the operations.

  • jet (List[bool] | None) – whether to search for a jet liquid class. Only used on dispense. Default is False.

  • blow_out (List[bool] | None) – whether to blow out air. Only used on dispense. Note that in the VENUS Liquid Editor, this is called “empty”. Default is False.

  • lld_search_height (List[float] | None) – The height to start searching for the liquid level when using LLD.

  • clot_detection_height (List[float] | None) – Unknown, but probably the height to search for clots when doing LLD.

  • pull_out_distance_transport_air (List[float] | None) – The distance to pull out when aspirating air, if LLD is disabled.

  • second_section_height (List[float] | None) – The height to start the second section of aspiration.

  • second_section_ratio (List[float] | None)

  • minimum_height (List[float] | None) – The minimum height to move to, this is the end of aspiration. The channel will move linearly from the liquid surface to this height over the course of the aspiration.

  • immersion_depth (List[float] | None) – The z distance to move after detecting the liquid, can be into or away from the liquid surface.

  • surface_following_distance (List[float] | None) – The distance to follow the liquid surface.

  • transport_air_volume (List[float] | None) – The volume of air to aspirate after the liquid.

  • pre_wetting_volume (List[float] | None) – The volume of liquid to use for pre-wetting.

  • lld_mode (List[LLDMode] | None) – The liquid level detection mode to use.

  • gamma_lld_sensitivity (List[int] | None) – The sensitivity of the gamma LLD.

  • dp_lld_sensitivity (List[int] | None) – The sensitivity of the DP LLD.

  • aspirate_position_above_z_touch_off (List[float] | None) – If the LLD mode is Z_TOUCH_OFF, this is the height above the bottom of the well (presumably) to aspirate from.

  • detection_height_difference_for_dual_lld (List[float] | None) – Difference between the gamma and DP LLD heights if the LLD mode is DUAL.

  • swap_speed (List[float] | None) – Swap speed (on leaving liquid) [1mm/s]. Must be between 3 and 1600. Default 100.

  • settling_time (List[float] | None) – The time to wait after mix.

  • mix_position_from_liquid_surface (List[float] | None) – The height to aspirate from for mix (LLD or absolute terms).

  • mix_surface_following_distance (List[float] | None) – The distance to follow the liquid surface for mix.

  • limit_curve_index (List[int] | None) – The index of the limit curve to use.

  • use_2nd_section_aspiration (List[bool] | None) – Whether to use the second section of aspiration.

  • retract_height_over_2nd_section_to_empty_tip (List[float] | None) – Unknown.

  • dispensation_speed_during_emptying_tip (List[float] | None) – Unknown.

  • dosing_drive_speed_during_2nd_section_search (List[float] | None) – Unknown.

  • z_drive_speed_during_2nd_section_search (List[float] | None) – Unknown.

  • cup_upper_edge (List[float] | None) – Unknown.

  • ratio_liquid_rise_to_tip_deep_in (List[float] | None) – Unknown.

  • immersion_depth_2nd_section (List[float] | None) – The depth to move into the liquid for the second section of aspiration.

  • minimum_traverse_height_at_beginning_of_a_command (float | None) – The minimum height to move to before starting an aspiration.

  • min_z_endpos (float | None) – The minimum height to move to, this is the end of aspiration.

  • hamilton_liquid_classes (List[HamiltonLiquidClass | None] | None) – Override the default liquid classes. See pylabrobot/liquid_handling/liquid_classes/hamilton/STARBackend.py

  • liquid_surface_no_lld – Liquid surface at function without LLD [mm]. Must be between 0 and 360. Defaults to well bottom + liquid height. Should use absolute z.

  • probe_liquid_height (bool) – PLR-specific parameter. If True, probe the liquid height using cLLD before aspirating to set the liquid_height of every operation instead of using the default 0. Liquid heights must not be set when using this function.

  • auto_surface_following_distance (bool) – automatically compute the surface following distance based on the container height<->volume functions. Requires liquid height to be specified or probe_liquid_height=True.

  • liquid_surfaces_no_lld (List[float] | None)

  • mix_volume (List[float] | None)

  • mix_cycles (List[int] | None)

  • mix_speed (List[float] | None)

  • immersion_depth_direction (List[int] | None)