pylabrobot.liquid_handling.backends.hamilton.STAR.STAR.aspirate96#

async STAR.aspirate96(aspiration: AspirationPlate | AspirationContainer, jet: bool = False, blow_out: bool = False, use_lld: bool = False, liquid_height: float = 0, air_transport_retract_dist: float = 10, hlc: HamiltonLiquidClass | None = None, aspiration_type: int = 0, minimum_traverse_height_at_beginning_of_a_command: float | None = None, minimal_end_height: float | None = None, lld_search_height: float = 199.9, maximum_immersion_depth: float | None = None, tube_2nd_section_height_measured_from_zm: float = 3.2, tube_2nd_section_ratio: float = 618.0, immersion_depth: float = 0, immersion_depth_direction: int = 0, liquid_surface_sink_distance_at_the_end_of_aspiration: float = 0, transport_air_volume: float = 5.0, pre_wetting_volume: float = 5.0, gamma_lld_sensitivity: int = 1, swap_speed: float = 2.0, settling_time: float = 1.0, mix_volume: float = 0, mix_cycles: int = 0, mix_position_from_liquid_surface: float = 0, surface_following_distance_during_mix: float = 0, speed_of_mix: float = 120.0, limit_curve_index: int = 0)#

Aspirate using the Core96 head.

Parameters:
  • aspiration (AspirationPlate | AspirationContainer) – The aspiration to perform.

  • jet (bool) – Whether to search for a jet liquid class. Only used on dispense.

  • blow_out (bool) – Whether to use “blow out” dispense mode. Only used on dispense. Note that this is labelled as “empty” in the VENUS liquid editor, but “blow out” in the firmware documentation.

  • hlc (HamiltonLiquidClass | None) – The Hamiltonian liquid class to use. If None, the liquid class will be determined automatically.

  • use_lld (bool) – If True, use gamma liquid level detection. If False, use liquid height.

  • liquid_height (float) – The height of the liquid above the bottom of the well, in millimeters.

  • air_transport_retract_dist (float) – The distance to retract after aspirating, in millimeters.

  • aspiration_type (int) – The type of aspiration to perform. (0 = simple; 1 = sequence; 2 = cup emptied )

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

  • minimal_end_height (float | None) – The minimum height to move to after the command.

  • lld_search_height (float) – The height to search for the liquid level.

  • maximum_immersion_depth (float | None) – The maximum immersion depth.

  • tube_2nd_section_height_measured_from_zm (float) – Unknown.

  • tube_2nd_section_ratio (float) – Unknown.

  • immersion_depth (float) – The immersion depth above or below the liquid level. See immersion_depth_direction.

  • immersion_depth_direction (int) – The direction of the immersion depth. (0 = deeper, 1 = out of liquid)

  • transport_air_volume (float) – The volume of air to aspirate after the liquid.

  • pre_wetting_volume (float) – The volume of liquid to use for pre-wetting.

  • gamma_lld_sensitivity (int) – The sensitivity of the gamma liquid level detection.

  • swap_speed (float) – Swap speed (on leaving liquid) [1mm/s]. Must be between 0.3 and 160. Default 2.

  • settling_time (float) – The time to wait after aspirating.

  • mix_volume (float) – The volume of liquid to aspirate for mix.

  • mix_cycles (int) – The number of cycles to perform for mix.

  • mix_position_from_liquid_surface (float) – The position of the mix from the liquid surface.

  • surface_following_distance_during_mix (float) – The distance to follow the liquid surface during mix.

  • speed_of_mix (float) – The speed of mix.

  • limit_curve_index (int) – The index of the limit curve to use.

  • liquid_surface_sink_distance_at_the_end_of_aspiration (float)