Ctrl+K

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

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

async STAR.aspirate96(aspiration: AspirationPlate, jet: bool = False, blow_out: bool = False, use_lld: bool = False, liquid_height: float = 1, air_transport_retract_dist: float = 10, hlc: HamiltonLiquidClass | None = None, aspiration_type: int = 0, minimum_traverse_height_at_beginning_of_a_command: int | None = None, minimal_end_height: int | None = None, lld_search_height: int = 1999, maximum_immersion_depth: int = 1869, tube_2nd_section_height_measured_from_zm: int = 32, tube_2nd_section_ratio: int = 6180, immersion_depth: int = 0, immersion_depth_direction: int = 0, liquid_surface_sink_distance_at_the_end_of_aspiration: int = 0, transport_air_volume: int = 50, pre_wetting_volume: int = 50, gamma_lld_sensitivity: int = 1, swap_speed: int = 20, settling_time: int = 10, homogenization_volume: int = 0, homogenization_cycles: int = 0, homogenization_position_from_liquid_surface: int = 0, surface_following_distance_during_homogenization: int = 0, speed_of_homogenization: int = 1200, limit_curve_index: int = 0)#

Aspirate using the Core96 head.

Warning

The parameters in this method, with the exception of ops and use_channels, expect units of tenths of ‘millimeters’ (i.e. 10 = 1 mm), or tenths of ‘microliters’ (i.e. 10 = 1 ul), or tenths of seconds. Speeds are in 0.1ul/s. This is a deviation from the rest of the API, which uses SI units. This is because the Hamilton API uses these units.

Parameters:

  • aspiration (AspirationPlate) – 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 (int | None) – The minimum height to move to before starting the command.

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

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

  • maximum_immersion_depth (int) – The maximum immersion depth.

  • tube_2nd_section_height_measured_from_zm (int) – Unknown.

  • tube_2nd_section_ratio (int) – Unknown.

  • immersion_depth (int) – 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 (int) – The volume of air to aspirate after the liquid.

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

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

  • swap_speed (int) – unknown.

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

  • homogenization_volume (int) – The volume of liquid to aspirate for homogenization.

  • homogenization_cycles (int) – The number of cycles to perform for homogenization.

  • homogenization_position_from_liquid_surface (int) – The position of the homogenization from the liquid surface.

  • surface_following_distance_during_homogenization (int) – The distance to follow the liquid surface during homogenization.

  • speed_of_homogenization (int) – The speed of homogenization.

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

  • liquid_surface_sink_distance_at_the_end_of_aspiration (int)

Contents