Professional Documents
Culture Documents
Library
First Generation/Joints
Description
Warning
This content is specific to Simscape™ Multibody™ First Generation software. First-generation features are
slated to be deprecated and should be avoided.
The Gimbal block represents a composite joint with three rotational degrees of freedom (DoFs) as three revolute
primitives. There are no constraints among the primitives.
Warning
A joint with three revolute primitives becomes singular if two or three of the rotation axes become parallel
(“gimbal lock”). The simulation stops with an error in this case.
A joint with three revolute primitives must be configured in the initial state with the three revolute primitive axes
mutually orthogonal. There are no restrictions on the primitive axes once the simulation starts, except to
prevent any two of the primitive axes from becoming parallel.
Satisfying Joint Requirements
A Joint block represents the relative degrees of freedom between two bodies, not the bodies themselves.
You must connect any Joint block to two and only two Body blocks, the base and the follower. All Joints have two
connector ports for these connections, defining the direction of joint motion (base to follower). You connect each side of
the Joint block to these Body blocks at a Body coordinate system (CS) port.
You specify the joint primitive axes, if any, in the Joint dialog.
• If the Joint has no prismatic primitives, the origins of the connected Body CSs on either side of the Joint must be
spatially collocated points, to within assembly tolerances.
• If the Joint has one or more prismatic primitives, the origins of the connected Body CSs must lie in the span of the
prismatic axes:
Connection Parameters
The base (B)-follower (F) Body sequence determines the sense of positive motion. Positive rotation is the follower
moving around the rotational axis following the right-hand rule.
Current base
When you connect the base (B) connector port on the Gimbal block to a Body CS Port on a Body, this parameter is
automatically reset to the name of this Body CS. See the following figure, Gimbal Base and Follower Body Connector
Ports.
The base Body is automatically connected to the first joint primitive R1 in the primitive list in Parameters.
Current follower
When you connect the follower (F) connector port on the Gimbal block to a Body CS Port on a Body, this parameter is
automatically reset to the name of this Body CS. See the following figure, Gimbal Base and Follower Body Connector
Ports.
The follower Body is automatically connected to the last joint primitive R3 in the primitive list in Parameters.
Parameters
Switch between the Axes and Advanced tabs.
Axes Tab
The entries on the Axes tab are required. Each DoF primitive in Gimbal has an entry line. These lines specify the
direction of the axes of action of the DoFs that the Gimbal represents.
Name - Primitive
The primitive list states the names and types of joint primitives that make up the Gimbal block: revolute primitives R1,
R2, R3.
Axis of Action [x y z]
Enter here as a three-component vector the directional axes defining the allowed motions of these primitives and their
corresponding DoFs:
The default vectors are shown in the dialog above. The axis is a directed vector whose overall sign matters.
To prevent singularities and simulation errors, no two of the revolute axes can be parallel.
Reference CS
Using the pull-down menu, choose the coordinate system (World, the base Body CS, or the follower Body CS) whose
coordinate axes the vector axis of action is oriented with respect to. This CS also determines the absolute meaning of
forces/torques and motion along/about the joint axis. The default is World.
Restricted Parameters
Advanced Tab
The Advanced tab is optional. You use it to control the way Simscape Multibody simulation interprets the topology of
your schematic diagram.
See Also
Revolute, Spherical
See Modeling Degrees of Freedom for more on representing DoFs with Joints.
See Checking Model Topology and How Simscape Multibody Software Works for more on closed loops and cutting.