6-DOF Joint
Joint with six degrees of freedom and no kinematic singularity
Libraries:
Simscape /
Multibody /
Joints
Description
The 6-DOF Joint block provides three translational and three rotational degrees of freedom. The follower frame can have a 3-D transformation with respect to the base frame. The transformation contains three sequential translations and a 3-D rotation encoded as a quaternion. Quaternions do not have a kinematic singularity.
The translations are along the x, y, and z axes of the base frame, respectively. Before the rotation, the axes of the follower are parallel to the corresponding axes of the base frame. The 3-D rotation is with respect to the follower frame formed after the translations.
To specify the target of the initial state for a joint primitive, use the parameters under State Targets. The targets are specified in the base frame. You can also set the priority levels for the targets. If the joint is not able to satisfy all the state targets, the priority level determines which targets to satisfy first and how closely to satisfy them. For an example, see the Guiding Assembly section of How Multibody Assembly Works.
To model damping and the spring behavior for a joint primitive, use the parameters under Internal Mechanics. Use the Damping Coefficient parameter to model energy dissipation and the Spring Stiffness parameter to model energy storage. Joint springs attempt to displace the joint primitive from its equilibrium position, and joint dampers act as energy dissipation elements. The springs and dampers are strictly linear.
To specify the limits of a joint primitive, use the parameters under Limits. The lower and upper bounds define the width of the free region. The block applies a force to accelerate the joint position back to the free region when the position exceeds the bounds. The block uses a smoothed spring-damper method to compute the force. For more information about the smoothed spring-damper method, see the Description section of the Spatial Contact Force block.
The Force, Torque, and Motion parameters in the Actuation section control the motion of the joint primitives during simulation. For more information, see Specifying Joint Actuation Inputs. Additionally, the joint block has ports that output sensing data, such as position, velocity, acceleration, force, and torque, that you can use to perform analytical tasks on a model. For more information, see Sensing and Force and Torque Sensing.
To specify the joint mode configuration, use the Mode parameter. For more details, see Mode Configuration under the Ports and Parameters sections.
Examples
Variable Mode Joint Contact - Drop and Catch Mechanism
A rotating arm that raises up a ball, drops the ball, and catches the ball in one cycle of rotation.
Vehicle Suspension System Templates
Includes templates for three common types of automotive suspension systems: double wishbone, MacPherson, and pushrod. Tires attached to the suspension systems are mounted on platforms that can independently move up and down. Each platform has a PD controller that allows it to simulate a desired road profile. For a given pair of road profiles, the resultant roll and bounce of the chassis can be studied and the suspension parameters can be tuned for optimal performance.
Ports
Frame
B — Base frame
frame
Base frame of the joint block.
F — Follower frame
frame
Follower frame of the joint block.
Input
fx — Actuation force
physical signal
Physical signal input port that accepts the actuation force for the joint primitive. The block applies the force equally and oppositely to the base and follower frames of the joint along the x-axis of the base frame.
Dependencies
To enable this port, under X Prismatic Primitive (Px) > Actuation, set Force to Provided by Input
.
px — Motion profile
physical signal
Physical signal input port that accepts the motion profile for the joint primitive. The block uses this signal to determine the displacement of the follower frame with respect to the base frame along the x-axis of the base frame. The signal must also contain the first and second derivatives of the displacement.
Dependencies
To enable this port, under X Prismatic Primitive (Px) > Actuation, set Motion to Provided by Input
.
fy — Actuation force
physical signal
Physical signal input port that accepts the actuation force for the joint primitive. The block applies this force equally and oppositely to the base and follower frames of the joint along the y-axis of the base frame.
Dependencies
To enable this port, under Y Prismatic Primitive (Py) > Actuation, set Force to Provided by Input
.
py — Motion profile
physical signal
Physical signal input port that accepts the motion profile for the joint primitive. The block uses this signal to determine the displacement of the follower frame with respect to the base frame along the y-axis of the base frame. The signal must also contain the first and second derivatives of the displacement.
Dependencies
To enable this port, under Y Prismatic Primitive (Py) > Actuation, set Motion to Provided by Input
.
fz — Actuation force
physical signal
Physical signal input port that accepts the actuation force for the joint primitive. The block applies this force equally and oppositely to the base and follower frames of the joint along the z-axis of the base frame.
Dependencies
To enable this port, under Z Prismatic Primitive (Pz) > Actuation, set Force to Provided by
Input
.
pz — Motion profile
physical signal
Physical signal input port that accepts the motion profile for the joint primitive. The block uses this signal to determine the displacement of the follower frame with respect to the base frame along the z-axis of the base frame. The signal must also contain the first and second derivatives of the displacement.
Dependencies
To enable this port, under Z Prismatic Primitive (Pz) > Actuation, set Motion to Provided by
Input
.
tx — Actuation torque about x
-axis of resolution frame
physical signal
Physical signal input port that accepts the actuation torque for the spherical primitive. The signal has a scalar format that represents the torque about the x-axis of the resolution frame.
Dependencies
To enable this port, under Spherical Primitive (S) > Actuation, set Torque to Provided by Input
and select Torque (X).
ty — Actuation torque about y
-axis of resolution frame
physical signal
Physical signal input port that accepts the actuation torque for the spherical primitive. The signal has a scalar format that represents the torque about the y-axis of the resolution frame.
Dependencies
To enable this port, under Spherical Primitive (S) > Actuation, set Torque to Provided by
Input
and select Torque (Y).
tz — Actuation torque about z
-axis of resolution frame
physical signal
Physical signal input port that accepts the actuation torque for the spherical primitive. The signal has a scalar format that represents the torque about the z-axis of the resolution frame.
Dependencies
To enable this port, under Spherical Primitive (S) > Actuation, set Torque to Provided by
Input
and select Torque (Z).
t — Actuation torque vector
physical signal
Physical signal input port that accepts the actuation torque for the spherical primitive. The signal has a vector format that represents the torque about an arbitrary axis [x y z] specified in the resolution frame.
Dependencies
To enable this port, under Spherical Primitive (S) > Actuation, set Motion to Provided by
Input
and select Torque (XYZ).
mode — Joint mode control
physical signal
Input port that controls the mode of the joint. The signal must be a unitless scalar. The
joint mode is normal when the input signal is 0
, disengaged when
the input signal is -1
, and locked when the input signal is
1
. You can change the mode at any time during the
simulation.
The table shows how the position and velocity of the joint change during transitions between modes.
Transitions | Position | Velocity |
---|---|---|
Normal to Locked | The joint position retains the current value and remains constant after the transition. | The joint velocity becomes zero and remains constant after the transition. |
Normal to Disengaged | The joint position retains the current value but can change in any direction after the transition. | The joint velocity retains the current value but can change in any direction after the transition. |
Locked to Normal | The joint position retains the current value but can change in the directions aligned with the joint degrees of freedom (DOFs) after the transition. | The joint velocity remains at zero but can change in the directions aligned with the joint DOFs after the transition. |
Locked to Disengaged | The joint position retains the current value but can change in any direction after the transition. | The joint velocity remains at zero but can change in any direction after the transition. |
Disengaged to Normal | For the directions aligned with the joint DOFs, the joint positions initially take values calculated by using Newton's method and can change thereafter. In the constrained directions, the joint positions become zero and remain constant after the transition. | For the directions aligned with the joint DOFs, the joint velocities initially take values calculated by using Newton's method and can change thereafter. In the constrained directions, the joint velocities become zero and remain constant after the transition. |
Disengaged to Locked | For the directions aligned with the joint DOFs, the joint positions initially take values calculated by using Newton's method and remain constant after the transition. In the constrained directions, the joint positions become zero and remain constant after the transition. | The joint velocity becomes zero and remains constant after the transition. |
Dependencies
To enable this port, under Mode Configuration, set Mode to Provided by Input
.
Output
px — Position of primitive
physical signal
Physical signal port that outputs the position of the joint primitive. The value is the displacement of the follower frame with respect to the base frame in the x-direction of the base frame.
Dependencies
To enable this port, under X Prismatic Primitive (Px) > Sensing, select Position.
vx — Velocity of primitive
physical signal
Physical signal port that outputs the velocity of the joint primitive. The value is the first derivative of the signal from the port px.
Dependencies
To enable this port, under X Prismatic Primitive (Px) > Sensing, select Velocity.
ax — Acceleration of primitive
physical signal
Physical signal port that outputs the acceleration of the joint primitive. The value is the second derivative of the signal from the port px.
Dependencies
To enable this port, under X Prismatic Primitive (Px) > Sensing, select Acceleration.
fx — Actuator force acting on joint primitive
physical signal
Physical signal port that outputs the actuator force acting on the joint primitive.
Dependencies
To enable this port, under X Prismatic Primitive (Px) > Sensing, select Actuator Force.
fllx — Lower-limit force
physical signal
Physical signal port that outputs the lower-limit force. The block applies this force when the joint primitive position is less than the lower bound of the free region. The block applies this force to both the base and follower frames of the joint primitive in order to accelerate the relative position back to the free region.
Dependencies
To enable this port, under X Prismatic Primitive (Px) > Sensing, select Lower-Limit Force.
fulx — Upper-limit force
physical signal
Physical signal port that outputs the upper-limit force. The block applies this force when the joint primitive position exceeds the upper bound of the free region. The block applies this force to both the base and follower frames of the joint primitive in order to accelerate the relative position back to the free region.
Dependencies
To enable this port, under X Prismatic Primitive (Px) > Sensing, select Upper-Limit Force.
py — Position of primitive
physical signal
Physical signal port that outputs the position of the joint primitive. The value is the displacement of the follower frame with respect to the base frame in the y-direction of the base frame.
Dependencies
To enable this port, under Y Prismatic Primitive (Py) > Sensing, select Position.
vy — Velocity of primitive
physical signal
Physical signal port that outputs the velocity of the joint primitive. The value is the first derivative of the signal from the port py.
Dependencies
To enable this port, under Y Prismatic Primitive (Py) > Sensing, select Velocity.
ay — Acceleration of primitive
physical signal
Physical signal port that outputs the acceleration of the joint primitive. The value is the second derivative of the signal from the port py.
Dependencies
To enable this port, under Y Prismatic Primitive (Py) > Sensing, select Acceleration.
fy — Actuator force acting on joint primitive
physical signal
Physical signal port that outputs the actuator force acting on the joint primitive.
Dependencies
To enable this port, under Y Prismatic Primitive (Py) > Sensing, select Actuator Force.
flly — Lower-limit force
physical signal
Physical signal port that outputs the lower-limit force. The block applies this force when the joint primitive position is less than the lower bound of the free region. The block applies this force to both the base and follower frames of the joint primitive in order to accelerate the relative position back to the free region.
Dependencies
To enable this port, under Y Prismatic Primitive (Py) > Sensing, select Lower-Limit Force.
fuly — Upper-limit force
physical signal
Physical signal port that outputs the upper-limit force. The block applies this force when the joint primitive position exceeds the upper bound of the free region. The block applies this force to both the base and follower frames of the joint primitive in order to accelerate the relative position back to the free region.
Dependencies
To enable this port, under Y Prismatic Primitive (Py) > Sensing, select Upper-Limit Force.
pz — Position of joint primitive
physical signal
Physical signal port that outputs the position of the joint primitive. The value is the displacement of the follower frame with respect to the base frame in the z-axis of the base frame.
Dependencies
To enable this port, under Z Prismatic Primitive (Pz) > Sensing, select Position.
vz — Velocity of joint primitive
physical signal
Physical signal port that outputs the velocity of the joint primitive. The value is the first derivative of the signal from the port pz.
Dependencies
To enable this port, under Z Prismatic Primitive (Pz) > Sensing, select Velocity.
az — Acceleration of joint primitive
physical signal
Physical signal port that outputs the acceleration of the joint primitive. The value is the second derivative of the signal from the port pz.
Dependencies
To enable this port, under Z Prismatic Primitive (Pz) > Sensing, select Acceleration.
fz — Actuator force acting on joint primitive
physical signal
Physical signal port that outputs the actuator force acting on the joint primitive.
Dependencies
To enable this port, under Z Prismatic Primitive (Pz) > Sensing, select Actuator Force.
fllz — Lower-limit force acting on joint primitive
physical signal
Physical signal port that outputs the lower-limit force. The block applies this force when the joint primitive position is less than the lower bound of the free region. The block applies this force to both the base and follower frames of the joint primitive in order to accelerate the relative position back to the free region.
Dependencies
To enable this port, under Z Prismatic Primitive (Pz) > Sensing, select Lower-Limit Force.
fulz — Upper-limit force acting on joint primitive
physical signal
Physical signal port that outputs the upper-limit force. The block applies this force when the joint primitive position exceeds the upper bound of the free region. The block applies this force to both the base and follower frames of the joint primitive in order to accelerate the relative position back to the free region.
Dependencies
To enable this port, under Z Prismatic Primitive (Pz) > Sensing, select Upper-Limit Force.
Q — Relative orientation in quaternion parameterization
physical signal
Orientation of the follower frame with respect to the base frame, returned as a vector in quaternion parameterization in the resolution frame. See Quaternion Measurements for more information.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Position.
wx — X-coordinate of relative angular velocity
physical signal
X-coordinate of the relative angular velocity, returned as a scalar. The value is resolved in the resolution frame.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Velocity (X).
wy — Y-coordinate of relative angular velocity
physical signal
Y-coordinate of the relative angular velocity, returned as a scalar. The value is resolved in the resolution frame.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Velocity (Y).
wz — Z-coordinate of relative angular velocity
physical signal
Z-coordinate of the relative angular velocity, returned as a scalar. The value is resolved in the resolution frame.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Velocity (Z).
w — Angular velocity vector
physical signal
Relative angular velocity, returned as a 3-D vector resolved in the resolution frame.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Velocity.
bx — X-coordinate of relative angular acceleration
physical signal
X-coordinate of the relative angular acceleration, returned as a scalar. This quantity equals the time derivative of the signal exported from the port wx.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Acceleration (X).
by — Y-coordinate of relative angular acceleration
physical signal
Y-coordinate of the relative angular acceleration, returned as a scalar. This quantity equals the time derivative of the signal exported from the port wy.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Acceleration (Y).
bz — Z-coordinate of relative angular acceleration
physical signal
Z-coordinate of the relative angular acceleration, returned as a scalar. This quantity equals the time derivative of the signal exported from the port wz.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Acceleration (Z).
b — Angular acceleration vector
physical signal
Relative angular acceleration, returned as a 3-D vector resolved in the resolution frame. This quantity equals the time derivative of the signal exported from the port w.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Acceleration.
tll — Lower-limit torque magnitude
physical signal
Physical signal port that outputs the lower-limit torque. The block applies the torque when the joint primitive position is less than the lower bound of the free region. The torque applies to both the base and follower frames of the joint primitive to accelerate the position back to the free region.
Dependencies
To enable this port, under Spherical Primitive (S) > Sensing, select Signed Lower-Limit Torque Magnitude.
tul — Upper-limit torque magnitude
physical signal
Physical signal port that outputs the upper-limit torque. The block applies the torque when the joint primitive position exceeds the upper bound of the free region. The torque applies to both the base and follower frames of the joint primitive to accelerate the position back to the free region.
Dependencies
To enable this port, under
To enable this port, under Spherical Primitive (S) > Sensing, select Upper-Limit Torque.
fc — Constraint force
physical signal
Physical signal port that outputs the constraint forces that act across the joint. The force maintains the translational constraints of the joint. For more information, see Measure Joint Constraint Forces.
Dependencies
To enable this port, under Composite Force/Torque Sensing, select Constraint Force.
tc — Constraint torque
physical signal
Physical signal port that outputs the constraint torques that act across the joint. The torque maintains the rotational constraints of the joint. For more information, see Force and Torque Sensing.
Dependencies
To enable this port, under Composite Force/Torque Sensing, select Constraint Torque.
ft — Total force
physical signal
Physical signal port that outputs the total force that acts across the joint. The total force is the sum of the forces transmitted from one frame to the other through the joint. The force includes the actuation, internal, limit, and constraint forces. See Force and Torque Sensing for more information.
Dependencies
To enable this port, under Composite Force/Torque Sensing, select Total Force.
tt — Total torque
physical signal
Physical signal port that outputs the total torque that acts across the joint. The total torque is the sum of the torques transmitted from one frame to the other through the joint. The torque includes the actuation, internal, limit, and constraint torques. For more information, see Force and Torque Sensing.
Dependencies
To enable this port, under Composite Force/Torque Sensing, select Total Torque.
Parameters
X Prismatic Primitive (Px)
State TargetsSpecify Position Target — Whether to specify position target
off
(default) | on
Select this parameter to specify the position target for the x prismatic primitive.
Priority — Priority level of position target
High (desired)
(default) | Low (approximate)
Priority level of the position target, specified as High
(desired)
or Low (approximate)
. For
more information, see the Guiding Assembly section of How Multibody Assembly Works.
Dependencies
To enable this parameter, select Specify Position Target.
Value — Position target
0 m
(default) | scalar
Position target of the x prismatic primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Position Target.
Specify Velocity Target — Whether to specify linear velocity target
off
(default) | on
Select this parameter to specify the linear velocity target for the x prismatic primitive.
Priority — Priority level of linear velocity target
High (desired)
(default) | Low (approximate)
Priority level of the linear velocity target, specified as High
(desired)
or Low (approximate)
. For
more information, see the Guiding Assembly section of How Multibody Assembly Works.
Dependencies
To enable this parameter, select Specify Velocity Target.
Value — Velocity target
0 m/s
(default) | scalar
Linear velocity target for the x prismatic primitive, specified as a scalar in units of linear velocity.
Dependencies
To enable this parameter, select Specify Velocity Target.
Equilibrium Position — Position where internal force is zero
0 m
(default) | scalar
Position where the spring force is zero, specified as a scalar in units of length.
Spring Stiffness — Stiffness of force law
0 N/m
(default) | scalar
Stiffness of the internal spring-damper force law for the joint primitive, specified as a scalar in units of linear stiffness.
Damping Coefficient — Damping coefficient of force law
0 N(m/s)
(default) | scalar
Damping coefficient of the internal spring-damper force law for the joint primitive, specified as a scalar in units of linear damping coefficient.
Specify Lower Limit — Whether to specify lower position limit
off
(default) | on
Select this parameter to specify the lower limit of the x prismatic primitive.
Bound — Lower bound of free region
-1 m
(default) | scalar
Lower bound of the free region of the x prismatic primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Lower Limit.
Spring Stiffness — Stiffness of spring at lower bound
1e6 N/m
(default) | scalar
Stiffness of the spring at the lower bound, specified as a scalar in units of linear stiffness.
Dependencies
To enable this parameter, select Specify Lower Limit.
Damping Coefficient — Damping coefficient at lower bound
1e3 N/(m/s)
(default) | scalar
Damping coefficient at the lower bound, specified as a scalar in units of linear damping coefficient.
Dependencies
To enable this parameter, select Specify Lower Limit.
Transition Region Width — Region to smooth spring and damper forces
1e-4 m
(default) | scalar
Region to smooth the spring and damper forces, specified as a scalar in units of length.
The block applies the full value of the lower-limit force when the penetration reaches the width of the transition region. The smaller the region, the sharper the onset of forces and the smaller the time step required of the solver. In the tradeoff between simulation accuracy and simulation speed, reducing the transition region improves accuracy and expanding it improves speed.
Dependencies
To enable this parameter, select Specify Lower Limit.
Specify Upper Limit — Whether to specify upper position limit
off
(default) | on
Select this parameter to specify the upper limit of the x prismatic primitive.
Bound — Upper bound of free region
1 m
(default) | scalar
Upper bound for the free region of the joint primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Upper Limit.
Spring Stiffness — Stiffness of spring at upper bound
1e6 N/m
(default) | scalar
Stiffness of the spring at the upper bound, specified as a scalar in units of linear stiffness.
Dependencies
To enable this parameter, select Specify Upper Limit.
Damping Coefficient — Damping coefficient at upper bound
1e3 N/(m/s)
(default) | scalar
Damping coefficient at the upper bound, specified as a scalar in units of linear damping coefficient.
Dependencies
To enable this parameter, select Specify Upper Limit.
Transition Region Width — Region to smooth spring and damper forces
1e-4 m
(default) | scalar
Region to smooth the spring and damper forces, specified as a scalar in units of length.
The block applies the full value of the upper-limit force when the penetration reaches the width of the transition region. The smaller the region, the sharper the onset of forces and the smaller the time step required of the solver. In the tradeoff between simulation accuracy and simulation speed, reducing the transition region improves accuracy and expanding it improves speed.
Dependencies
To enable this parameter, select Specify Upper Limit.
Force — Option to provide actuator force
None
(default) | Provided by Input
| Automatically Computed
Option to provide the actuator force for the joint primitive, specified as one of these values:
Force Setting | Description |
---|---|
None | No actuator force. |
Provided by Input | The input port fx specifies the actuator force for the x prismatic primitive. |
Automatically Computed | The block automatically calculates the amount of force
required to satisfy the motion inputs to the mechanism. If you
set this parameter to Automatically
Computed , you do not need to set
Motion to Provided by
Input for the same joint primitive. The
automatically computed force may satisfy a motion input
elsewhere in the mechanism. |
Motion — Option to provide motion
Automatically Computed
(default) | Provided by Input
Option to provide the motion for the joint primitive, specified as one of these values:
Motion Setting | Description |
---|---|
Automatically Computed | The block computes and applies the joint primitive motion based on the model dynamics. |
Provided by Input | The input port px specifies the motion for the joint primitive. |
Y Prismatic Primitive (Py)
State TargetsSpecify Position Target — Whether to specify position target
off
(default) | on
Select this parameter to specify the position target for the y prismatic primitive.
Priority — Priority level of position target
High (desired)
(default) | Low (approximate)
Priority level of the position target, specified as High
(desired)
or Low (approximate)
. For
more information, see the Guiding Assembly section of How Multibody Assembly Works.
Dependencies
To enable this parameter, select Specify Position Target.
Value — Position target
0 m
(default) | scalar
Position target of the y prismatic primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Position Target.
Specify Velocity Target — Whether to specify linear velocity target
off
(default) | on
Select this parameter to specify the linear velocity target for the y prismatic primitive.
Priority — Priority level of linear velocity target
High (desired)
(default) | Low (approximate)
Priority level of the linear velocity target, specified as High
(desired)
or Low (approximate)
. For
more information, see the Guiding Assembly section of How Multibody Assembly Works.
Dependencies
To enable this parameter, select Specify Velocity Target.
Value — Velocity target
0 m/s
(default) | scalar
Linear velocity target for the y prismatic primitive, specified as a scalar in units of linear velocity.
Dependencies
To enable this parameter, select Specify Velocity Target.
Equilibrium Position — Position where internal force is zero
0 m
(default) | scalar
Position where the spring force is zero, specified as a scalar in units of length.
Spring Stiffness — Stiffness of force law
0 N/m
(default) | scalar
Stiffness of the internal spring-damper force law for the joint primitive, specified as a scalar in units of linear stiffness.
Damping Coefficient — Damping coefficient of force law
0 N(m/s)
(default) | scalar
Damping coefficient of the internal spring-damper force law for the joint primitive, specified as a scalar in units of linear damping coefficient.
Specify Lower Limit — Whether to specify lower position limit
off
(default) | on
Select this parameter to specify the lower limit of the y prismatic primitive.
Bound — Lower bound of free region
-1 m
(default) | scalar
Lower bound of the free region of the y prismatic primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Lower Limit.
Spring Stiffness — Stiffness of spring at lower bound
1e6 N/m
(default) | scalar
Stiffness of the spring at the lower bound, specified as a scalar in units of linear stiffness.
Dependencies
To enable this parameter, select Specify Lower Limit.
Damping Coefficient — Damping coefficient at lower bound
1e3 N/(m/s)
(default) | scalar
Damping coefficient at the lower bound, specified as a scalar in units of linear damping coefficient.
Dependencies
To enable this parameter, select Specify Lower Limit.
Transition Region Width — Region to smooth spring and damper forces
1e-4 m
(default) | scalar
Region to smooth the spring and damper forces, specified as a scalar in units of length.
The block applies the full value of the lower-limit force when the penetration reaches the width of the transition region. The smaller the region, the sharper the onset of forces and the smaller the time step required of the solver. In the tradeoff between simulation accuracy and simulation speed, reducing the transition region improves accuracy and expanding it improves speed.
Dependencies
To enable this parameter, select Specify Lower Limit.
Specify Upper Limit — Whether to specify upper position limit
off
(default) | on
Select this parameter to specify the upper limit of the y prismatic primitive.
Bound — Upper bound of free region
1 m
(default) | scalar
Upper bound for the free region of the joint primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Upper Limit.
Spring Stiffness — Stiffness of spring at upper bound
1e6 N/m
(default) | scalar
Stiffness of the spring at the upper bound, specified as a scalar in units of linear stiffness.
Dependencies
To enable this parameter, select Specify Upper Limit.
Damping Coefficient — Damping coefficient at upper bound
1e3 N/(m/s)
(default) | scalar
Damping coefficient at the upper bound, specified as a scalar in units of linear damping coefficient.
Dependencies
To enable this parameter, select Specify Upper Limit.
Transition Region Width — Region to smooth spring and damper forces
1e-4 m
(default) | scalar
Region to smooth the spring and damper forces, specified as a scalar in units of length.
The block applies the full value of the upper-limit force when the penetration reaches the width of the transition region. The smaller the region, the sharper the onset of forces and the smaller the time step required of the solver. In the tradeoff between simulation accuracy and simulation speed, reducing the transition region improves accuracy and expanding it improves speed.
Dependencies
To enable this parameter, select Specify Upper Limit.
Force — Option to provide actuator force
None
(default) | Provided by Input
| Automatically Computed
Option to provide the actuator force for the joint primitive, specified as one of these values:
Force Setting | Description |
---|---|
None | No actuator force. |
Provided by Input | The input port fy specifies the actuator force for the y prismatic primitive. |
Automatically Computed | The block automatically calculates the amount of force
required to satisfy the motion inputs to the mechanism. If you
set this parameter to Automatically
Computed , you do not need to set
Motion to Provided by
Input for the same joint primitive. The
automatically computed force may satisfy a motion input
elsewhere in the mechanism. |
Motion — Option to provide motion
Automatically Computed
(default) | Provided by Input
Option to provide the motion for the joint primitive, specified as one of these values:
Motion Setting | Description |
---|---|
Automatically Computed | The block computes and applies the joint primitive motion based on the model dynamics. |
Provided by Input | The input port py specifies the motion for the joint primitive. |
Z Prismatic Primitive (Pz)
State TargetsSpecify Position Target — Whether to specify position target
off
(default) | on
Select this parameter to specify the position target for the z prismatic primitive.
Priority — Priority level of position target
High (desired)
(default) | Low (approximate)
Priority level of the position target, specified as High (desired)
or Low (approximate)
.
For more information, see the Guiding Assembly
section of How Multibody Assembly Works.
Dependencies
To enable this parameter, select Specify Position Target.
Value — Position target
0 m
(default) | scalar
Position target of the z prismatic primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Position Target.
Specify Velocity Target — Whether to specify linear velocity target
off
(default) | on
Select this parameter to specify the linear velocity target for the z prismatic primitive.
Priority — Priority level of linear velocity target
High (desired)
(default) | Low (approximate)
Priority level of the linear velocity target, specified as High
(desired)
or Low
(approximate)
. For more information,
see the Guiding Assembly section of How Multibody Assembly Works.
Dependencies
To enable this parameter, select Specify Velocity Target.
Value — Velocity target
0
m/s
(default) | scalar
Linear velocity target for the z prismatic primitive, specified as a scalar in units of linear velocity.
Dependencies
To enable this parameter, select Specify Velocity Target.
Equilibrium Position — Position where internal force is zero
0 m
(default) | scalar
Position where the spring force is zero, specified as a scalar in units of length.
Spring Stiffness — Stiffness of force law
0 N/m
(default) | scalar
Stiffness of the internal spring-damper force law for the joint primitive, specified as a scalar in units of linear stiffness.
Damping Coefficient — Damping coefficient of force law
0 N(m/s)
(default) | scalar
Damping coefficient of the internal spring-damper force law for the joint primitive, specified as a scalar in units of linear damping coefficient.
Specify Lower Limit — Whether to specify lower position limit
off
(default) | on
Select this parameter to specify the lower limit of the z prismatic primitive.
Bound — Lower bound of free region
-1 m
(default) | scalar
Lower bound of the free region of the z prismatic primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Lower Limit.
Spring Stiffness — Stiffness of spring at lower bound
1e6 N/m
(default) | scalar
Stiffness of the spring at the lower bound, specified as a scalar in units of linear stiffness.
Dependencies
To enable this parameter, select Specify Lower Limit.
Damping Coefficient — Damping coefficient at lower bound
1e3 N/(m/s)
(default) | scalar
Damping coefficient at the lower bound, specified as a scalar in units of linear damping coefficient.
Dependencies
To enable this parameter, select Specify Lower Limit.
Transition Region Width — Region to smooth spring and damper forces
1e-4 m
(default) | scalar
Region to smooth the spring and damper forces, specified as a scalar in units of length.
The block applies the full value of the lower-limit force when the penetration reaches the width of the transition region. The smaller the region, the sharper the onset of forces and the smaller the time step required of the solver. In the tradeoff between simulation accuracy and simulation speed, reducing the transition region improves accuracy and expanding it improves speed.
Dependencies
To enable this parameter, select Specify Lower Limit.
Specify Upper Limit — Whether to specify upper position limit
off
(default) | on
Select this parameter to specify the upper limit of the z prismatic primitive.
Bound — Upper bound of free region
1 m
(default) | scalar
Upper bound for the free region of the joint primitive, specified as a scalar in units of length.
Dependencies
To enable this parameter, select Specify Upper Limit.
Spring Stiffness — Stiffness of spring at upper bound
1e6 N/m
(default) | scalar
Stiffness of the spring at the upper bound, specified as a scalar in units of linear stiffness.
Dependencies
To enable this parameter, select Specify Upper Limit.
Damping Coefficient — Damping coefficient at upper bound
1e3 N/(m/s)
(default) | scalar
Damping coefficient at the upper bound, specified as a scalar in units of linear damping coefficient.
Dependencies
To enable this parameter, select Specify Upper Limit.
Transition Region Width — Region to smooth spring and damper forces
1e-4 m
(default) | scalar
Region to smooth the spring and damper forces, specified as a scalar in units of length.
The block applies the full value of the upper-limit force when the penetration reaches the width of the transition region. The smaller the region, the sharper the onset of forces and the smaller the time step required of the solver. In the tradeoff between simulation accuracy and simulation speed, reducing the transition region improves accuracy and expanding it improves speed.
Dependencies
To enable this parameter, select Specify Upper Limit.
Force — Option to provide actuator force
None
(default) | Provided by Input
| Automatically Computed
Option to provide the actuator force for the joint primitive, specified as one of these values:
Force Setting | Description |
---|---|
None | No actuator force. |
Provided by Input | The input port fz specifies the actuator force for the z prismatic primitive. |
Automatically Computed | The block automatically calculates the amount of force required to satisfy the motion inputs
to the mechanism. If you set this parameter to
Automatically Computed ,
you do not need to set Motion
to Provided by Input
for the same joint primitive. The automatically
computed force may satisfy a motion input
elsewhere in the mechanism. |
Motion — Option to provide motion
Automatically Computed
(default) | Provided by Input
Option to provide the motion for the joint primitive, specified as one of these values:
Motion Setting | Description |
---|---|
Automatically Computed | The block computes and applies the joint primitive motion based on the model dynamics. |
Provided by Input | The input port pz specifies the motion for the joint primitive. |
Spherical Primitive (S)
State TargetsSpecify Position Target — Whether to specify relative orientation target
off
(default) | on
Select this parameter to specify the target of the relative orientation between the base and follower frames.
Priority — Priority level of relative orientation target
High (desired)
(default) | Low (approximate)
Priority level of the relative orientation target, specified as High (desired)
or Low (approximate)
. See Guiding Assembly for more information.
Dependencies
To enable this parameter, select Specify Position Target.
Value > Method — Method to specify relative orientation target
None
(default) | Aligned Axes
| Standard Axis
| Arbitrary Axis
| Rotation Sequence
| Rotation Matrix
| Quaternion
Method to use to specify the relative orientation target between the base and follower frames.
When specifying the parameter to None
, the follower
and base frames have the same orientation at the beginning of the
simulation.
Dependencies
To enable this parameter, select Specify Position Target.
Pair 1: Follower — Follower frame axis used to align with specified base frame axis
+X
(default) | -X
| +Y
| -Y
| +Z
| -Z
Follower frame axis used to align with the base frame axis set by the Pair 1: Base parameter, specified as an orthogonal axis of the follower frame. The follower frame rotates with respect to the base frame to enable the alignment between the selected axes of the base and follower frames.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Aligned Axis
.
Pair 1: Base — Base frame axis
+Y
(default) | +X
| -X
| -Y
| +Z
| -Z
Base frame axis to align with the follower frame specified by the Pair 1: Follower, specified as an orthogonal axis of the base frame.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Aligned Axis
.
Pair 2: Follower — Follower frame axis used to align with specified base frame axis
+Y
| +X
| -X
| -Y
| +Z
| -Z
Base frame axis to align with the follower frame specified by the Pair 2: Follower, specified as an orthogonal axis of the follower frame. The follower frame rotates with respect to the base frame to enable the alignment between the selected axes of the base and follower frames.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Aligned Axis
.
Pair2: Base — Base frame axis
+Z
(default) | +X
| -X
| +Y
| -Y
| -Z
Base frame axis used to let the follower frame axis set in the Pair2: Follower parameter to align with, specified as an orthogonal axis of the base frame. The axis choices for Pair 2 depend on the Pair 1 axis selections.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Aligned Axis
.
Axis — Standard axis of relative rotation
+Z
(default) | +X
| -X
| +Y
| -Y
| -Z
Axis of the relative rotation, specified as an orthogonal axis of the base frame.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Standard Axis
.
Angle — Angle of relative rotation
0.0 deg
(default) | scalar
Angle of the relative rotation, specified as a scalar. The angle indicates the rotation of the follower frame with respect to the base frame about the specified axis.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Standard Axis
.
Axis — Axis of relative rotation
[0 0 1] (default) | 3-by1 vector
Axis of the relative rotation, specified as a 3-by-1 unit vector. The vector is dimensionless and indicates the rotational axis resolved in the base frame.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Arbitrary Axis
.
Angle — Angle of relative rotation
0.0 deg
(default) | scalar
Angle of the relative rotation, specified as a scalar. The angle indicates the rotation of the follower frame with respect to the base frame about the axis specified by the Axis parameter.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Arbitrary Axis
.
Rotation About — Frame whose axes to rotate follower frame about
Follower Axes
(default) | Base Axes
Frame whose axes to rotate the follower frame about, specified as Follower Axes
or Base Axes
. If you set the parameter to Follower Axes
, the follower frame rotates about its own axes, and the follower frame changes the orientation with each successive rotation. If you set the parameter to Base Axes
, the follower frame rotates about the fixed base frame axes. See Rotational Measurements for more information.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Rotation Sequence
.
Sequence — Sequence of rotation axis
X-Y-X
(default) | X-Y-Z
| X-Z-X
| X-Z-Y
| Y-X-Y
| Y-X-Z
| Y-Z-X
| Y-Z-Y
| Z-X-Y
| Z-X-Z
| Z-Y-X
| Z-Y-Z
Sequence of the rotation axis for three successive elementary rotations. See Rotation Sequence Measurements for more information.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Rotation Sequence
.
Angles — Angles for rotation sequence parameterization
[0 0 0] deg
(default) | 1-by-3 vector
Angles for the rotation sequence parameterization, specified as a 1-by-3 vector. See Rotation Sequence Measurements for more information.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to
Rotation Sequence
.
Rotation Matrix — Relative rotation using rotation matrix
[1 0 0; 0 1 0; 0 0 1] (default) | 3-by-3 matrix
Relative rotation, specified as a 3-by-3 matrix that maps vectors from the follower frame to the base frame. The matrix must be orthogonal and have determinant 1. See Rotational Measurements for more information.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Rotation Matrix
.
Quaternion — Relative rotation using quaternion
[1 0 0 0] (default) | unit quaternion vector
Relative rotation, specified as a unit quaternion vector. See Rotational Measurements for more information about the quaternion.
Dependencies
To enable this parameter, under Specify Position Target > Value, set Method parameter to Quaternion
.
Specify Velocity Target — Whether to specify angular velocity target
off
(default) | on
Select this parameter to specify the angular velocity target for the spherical primitive.
Priority — Priority level of angular velocity target
High (desired)
(default) | Low (approximate)
Priority level of the angular velocity target, specified as High
(desired)
or Low (approximate)
. See
Guiding Assembly for more information.
Dependencies
To enable this parameter, select Specify Velocity Target.
Value — Angular velocity target of spherical primitive
[0 0 0] deg/s
(default) | 1-by-3 vector
Angular velocity target for the spherical primitive, specified as a 1-by-3 vector resoved in resolution frame.
Dependencies
To enable this parameter, select Specify Velocity Target.
Resolution Frame — Frame used to resolve specified angular velocity target
Base
(default) | Follower
Frame used to resolve the specified angular velocity target, specified as one of these:
Base
— The joint block resolves the angular velocity target in the coordinates of the base frame.Follower
— The joint block resolves the angular velocity target in the coordinates of the follower frame.
Equilibrium Position > Method — Method to specify equilibrium frame
None
(default) | Aligned Axes
| Standard Axis
| Arbitrary Axis
| Rotation Sequence
| Rotation Matrix
| Quaternion
Method to use to specify the equilibrium frame with respect to the base frame. The equilibrium frame is fixed during the simulation. If the z-axes of the follower and equilibrium frames are aligned, the spring torque of the spherical primitive is zero.
Set the Equilibrium Position > Method parameter to None
to let the equilibrium and base frames be coincident.
Pair 1: Follower — Equilibrium frame axis used to align with specified base frame axis
+X
(default) | -X
| +Y
| -Y
| +Z
| -Z
Equilibrium frame axis used to align with the base frame axis set by the Pair 1: Base parameter, specified as an orthogonal axis of the equilibrium frame. The equilibrium frame rotates with respect to the base frame to enable the alignment between the selected axes of the base and equilibrium frames.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Aligned Axis
.
Pair 1: Base — Base frame axis
+Y
(default) | +X
| -X
| -Y
| +Z
| -Z
Base frame axis to align with the equilibrium frame specified by the Pair 1: Follower, specified as an orthogonal axis of the base frame.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Aligned Axis
.
Pair 2: Follower — Equilibrium frame axis used to align with specified base frame axis
+Y
| +X
| -X
| -Y
| +Z
| -Z
Base frame axis to align with the equilibrium frame specified by the Pair 2: Follower, specified as an orthogonal axis of the equilibrium frame. The equilibrium frame rotates with respect to the base frame to enable the alignment between the selected axes of the base and equilibrium frames.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Aligned Axis
.
Pair2: Base — Base frame axis
+Z
(default) | +X
| -X
| +Y
| -Y
| -Z
Base frame axis used to let the equilibrium frame axis set in the Pair2: Follower parameter to align with, specified as an orthogonal axis of the base frame. The axis choices for Pair 2 depend on the Pair 1 axis selections.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Aligned Axis
.
Axis — Standard axis of relative rotation
+Z
(default) | +X
| -X
| +Y
| -Y
| -Z
Axis of the relative rotation, specified as an orthogonal axis of the base frame.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Standard Axis
.
Angle — Angle of relative rotation
0.0 deg
(default) | scalar
Angle of the relative rotation, specified as a scalar. The angle indicates the rotation of the equilibrium frame with respect to the base frame about the specified axis.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Standard Axis
.
Axis — Axis of relative rotation
[0 0 1] (default) | 3-by1 vector
Axis of the relative rotation, specified as a 3-by-1 unit vector. The vector is dimensionless and indicates the rotational axis resolved in the base frame.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Arbitrary Axis
.
Angle — Angle of relative rotation
0.0 deg
(default) | scalar
Angle of the relative rotation, specified as a scalar. The angle indicates the rotation of the equilibrium frame with respect to the base frame about the axis specified by the Axis parameter.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Arbitrary Axis
.
Rotation About — Frame whose axes to rotate equilibrium frame about
Follower Axes
(default) | Base Axes
Frame whose axes to rotate the equilibrium frame about, specified as Follower Axes
or Base Axes
. If you set the parameter to Follower Axes
, the equilibrium frame rotates about its own axes, and the equilibrium frame changes the orientation with each successive rotation. If you set the parameter to Base Axes
, the equilibrium frame rotates about the fixed base frame axes. See Rotational Measurements for more information.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Rotation Sequence
.
Sequence — Sequence of rotation axis
X-Y-X
(default) | X-Y-Z
| X-Z-X
| X-Z-Y
| Y-X-Y
| Y-X-Z
| Y-Z-X
| Y-Z-Y
| Z-X-Y
| Z-X-Z
| Z-Y-X
| Z-Y-Z
Sequence of the rotation axis for three successive elementary rotations. See Rotation Sequence Measurements for more information.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Rotation Sequence
.
Angles — Angles for elementary rotations
[0 0 0] deg
(default) | 1-by-3 vector
Angles for elementary rotations, specified as a 1-by-3 vector. See Rotation Sequence Measurements for more information.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Rotation Sequence
.
Matrix — Relative rotation using rotation matrix
[1 0 0; 0 1 0; 0 0 1] (default) | 3-by-3 matrix
Relative rotation, specified as a 3-by-3 matrix. The matrix must be orthogonal and have determinant 1. See Rotational Measurements for more information.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Rotation Matrix
.
Quaternion — Relative rotation using quaternion
[1 0 0 0] (default) | unit quaternion vector
Relative rotation, specified as a unit quaternion vector. See Rotational Measurements for more information about the quaternion.
Dependencies
To enable this parameter, under Equilibrium Position, set Method parameter to Quaternion
.
Spring Stiffness — Stiffness of force law
0 N*m/deg
(default) | scalar
Stiffness of the internal spring-damper force law for the spherical primitive, specified as a scalar with a unit of rotational stiffness.
The spring attempts to pull the follower frame so that the follower frame is aligned with the specified equilibrium fame.
Damping Coefficient — Damping coefficient of force law
0 N*m/(deg/s)
(default) | scalar
Damping coefficient of the internal spring-damper force law for the spherical primitive, specified as a scalar with a unit of rotational damping coefficient.
Specify Lower Limit — Whether to specify lower position limit
off
(default) | on
Select this parameter to specify the lower limit of the spherical primitive. Joint limits use spring-dampers to resist travel past the bounds of the range.
Bound — Lower bound of free region
15 deg
(default) | scalar
Lower bound for the free region of the spherical primitive, specified as a scalar with a unit of angle.
Dependencies
To enable this parameter, select Specify Lower Limit.
Spring Stiffness — Stiffness of spring at lower bound
1e4 N*m/deg
(default) | scalar
Stiffness of the spring at lower bound, specified as a scalar with a unit of rotational stiffness.
Dependencies
To enable this parameter, select Specify Lower Limit.
Damping Coefficient — Damping coefficient at lower bound
10 N*m/(deg/s)
(default) | scalar
Damping coefficient at lower bound, specified as a scalar with a unit of rotational damping coefficient.
Dependencies
To enable this parameter, select Specify Lower Limit.
Transition Region Width — Region to smooth spring and damper torque
0.1 deg
(default) | scalar
Region to smooth the spring and damper torques, specified as a scalar with a unit of angle.
The block applies the full value of the lower-limit torque when the penetration reaches the width of the transition region. The smaller the region, the sharper the onset of torques and the smaller the time-step required of the solver. In the trade-off between simulation accuracy and simulation speed, reducing the transition region improves accuracy while expanding it improves speed.
Dependencies
To enable this parameter, select Specify Lower Limit.
Specify Upper Limit — Whether to specify upper position limit
off
(default) | on
Select this parameter to specify the upper limit of the spherical primitive. Joint limits use spring-dampers to resist travel past the bounds of the range.
Bound — Upper bound of free region
45 deg
(default) | scalar
Upper bound for the free region of the spherical primitive, specified as a scalar with a unit of angle.
Dependencies
To enable this parameter, select Specify Upper Limit.
Spring Stiffness — Stiffness of spring at upper bound
1e4 N*m/deg
(default) | scalar
Stiffness of the spring at upper bound, specified as a scalar with a unit of stiffness.
Dependencies
To enable this parameter, select Specify Upper Limit.
Damping Coefficient — Damping coefficient at upper bound
10 N*m/(deg/s)
(default) | scalar
Damping coefficient at upper bound, specified as a scalar with a unit of damping coefficient.
Dependencies
To enable this parameter, select Specify Upper Limit.
Transition Region Width — Region to smooth spring and damper torques
0.1 deg
(default) | scalar
Region to smooth the spring and damper torques, specified as a scalar with a unit of angle.
The block applies the full value of the upper-limit torque when the penetration reaches the width of the transition region. The smaller the region, the sharper the onset of torques and the smaller the time-step required of the solver. In the trade-off between simulation accuracy and simulation speed, reducing the transition region improves accuracy while expanding it improves speed.
Dependencies
To enable this parameter, select Specify Upper Limit.
Torque — Option to provide actuation torque
None
(default) | Provided by Input
Option to provide the actuation torque for the spherical primitive, specified as one of these values.
Actuation Torque Setting | Description |
---|---|
None | Apply no actuation torque. |
Provided by Input | Apply actuation torques based on physical signals. The signal specifies the torque acting on the follower frame with respect to the base frame. The signal provides the value of the torque applied equally and oppositely to the base and follower frames. Selecting this option exposes additional parameters that you can use to enable input ports See the Input section for details. |
Resolution Frame — Frame used to resolve actuation torque
Base
(default) | Follower
Frame used to resolve the input actuation torques, specified as Base
or Follower
.
Resolution Frame — Frame used to resolve sensing outputs
Base
(default) | Follower
Frame used to resolve the sensing output signals, specified as
Base
or Follower
. For
more information about the output signals, see the Output
section.
Mode Configuration
Mode — Joint mode
Normal
(default) | Locked
| Disengaged
| Provided by Input
Joint mode for the simulation, specified as one of these values:
Mode | Description |
---|---|
Locked | Locked mode constrains all the degrees of freedom (DOFs) for the joint. The locked joint maintains its initial assembly position with zero velocity during the simulation. The joint block can sense forces or torques in accordance with the settings of the Internal Mechanics, Limits, and Actuation parameters. |
Normal | Normal mode enables the DOFs and the constraints of the joint work as intended during the simulation. |
Disengaged | Disengaged mode releases the joint from all constraints throughout the simulation. The settings for Internal Mechanics, Limits, and Actuation parameters do not affect the disengaged joint. All output ports output zero. |
Provided by Input | The Provided by Input option allows you to specify the joint mode
by using an input signal. For more information, see the port
mode in the Input
section. |
Composite Force/Torque Sensing
Direction — Measurement direction
Follower on Base
(default) | Base on Follower
Measurement direction, specified as one of these values:
Follower on Base
— The block senses the force and torque that the follower frame exerts on the base frame.Base on Follower
— The block senses the force and torque that the base frame exerts on the follower frame.
This parameter affects only the output signals under the Composite Force/Torque Sensing section. Reversing the direction changes the sign of the measurements. For more information, see Force and Torque Measurement Direction.
Resolution Frame — Frame used to resolve measurements
Base
(default) | Follower
Frame used to resolve the measurements, specified as one of these values:
Base
— The block resolves the measurements in the coordinates of the base frame.Follower
— The block resolves the measurements in the coordinates of the follower frame.
This parameter affects only the output signals under the Composite Force/Torque Sensing section.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Version History
Introduced in R2012a
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)