Joint with three revolute and three prismatic joint primitives


First Generation/Joints



This content is specific to Simscape™ Multibody™ First Generation software. First-generation features are slated to be deprecated and should be avoided.

The Six-DoF block represents a composite joint with three translational degrees of freedom (DoFs) as three prismatic primitives and three rotational DoFs as one spherical primitives. There are no constraints among the primitives. Unlike Bushing, Six-DoF represents the rotational DoFs as one spherical, rather than as three revolutes.


A joint with three prismatic primitives becomes singular if two or three of the translation axes become parallel. The simulation stops with an error in this case.

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.

Assembly Restrictions on Assembled Joints

This Joint block is assembled and places restrictions on the connected Body CSs.

  • 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:

    Number of Prismatic PrimitivesSpan of Primitive Axes
    OneAlong the primitive axis
    TwoIn the plane of the primitive axes
    ThreeAnywhere in three-dimensional space

Dialog Box and Parameters

The dialog has two active areas, Connection parameters and Parameters.

Connection Parameters

The base (B)-follower (F) Body sequence determines the sense of positive motion. Positive translation is the follower moving in the direction of the translation axis. Positive spherical motion is the follower rotating in the right-handed sense as shown in the Spherical block figure.

Current base

When you connect the base (B) connector port on the Six-DoF 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, Six-DoF Base and Follower Body Connector Ports.

The base Body is automatically connected to the first joint primitive P1 in the primitive list in Parameters.

Current follower

When you connect the follower (F) connector port on the Six-DoF 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, Six-DoF Base and Follower Body Connector Ports.

The follower Body is automatically connected to the last joint primitive S in the primitive list in Parameters.

Number of sensor/actuator ports

Using this spinner menu, you can set the number of extra connector ports needed for connecting Joint Actuator and Joint Sensor blocks to this Joint. The default is 0.

The motion of prismatic primitives is specified in linear units. The motion of spherical primitives is specified by a dimensionless quaternion.

Six-DoF Base and Follower Body Connector Ports


Switch between the Axes and Advanced tabs.

Axes Tab

The entries on the Axes tab are required. Each DoF primitive in Six-DoF has an entry line. These lines specify the direction of the axes of action of the DoFs that the Six-DoF represents.

Name - Primitive

The primitive list states the names and types of joint primitives that make up the Six-DoF block: prismatic primitives P1, P2, P3, and spherical primitive S.

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:

  • Prismatic: axis of translation

  • Spherical: field is not active

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 prismatic 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.

Mark as the preferred cut joint

In a closed loop, the simulation internally and automatically cuts one and only one joint.

If you want this particular joint to be weighted preferentially for cutting during the simulation, select the check box. The default is not selected.

See Also

Bushing, Gimbal, Prismatic, 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.

Introduced before R2006a

Was this topic helpful?