LineForceWithTwoMasses
General line force component with two optional point masses on the connection line
Library
Modelica/Mechanics/MultiBody/Forces
Description
This component is used to exert a line forcebetween the origin of frame_a and the origin of frame_bby attaching components of the 1-dimensional translationalmechanical library of Modelica (Modelica.Mechanics.Translational)between the two flange connectors flange_a andflange_b. Optionally, there are two point masses on the lineconnecting the origin of frame_a and the origin of frame_b.These point masses approximate the masses of the force element.The locations of the two point masses are defined by their(fixed) distances of L_a relative to frame_a and of L_b relativeto frame_b, respectively.
In exampleMultiBody.Examples.Elementary.LineForceWithTwoMasses the usage of thisline force element is shown and is compared with an alternativeimplementation using aMultiBody.Joints.Assemblies.JointUPS component.The composition diagram of this exampleis displayed in the figure below.
The animation view at time = 0 is shown in the next figure.The system on the left side in the front is the animation withthe LineForceWithTwoMasses component whereas the system on the rightside in the back is the animation with the JointUPS component.Both implementations yield the same result. However, the implementationwith the LineForceWithTwoMasses component is simpler.
In the translational library there is the implicit assumption thatforces of components that have only one flange connector act withopposite sign on the bearings of the component. This assumptionis also used in the LineForceWithTwoMasses component: If a connectionis present to only one of the flange connectors, then the forcein this flange connector acts implicitly with opposite sign alsoin the other flange connector.
Parameters
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo_animate | animate | = true, if animation shall be enabled | Scalar | true |
mo_animateMasses | animateMasses | = true, if point masses shall be visualized provided animate=true and m_a, m_b > 0 | Scalar | true |
mo_m_a | m_a | Mass of point mass a on the connection line between the origin of frame_a and the origin of frame_b | Scalar | |
mo_m_b | m_b | Mass of point mass b on the connection line between the origin of frame_a and the origin of frame_b | Scalar | |
mo_L_a | L_a | Distance between point mass a and frame_a (positive, if in direction of frame_b) | Scalar | |
mo_L_b | L_b | Distance between point mass b and frame_b (positive, if in direction of frame_a) | Scalar | |
mo_animateMasses2 | animateMasses2 | Scalar | true |
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo_s_small | s_small | Prevent zero-division if distance between frame_a and frame_b is zero | Scalar | |
mo_fixedRotationAtFrame_a | fixedRotationAtFrame_a | = true, if rotation frame_a.R is fixed (to directly connect line forces) | Scalar | true |
mo_fixedRotationAtFrame_b | fixedRotationAtFrame_b | = true, if rotation frame_b.R is fixed (to directly connect line forces) | Scalar | true |
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo_specularCoefficient | specularCoefficient | Reflection of ambient light (= 0: light is completely absorbed) | Scalar | |
mo_cylinderDiameter_a | cylinderDiameter_a | Diameter of cylinder at frame_a | Scalar | |
mo_cylinderLength_a | cylinderLength_a | Length of cylinder at frame_a | Scalar | |
mo_color_a | color_a | Color of cylinder at frame_a | Vector of size 3 | |
mo_diameterFraction | diameterFraction | Diameter of cylinder at frame_b with respect to diameter of cylinder at frame_a | Scalar | |
mo_cylinderLength_b | cylinderLength_b | Length of cylinder at frame_b | Scalar | |
mo_color_b | color_b | Color of cylinder at frame_b | Vector of size 3 | |
mo_massDiameterFaction | massDiameterFaction | Diameter of point mass spheres with respect to cylinderDiameter_a | Scalar | |
mo_massColor | massColor | Color of point masses | Vector of size 3 |
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo__nmodifiers | Number of Modifiers | Specifies the number of modifiers | Number | |
mo__modifiers | Modifiers | Add new modifier | Structure | |
mo__modifiers/varname | Variable name | Cell of strings | 'length' | |
mo__modifiers/attribute | Attribute | Cell of strings | 'start' | |
mo__modifiers/value | Value |
Ports
| Name | Type | Description | IO Type | Number |
|---|---|---|---|---|
frame_a | implicit | Coordinate system a fixed to the component with one cut-force and cut-torque | input | 1 |
frame_b | implicit | Coordinate system b fixed to the component with one cut-force and cut-torque | output | 1 |
flange_b | implicit | 1-dim. translational flange (connect force of Translational library between flange_a and flange_b) | input | 2 |
flange_a | implicit | 1-dim. translational flange (connect force of Translational library between flange_a and flange_b) | output | 2 |