diff --git a/content/posts/delta-robot/circle_pos_vel.png b/content/posts/delta-robot/circle_pos_vel.png new file mode 100644 index 0000000..d9169b9 Binary files /dev/null and b/content/posts/delta-robot/circle_pos_vel.png differ diff --git a/content/posts/delta-robot/index.md b/content/posts/delta-robot/index.md index a7de757..1f85b4f 100644 --- a/content/posts/delta-robot/index.md +++ b/content/posts/delta-robot/index.md @@ -15,6 +15,9 @@ repo: https://github.com/Sharwin24/DeltaRobot --- An open source ROS package for controlling delta robots with forward and inverse kinematics, trajectory generation, and visualization. Designed for public use and easy integration with new delta robot designs and applications. +
+ Delta Robot Workspace +
## Robot Kinematics The robot's forward and inverse kinematics were first implemented in a [jupyter notebook](https://github.com/Sharwin24/DeltaRobot/blob/main/delta_kinematics.ipynb) to visualize the robot's configuration space and workspace. @@ -140,6 +143,155 @@ The forward and inverse kinematics were then implemented in C++ following the ap +### The Jacobian +The Modern Robotics [2] textbook details the process of deriving the Jacobian for a delta robot. The Jacobian is useful for converting end effector velocities to joint velocities. + +
+ \[ + \dot{\theta} = J_{\Theta} \cdot \underbrace{\dot{p}}_{EE Velocity} + \] +
+ +
+
+ Jacobian ROS C++ Implementation + + ```cpp + std::pair, std::vector> DeltaKinematics::calcAuxAngles(double theta1, double theta2, double theta3) { + // First determine the end effector position using FK + Point position = this->deltaFK(theta1, theta2, theta3); + + const double UP = (sqrt3 / 3) * this->SP; + const Eigen::Vector3d P = {position.x, position.y, position.z}; + const Eigen::Vector3d D = {UP - this->AL, 0, 0}; + + Eigen::Matrix3d C; + for (int i = 0; i < 3; ++i) { + double phi_i = this->phi[i]; + Eigen::Matrix3d R; + R << std::cos(phi_i), std::sin(phi_i), 0, + -std::sin(phi_i), std::cos(phi_i), 0, + 0, 0, 1; + Eigen::Vector3d c_i = R * P + D; + // Set the i-th column of C to c_i. + C.col(i) = c_i; + } + double C_x2 = C(0, 1); + double C_y2 = C(1, 1); + double C_z2 = C(2, 1); + double C_x3 = C(0, 2); + double C_y3 = C(1, 2); + double C_z3 = C(2, 2); + // C_squared = c_xi^2 + c_yi^2 + c_zi^2 + double C_sqrd_2 = C_x2 * C_x2 + C_y2 * C_y2 + C_z2 * C_z2; + double C_sqrd_3 = C_x3 * C_x3 + C_y3 * C_y3 + C_z3 * C_z3; + // theta_3i = arccos(C_yi / PL) + double t32 = acos(C_y2 / this->PL); + double t33 = acos(C_y3 / this->PL); + // k_numerator = c_xi ^ 2 + c_yi ^ 2 + c_zi ^ 2 - L ^ 2 - ELL ^ 2 + // k_denominator = 2 * L * ELL * sin(theta_3i) + // theta_2i = arccos(k_numerator / k_denominator) + double t22_numerator = C_sqrd_2 - this->AL * this->AL - this->PL * this->PL; + double t22_denominator = 2 * this->AL * this->PL * sin(t32); + double t23_numerator = C_sqrd_3 - this->AL * this->AL - this->PL * this->PL; + double t23_denominator = 2 * this->AL * this->PL * sin(t33); + double t22 = acos(t22_numerator / t22_denominator); + double t23 = acos(t23_numerator / t23_denominator); + // theta_1i is the actuated angles which were passed into the function + // We only need to return the auxiliary angles + return std::make_pair(std::vector{theta2, t22, t23}, std::vector{theta3, t32, t33}); + } + + Eigen::Matrix3d DeltaKinematics::calcJacobian(double theta1, double theta2, double theta3) { + // The Jacobian matrix has 2 components: JTheta and Jp + // Since this Jacobian will be used to compute the joint velocities, we need the inverse of JTheta + // Jp * p_dot = JTheta * theta_dot -> theta_dot = JTheta_inv * Jp * p_dot + + // Obtain auxiliary angles + auto aux_angles = this->calcAuxAngles(theta1, theta2, theta3); + const std::vector t1 = {theta1, theta2, theta3}; + const std::vector t2 = aux_angles.first; + const std::vector t3 = aux_angles.second; + double t22 = t2[1]; + double t23 = t2[2]; + double t32 = t3[1]; + double t33 = t3[2]; + + // Jp Calculation + auto J_ix = [this, &t1, &t2, &t3](int i) -> double { + return sin(t3[i]) * cos(t2[i] + t1[i]) * cos(this->phi[i]) + cos(t3[i]) * sin(this->phi[i]); + }; + auto J_iy = [this, &t1, &t2, &t3](int i) -> double { + return -sin(t3[i]) * cos(t2[i] + t1[i]) * sin(this->phi[i]) + cos(t3[i]) * cos(this->phi[i]); + }; + auto J_iz = [this, &t1, &t2, &t3](int i) -> double { + return sin(t3[i]) * sin(t2[i] + t1[i]); + }; + Eigen::Matrix3d Jp; + for (int i = 0; i < 3; ++i) { + Jp(i, 0) = J_ix(i); + Jp(i, 1) = J_iy(i); + Jp(i, 2) = J_iz(i); + } + + // JTheta Calculation + Eigen::Matrix3d JTheta; + // Populate the diagonals with AL*sin(t2[i])*sin(t3[i]) + JTheta(0, 0) = this->AL * sin(theta2) * sin(theta3); + JTheta(1, 1) = this->AL * sin(t22) * sin(t23); + JTheta(2, 2) = this->AL * sin(t32) * sin(t33); + + // Invert JTheta + Eigen::Matrix3d JTheta_inv = JTheta.inverse(); + return JTheta_inv * Jp; + } + + DeltaJointVels DeltaKinematics::calcThetaDot(double theta1, double theta2, double theta3, double x_dot, double y_dot, double z_dot) { + Eigen::Matrix3d J = this->calcJacobian(theta1, theta2, theta3); + Eigen::Vector3d p_dot(x_dot, y_dot, z_dot); + Eigen::Vector3d theta_dot = J * p_dot; + DeltaJointVels joint_vels; + joint_vels.theta1_vel = theta_dot(0); + joint_vels.theta2_vel = theta_dot(1); + joint_vels.theta3_vel = theta_dot(2); + return joint_vels; + } + + std::vector DeltaKinematics::computeGradient(const std::vector& position_data, double dt) { + size_t n = position_data.size(); + std::vector velocities(n, {0.0, 0.0, 0.0}); + if (n == 0 || n == 1) return velocities; + + // Use forward difference for the first point + velocities[0].x_vel = (position_data[1].x - position_data[0].x) / dt; + velocities[0].y_vel = (position_data[1].y - position_data[0].y) / dt; + velocities[0].z_vel = (position_data[1].z - position_data[0].z) / dt; + + // Use central difference for interior points + for (size_t i = 1; i < n - 1; ++i) { + velocities[i].x_vel = (position_data[i + 1].x - position_data[i - 1].x) / (2 * dt); + velocities[i].y_vel = (position_data[i + 1].y - position_data[i - 1].y) / (2 * dt); + velocities[i].z_vel = (position_data[i + 1].z - position_data[i - 1].z) / (2 * dt); + } + + // Use backward difference for the last point + velocities[n - 1].x_vel = (position_data[n - 1].x - position_data[n - 2].x) / dt; + velocities[n - 1].y_vel = (position_data[n - 1].y - position_data[n - 2].y) / dt; + velocities[n - 1].z_vel = (position_data[n - 1].z - position_data[n - 2].z) / dt; + + return velocities; + } + ``` +
+
+ +Using the Jacobian we can convert end-effector position trajectories into Joint velocity trajectories. + +
+ Circle Trajectory +
+ + ## End-Effector Sensors | Sensor | Image | Description | @@ -149,4 +301,5 @@ The forward and inverse kinematics were then implemented in C++ following the ap ## References -- [Delta Robot Kinematics](https://hypertriangle.com/~alex/delta-robot-tutorial/) \ No newline at end of file +1. [Delta Robot Kinematics](https://hypertriangle.com/~alex/delta-robot-tutorial/) +2. [Modern Robotics](http://hades.mech.northwestern.edu/index.php/Modern_Robotics) \ No newline at end of file diff --git a/content/posts/delta-robot/workspace.png b/content/posts/delta-robot/workspace.png new file mode 100644 index 0000000..02b6bd0 Binary files /dev/null and b/content/posts/delta-robot/workspace.png differ diff --git a/content/posts/mobile-manipulation/index.md b/content/posts/mobile-manipulation/index.md index f816198..8ef5b0b 100644 --- a/content/posts/mobile-manipulation/index.md +++ b/content/posts/mobile-manipulation/index.md @@ -54,6 +54,10 @@ There were two components to the trajectory generation: These were accomplished using the trajectory generation functions provided by the `modern_robotics` library after splitting the sequence into 8 separate segments. +
+
+ Trajectory Generation Python Function + ```python dt = 0.01 # [s] total_time = 10 # [s] @@ -125,6 +129,8 @@ trajectory = np.concatenate( (traj_1, traj_2, traj_3, traj_4, traj_5, traj_6, traj_7, traj_8), axis=0 ) ``` +
+
## Odometry Odometry is the process of estimating the mobile robot's pose by integrating the wheel velocities. The robot's pose is represented by the chassis configuration \\([\phi, x, y]\\), where \\(\phi\\) is the orientation and \\(x, y\\) are the position in the world frame. We can compute the body twist \\(V_b\\) using the wheel velocities \\(\dot{\theta}\\), the timestep \\(\Delta t\\), and the chassis configuration \\( F=pinv(H(0))\\): @@ -139,6 +145,11 @@ V_b = \underbrace{H(0)^{\dagger}}_{F} \cdot \dot{\theta} The body twist \\(V_b\\) can be integrated to get the displacement \\(T_{bk} = exp([V_b])\\), which is then applied to the chassis configuration to get the new pose. The odometry function computes the new chassis configuration based on the difference between the current and previous wheel configurations assuming a constant velocity between the two wheel configurations \\((\Delta t = 1)\\). + +
+
+ Odometry Python Function + ```python def odometry(chassis_config: np.array, delta_wheel_config: np.array) -> np.array: """ @@ -171,6 +182,8 @@ def odometry(chassis_config: np.array, delta_wheel_config: np.array) -> np.array ]) return new_chassis_config ``` +
+
## Task-Space Feedforward & Feedback Control To perform the pick and place task, we need to implement a control law that can track a desired end-effector trajectory. The control law is given by: @@ -190,6 +203,10 @@ where: - \\(K_i\\) is the integral gain matrix - \\(X_{err}(t)\\) is the error between the current and desired end-effector configurations +
+
+ Feedback Control Python Function + ```python def feedback_control(X, Xd, Xd_next, Kp, Ki, control_type: str = 'FF+PI', dt: float = 0.01) -> tuple: """ @@ -219,6 +236,8 @@ def feedback_control(X, Xd, Xd_next, Kp, Ki, control_type: str = 'FF+PI', dt: fl V = mr.Adjoint(mr.TransInv(X) @ Xd) @ Vd + (Kp @ X_err) + (Ki @ (X_err * dt)) return V, X_err ``` +
+
## Singularity Avoidance During trajectory generation/planning, there are desired configurations that can bring the robot arm close to singularities in the robot's configuration space. To avoid any singularities, whenever the joint speeds are computed for the configuration at the next timestep, If the movement sends a joint past its limit, the column corresponding to that joint is set to zero within the Jacobian when computing the joint speeds to avoid using that joint to acheive the desired configuration.