Geometric Jacobian for robot configuration
computes the geometric Jacobian relative to the base for the specified end-effector
name and configuration for the robot model.
jacobian = geometricJacobian(
Geometric Jacobian for Robot Configuration
Calculate the geometric Jacobian for a specific end effector and configuration of a robot.
Load a Puma robot, which is specified as a
load exampleRobots.mat puma1
Calculate the geometric Jacobian of body
'L6' on the Puma robot for a random configuration.
geoJacob = geometricJacobian(puma1,randomConfiguration(puma1),'L6')
geoJacob = 6×6 0 -0.7795 -0.7795 -0.4592 0.5643 -0.6612 0.0000 0.6264 0.6264 -0.5714 -0.7789 -0.2282 1.0000 0.0000 0.0000 0.6801 -0.2734 -0.7146 0.4544 0.3107 0.1746 -0.0000 0 0 -0.5577 0.3866 0.2173 -0.0000 0 0 0 0.7036 0.3304 0.0000 0 0
configuration — Robot configuration
vector | structure
Robot configuration, specified as a vector of joint positions or a structure with joint names
and positions for all the bodies in the robot model. You can generate a
randomConfiguration(robot), or by specifying your own
joint positions in a structure. To use the vector form of
configuration, set the
DataFormat property for the
robot to either
endeffectorname — End-effector name
string scalar | character vector
End-effector name, specified as a string scalar or character vector. An end effector can be any body in the robot model.
jacobian — Geometric Jacobian
Geometric Jacobian of the end effector with the specified
configuration, returned as a 6-by-n
matrix, where n is the number of degrees of freedom of
the robot. The Jacobian maps the joint-space velocity to the end-effector
velocity, relative to the base coordinate frame. The end-effector velocity
ω is the angular velocity, υ is the linear velocity, and is the joint-space velocity.
When working with robot dynamics, specify the information for individual bodies of your manipulator robot using these properties of the
Mass— Mass of the rigid body in kilograms.
CenterOfMass— Center of mass position of the rigid body, specified as a vector of the form
[x y z]. The vector describes the location of the center of mass of the rigid body, relative to the body frame, in meters. The
centerOfMassobject function uses these rigid body property values when computing the center of mass of a robot.
Inertia— Inertia of the rigid body, specified as a vector of the form
[Ixx Iyy Izz Iyz Ixz Ixy]. The vector is relative to the body frame in kilogram square meters. The inertia tensor is a positive definite matrix of the form:
The first three elements of the
Inertiavector are the moment of inertia, which are the diagonal elements of the inertia tensor. The last three elements are the product of inertia, which are the off-diagonal elements of the inertia tensor.
For information related to the entire manipulator robot model, specify these
rigidBodyTree object properties:
Gravity— Gravitational acceleration experienced by the robot, specified as an
[x y z]vector in m/s2. By default, there is no gravitational acceleration.
DataFormat— The input and output data format for the kinematics and dynamics functions, specified as
Manipulator rigid body dynamics are governed by this equation:
also written as:
— is a joint-space mass matrix based on the current robot configuration. Calculate this matrix by using the
— are the Coriolis terms, which are multiplied by to calculate the velocity product. Calculate the velocity product by using by the
— is the gravity torques and forces required for all joints to maintain their positions in the specified gravity
Gravity. Calculate the gravity torque by using the
— is the geometric Jacobian for the specified joint configuration. Calculate the geometric Jacobian by using the
— is a matrix of the external forces applied to the rigid body. Generate external forces by using the
— are the joint torques and forces applied directly as a vector to each joint.
— are the joint configuration, joint velocities, and joint accelerations, respectively, as individual vectors. For revolute joints, specify values in radians, rad/s, and rad/s2, respectively. For prismatic joints, specify in meters, m/s, and m/s2.
To compute the dynamics directly, use the
forwardDynamics object function. The function calculates the joint accelerations for the specified combinations of the above inputs.
To achieve a certain set of motions, use the
inverseDynamics object function. The function calculates the joint torques required to achieve the specified configuration, velocities, accelerations, and external forces.
 Featherstone, Roy. Rigid Body Dynamics Algorithms. Springer US, 2008. DOI.org (Crossref), doi:10.1007/978-1-4899-7560-7.
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Usage notes and limitations:
When creating the
rigidBodyTree object, use the syntax that specifies the
MaxNumBodies as an upper bound for adding bodies to the robot model.
You must also specify the
DataFormat property as a name-value pair. For
robot = rigidBodyTree("MaxNumBodies",15,"DataFormat","row")
To minimize data usage, limit the upper bound to a number close to the expected number of bodies in the model. All data formats are supported for code generation. To use the dynamics functions, the data format must be set to
showdetails functions do not support code generation.
Introduced in R2016b