JointRRR

Planar revolute - revolute - revolute joint aggregation (no constraints, no potential states)

Diagram

Information

This information is part of the Modelica Standard Library maintained by the Modelica Association.

This component consists of 3 revolute joints with parallel axes of rotation that are connected together by two rods, see the default animation in the following figure (the axes vectors are not part of the default animation):

model Joints.Assemblies.JointRRR

This joint aggregation introduces neither constraints nor state variables and should therefore be used in kinematic loops whenever possible to avoid non-linear systems of equations. It is only meaningful to use this component in planar loops. Basically, the position and orientation of the 3 revolute joints as well as of frame_ia, frame_ib, and frame_im are calculated by solving analytically a non-linear equation, given the position and orientation at frame_a and at frame_b.

Connector frame_a is the "left" side of the first revolute joint whereas frame_ia is the "right side of this revolute joint, fixed in rod 1. Connector frame_b is the "right" side of the third revolute joint whereas frame_ib is the "left" side of this revolute joint, fixed in rod 2. Finally, connector frame_im is the connector at the "right" side of the revolute joint in the middle, fixed in rod 2.

The easiest way to define the parameters of this joint is by moving the MultiBody system in a reference configuration where all frames of all components are parallel to each other (alternatively, at least frame_a, frame_ia, frame_im, frame_ib, frame_b of the JointRRR joint should be parallel to each other when defining an instance of this component).

Basically, the JointRRR model consists internally of a universal - spherical - revolute joint aggregation (= JointUSR). In a planar loop this will behave as if 3 revolute joints with parallel axes are connected by rigid rods.

Parameters (14)

animation

Value: true

Type: Boolean

Description: = true, if animation shall be enabled

n_a

Value: {0, 0, 1}

Type: Axis

Description: Axes of revolute joints resolved in frame_a (all axes are parallel to each other)

n_b

Value:

Type: Real[3]

Description: Axis of revolute joint fixed and resolved in frame_b

rRod1_ia

Value: {1, 0, 0}

Type: Position[3] (m)

Description: Vector from origin of frame_a to revolute joint in the middle, resolved in frame_ia

rRod2_ib

Value: {-1, 0, 0}

Type: Position[3] (m)

Description: Vector from origin of frame_ib to revolute joint in the middle, resolved in frame_ib

phi_offset

Value: 0

Type: Angle_deg (°)

Description: Relative angle offset of revolute joint at frame_b (angle = phi(t) + from_deg(phi_offset))

phi_guess

Value: 0

Type: Angle_deg (°)

Description: Select the configuration such that at initial time |phi(t0) - from_deg(phi_guess)| is minimal

cylinderLength

Value: world.defaultJointLength

Type: Distance (m)

Description: Length of cylinders representing the revolute joints

cylinderDiameter

Value: world.defaultJointWidth

Type: Distance (m)

Description: Diameter of cylinders representing the revolute joints

rodDiameter

Value: 1.1 * cylinderDiameter

Type: Diameter (m)

Description: Diameter of the two rods connecting the revolute joints

checkTotalPower

Value: false

Type: Boolean

Description: = true, if total power flowing into this component shall be determined (must be zero)

e_a

Value: Modelica.Math.Vectors.normalizeWithAssert(n_a)

Type: Real[3]

Description: Unit vector along axes of rotations, resolved in frame_a

e_ia

Value: jointUSR.e2_ia

Type: Real[3]

Description: Unit vector along axes of rotations, resolved in frame_ia

e_b

Value: jointUSR.revolute.e

Type: Real[3]

Description: Unit vector along axes of rotations, resolved in frame_b, frame_ib and frame_im

Inputs (3)

cylinderColor

Default Value: Modelica.Mechanics.MultiBody.Types.Defaults.JointColor

Type: Color

Description: Color of cylinders representing the revolute joints

rodColor

Default Value: Modelica.Mechanics.MultiBody.Types.Defaults.RodColor

Type: Color

Description: Color of the two rods connecting the revolute joint

specularCoefficient

Default Value: world.defaultSpecularCoefficient

Type: SpecularCoefficient

Description: Reflection of ambient light (= 0: light is completely absorbed)

Connectors (7)

frame_a

Type: Frame_a

Description: Coordinate system fixed to the component with one cut-force and cut-torque

frame_b

Type: Frame_b

Description: Coordinate system fixed to the component with one cut-force and cut-torque

frame_ia

Type: Frame_a

Description: Coordinate system at origin of frame_a fixed at connecting rod of left and middle revolute joint

frame_ib

Type: Frame_b

Description: Coordinate system at origin of frame_b fixed at connecting rod of middle and right revolute joint

frame_im

Type: Frame_b

Description: Coordinate system at origin of revolute joint in the middle fixed at connecting rod of middle and right revolute joint

axis

Type: Flange_a

Description: 1-dim. rotational flange that drives the right revolute joint at frame_b

bearing

Type: Flange_b

Description: 1-dim. rotational flange of the drive bearing of the right revolute joint at frame_b

Components (7)

world

Type: World

jointUSR

Type: JointUSR

shape_rev1

Type: Shape

shape_rev2

Type: Shape

shape_rev3

Type: Shape

shape_rod1

Type: Shape

shape_rod2

Type: Shape

Used in Examples (1)

PlanarLoops_analytic

Modelica.Mechanics.MultiBody.Examples.Loops

Mechanism with three planar kinematic loops and one degree-of-freedom with analytic loop handling (with JointRRR joints)