pylabrobot.liquid_handling.backends.hamilton.STAR.STAR.aspirate_pip#

async STAR.aspirate_pip(aspiration_type: List[int] = [0], tip_pattern: List[bool] = [True], x_positions: List[int] = [0], y_positions: List[int] = [0], minimum_traverse_height_at_beginning_of_a_command: int = 3600, min_z_endpos: int = 3600, lld_search_height: List[int] = [0], clot_detection_height: List[int] = [60], liquid_surface_no_lld: List[int] = [3600], pull_out_distance_transport_air: List[int] = [50], second_section_height: List[int] = [0], second_section_ratio: List[int] = [0], minimum_height: List[int] = [3600], immersion_depth: List[int] = [0], immersion_depth_direction: List[int] = [0], surface_following_distance: List[int] = [0], aspiration_volumes: List[int] = [0], aspiration_speed: List[int] = [500], transport_air_volume: List[int] = [0], blow_out_air_volume: List[int] = [200], pre_wetting_volume: List[int] = [0], lld_mode: List[int] = [1], gamma_lld_sensitivity: List[int] = [1], dp_lld_sensitivity: List[int] = [1], aspirate_position_above_z_touch_off: List[int] = [5], detection_height_difference_for_dual_lld: List[int] = [0], swap_speed: List[int] = [100], settling_time: List[int] = [5], mix_volume: List[int] = [0], mix_cycles: List[int] = [0], mix_position_from_liquid_surface: List[int] = [250], mix_speed: List[int] = [500], mix_surface_following_distance: List[int] = [0], limit_curve_index: List[int] = [0], tadm_algorithm: bool = False, recording_mode: int = 0, use_2nd_section_aspiration: List[bool] = [False], retract_height_over_2nd_section_to_empty_tip: List[int] = [60], dispensation_speed_during_emptying_tip: List[int] = [468], dosing_drive_speed_during_2nd_section_search: List[int] = [468], z_drive_speed_during_2nd_section_search: List[int] = [215], cup_upper_edge: List[int] = [3600], ratio_liquid_rise_to_tip_deep_in: List[int] = [16246], immersion_depth_2nd_section: List[int] = [30])#

aspirate pip

Aspiration of liquid using PIP.

It’s not really clear what second section aspiration is, but it does not seem to be used very often. Probably safe to ignore it.

LLD restrictions!

  • “dP and Dual LLD” are used in aspiration only. During dispensation LLD is set to OFF.

  • “side touch off” turns LLD & “Z touch off” to OFF , is not available for simultaneous Asp/Disp. command

Parameters:

  • aspiration_type (List[int]) – Type of aspiration (0 = simple;1 = sequence; 2 = cup emptied). Must be between 0 and 2. Default 0.

  • tip_pattern (List[bool]) – Tip pattern (channels involved). Default True.

  • x_positions (List[int]) – x positions [0.1mm]. Must be between 0 and 25000. Default 0.

  • y_positions (List[int]) – y positions [0.1mm]. Must be between 0 and 6500. Default 0.

  • minimum_traverse_height_at_beginning_of_a_command (int) – Minimum traverse height at beginning of a command 0.1mm] (refers to all channels independent of tip pattern parameter ‘tm’). Must be between 0 and 3600. Default 3600.

  • min_z_endpos (int) – Minimum z-Position at end of a command [0.1 mm] (refers to all channels independent of tip pattern parameter ‘tm’). Must be between 0 and 3600. Default 3600.

  • lld_search_height (List[int]) – LLD search height [0.1 mm]. Must be between 0 and 3600. Default 0.

  • clot_detection_height (List[int]) – Check height of clot detection above current surface (as computed) of the liquid [0.1mm]. Must be between 0 and 500. Default 60.

  • liquid_surface_no_lld (List[int]) – Liquid surface at function without LLD [0.1mm]. Must be between 0 and 3600. Default 3600.

  • pull_out_distance_transport_air (List[int]) – pull out distance to take transport air in function without LLD [0.1mm]. Must be between 0 and 3600. Default 50.

  • second_section_height (List[int]) – Tube 2nd section height measured from “zx” [0.1mm]. Must be between 0 and 3600. Default 0.

  • second_section_ratio (List[int]) – Tube 2nd section ratio (see Fig. 2 in fw guide). Must be between 0 and 10000. Default 0.

  • minimum_height (List[int]) – Minimum height (maximum immersion depth) [0.1 mm]. Must be between 0 and 3600. Default 3600.

  • immersion_depth (List[int]) – Immersion depth [0.1mm]. Must be between 0 and 3600. Default 0.

  • immersion_depth_direction (List[int]) – Direction of immersion depth (0 = go deeper, 1 = go up out of liquid). Must be between 0 and 1. Default 0.

  • surface_following_distance (List[int]) – Surface following distance during aspiration [0.1mm]. Must be between 0 and 3600. Default 0.

  • aspiration_volumes (List[int]) – Aspiration volume [0.1ul]. Must be between 0 and 12500. Default 0.

  • aspiration_speed (List[int]) – Aspiration speed [0.1ul/s]. Must be between 4 and 5000. Default 500.

  • transport_air_volume (List[int]) – Transport air volume [0.1ul]. Must be between 0 and 500. Default 0.

  • blow_out_air_volume (List[int]) – Blow-out air volume [0.1ul]. Must be between 0 and 9999. Default 200.

  • pre_wetting_volume (List[int]) – Pre-wetting volume. Must be between 0 and 999. Default 0.

  • lld_mode (List[int]) – LLD mode (0 = off, 1 = gamma, 2 = dP, 3 = dual, 4 = Z touch off). Must be between 0 and 4. Default 1.

  • gamma_lld_sensitivity (List[int]) – gamma LLD sensitivity (1= high, 4=low). Must be between 1 and 4. Default 1.

  • dp_lld_sensitivity (List[int]) – delta p LLD sensitivity (1= high, 4=low). Must be between 1 and 4. Default 1.

  • aspirate_position_above_z_touch_off (List[int]) – aspirate position above Z touch off [0.1mm]. Must be between 0 and 100. Default 5.

  • detection_height_difference_for_dual_lld (List[int]) – Difference in detection height for dual LLD [0.1 mm]. Must be between 0 and 99. Default 0.

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

  • settling_time (List[int]) – Settling time [0.1s]. Must be between 0 and 99. Default 5.

  • mix_volume (List[int]) – mix volume [0.1ul]. Must be between 0 and 12500. Default 0

  • mix_cycles (List[int]) – Number of mix cycles. Must be between 0 and 99. Default 0.

  • mix_position_from_liquid_surface (List[int]) – mix position in Z- direction from liquid surface (LLD or absolute terms) [0.1mm]. Must be between 0 and 900. Default 250.

  • mix_speed (List[int]) – Speed of mix [0.1ul/s]. Must be between 4 and 5000. Default 500.

  • mix_surface_following_distance (List[int]) – Surface following distance during mix [0.1mm]. Must be between 0 and 3600. Default 0.

  • limit_curve_index (List[int]) – limit curve index. Must be between 0 and 999. Default 0.

  • tadm_algorithm (bool) – TADM algorithm. Default False.

  • recording_mode (int) – Recording mode 0 : no 1 : TADM errors only 2 : all TADM measurement. Must be between 0 and 2. Default 0.

  • use_2nd_section_aspiration (List[bool]) – 2nd section aspiration. Default False.

  • retract_height_over_2nd_section_to_empty_tip (List[int]) – Retract height over 2nd section to empty tip [0.1mm]. Must be between 0 and 3600. Default 60.

  • dispensation_speed_during_emptying_tip (List[int]) – Dispensation speed during emptying tip [0.1ul/s] Must be between 4 and 5000. Default 468.

  • dosing_drive_speed_during_2nd_section_search (List[int]) – Dosing drive speed during 2nd section search [0.1ul/s]. Must be between 4 and 5000. Default 468.

  • z_drive_speed_during_2nd_section_search (List[int]) – Z drive speed during 2nd section search [0.1mm/s]. Must be between 3 and 1600. Default 215.

  • cup_upper_edge (List[int]) – Cup upper edge [0.1mm]. Must be between 0 and 3600. Default 3600.

  • ratio_liquid_rise_to_tip_deep_in (List[int]) – Ratio liquid rise to tip deep in [1/100000]. Must be between 0 and 50000. Default 16246.

  • immersion_depth_2nd_section (List[int]) – Immersion depth 2nd section [0.1mm]. Must be between 0 and 3600. Default 30.