pylabrobot.paa.kx2.KX2.move_to_location#

async KX2.move_to_location(location: Coordinate, direction: float, *, max_gripper_speed: float | None = None, max_gripper_acceleration: float | None = None, path: Literal['joint', 'linear'] = 'joint', max_gripper_angular_speed: float | None = None, max_gripper_angular_acceleration: float | None = None) → None#

Move the gripper to a Cartesian location with yaw direction (deg).

max_gripper_speed / max_gripper_acceleration cap the worst-case Cartesian speed/acceleration at the gripper (mm/s, mm/s^2). None runs joints at firmware max with no Cartesian cap; otherwise joint speeds are scaled uniformly so the gripper stays under the cap.

path selects the trajectory shape:
  • "joint" (default): every axis ramps in parallel through its own trapezoid. Tool tip traces a curvy path; speed is firmware-bounded with the optional gripper-speed cap.

  • "linear": tool tip traces a straight line from current to target pose, sampled and streamed via the drive’s interpolation buffer (PVT). Requires max_gripper_speed and max_gripper_acceleration — they directly drive the Cartesian profile (no cap == no speed to stream). Yaw is independently limited by max_gripper_angular_speed (deg/s, default 30) and max_gripper_angular_acceleration (deg/s², default 100). Rotation-only moves hold the grip center fixed. Angular limits apply only to path="linear".

Parameters:
  • location (Coordinate)

  • direction (float)

  • max_gripper_speed (float | None)

  • max_gripper_acceleration (float | None)

  • path (Literal['joint', 'linear'])

  • max_gripper_angular_speed (float | None)

  • max_gripper_angular_acceleration (float | None)

Return type:

None