Linkage
Rigid cuboid with link visualization
Description
Connections
Parameters
Equations
Examples
The Linkage component models a homogeneous rigid body along a given axial vector with a rectangular cross-section. Based on the properties, i.e., axial unit vector, length, height, width, and density, the center of mass, total mass, and moments of inertia are calculated for this rigid body. Linkage visualization is a cuboid with rounded ends and holes. This visualization is preferred for mechanism.
Name
Modelica ID
frame__a
Frame on one end of the linkage axis
frame_a
frame__b
Frame on the other end of the linkage axis
frame_b
frame__c n
An array of additional frames on the linkage axis
frame_c[n]
Default
Units
e__axis
1,0,0
Axial unit vector
e_axis
Rotate 90 degrees
false
True means the cross-section is rotated 90 degrees
rotate90
L
1
m
Linkage length
W
0.1
Linkage width
H
0.2
Linkage height
Select density
Steel 7860 (kg/m^3)
Select a predefined material density
selectDensity
ρ
1000
kgm3
Linkage user-defined material density
customDensity
Use additional frames
True means additional frames can be added
addFrames
L__add
L2
Each value defines the offset of an additional frame w.r.t. frame_a along the axial vector
L_add[:]
Use initial conditions
True means parameters for specifying initial conditions for frame_a are enabled. Refer to: Rigid Body
useICs
Show visualization
true
True means the disk geometry is visible in the 3-D playback
visualization
Transparent
True means the geometry is transparent in the 3-D playback
transparent
Color
Disk color in the 3-D playback
color
Use rounded A side
When checked (true), linkage end a is shown as rounded with a hole
useRoundedA
Use rounded B side
useRoundedB
D__h
2 H3
Hole diameter (0<Dh<2*H/3)
Dh
Linkage length (L) is always along the specified axial unit vector (e_axis). Unit vectors for width (W) and height (H) are defined according to Figure 1. The sequence depends on whether or not the Rotate 90 degrees option is checked (true). The two end holes are always along the width axis.
Figure 1: Order of L, W, and H follows above diagrams. Rotate 90 degrees option is unchecked (false) for the left sequence and checked (true) for the right one.
Note that the rotate 90 degrees option just rotates the linkage cross section. Regardless of this option, the orientation of the end frames and additional frames remains the same. Translation vectors of L e__axis and L2 e__axis w.r.t. frame_a defines the frame_b and the center of mass frame respectively. Moreover, each additional frame is defined by translating from frame_a along the vector L__add i e__axis . This is illustrated in the following figure.
Figure 2: Orientation of end frames and an additional frame with L__add =L2 for a linkage along the x-axis
Linkage mass is calculated as
m=ρ L H W
where the linkage material density, ρ, is defined using the "Select density" parameter. This parameter lets the user either enter a value or select among predefined material densities.
Figure 3: Different options for the "Select density" parameter
Assuming the default direction of 1,0,0 for the e_axis and that the Rotate 90 degrees option is unchecked (false), the moments of inertia expressed in the center of mass frame (frame_a) are
I__xx=112 m⋅H 2+W 2
I__yy=112 m⋅W 2+L 2
I__zz=112 m⋅H 2+L 2
The right-hand side of these equations will interchange if another axial unit vector is specified or the Rotate 90 degrees parameter is true.
Four-Bar Linkage
Figure 4 shows the layout of a MapleSim model that uses three Linkage components with revolute joints to simulate a four-bar linkage. Note how employing Linkage components facilitates modeling and provides a realistic 3-D playback, shown in Figure 5. Use of this component also decreases the burden on the user by automatically calculating the mass and moments of inertia.
Figure 4: Model layout
Figure 5: 3-D playback snapshot
Slider-Crank Mechanism
In this example, a Linkage, a Disk, and two Cylinder components are connected with revolute and prismatic joints, as shown in Figure 6, to model a slider-crank mechanism. This model is similar to the one discussed in the Cylinder and Disk help pages with the difference of using a Linkage component to connect the crank to the slider.
Using Machine Element components facilitates modeling complex multibody systems by taking care of mass and moment of inertia calculations and also decreases the total number of components. A snapshot of the 3-D playback window is shown in Figure 7.
Figure 6: Model layout
Figure 7: 3-D playback snapshot
See Also
Machine Elements
Multibody
Download Help Document