LineForceWithMass
General line force component with an optional point mass on the connection line
Library
Modelica/Mechanics/MultiBody/Forces
Description
This component is used to exert a line force between the origin of frame_a and the origin of frame_b by attaching components of the 1-dimensional translational mechanical library of Modelica (Modelica.Mechanics.Translational) between the two flange connectors flange_a and flange_b. Optionally, there is a point mass on the line connecting the origin of frame_a and the origin of frame_b. This point mass approximates the mass of the force element. The distance of the point mass from frame_a as a fraction of the distance between frame_a and frame_b is defined via parameter lengthFraction (default is 0.5, i.e., the point mass is in the middle of the line).
In the translational library there is the implicit assumption that forces of components that have only one flange connector act with opposite sign on the bearings of the component. This assumption is also used in the LineForceWithMass component: If a connection is present to only one of the flange connectors, then the force in this flange connector acts implicitly with opposite sign also in the other flange connector.
Parameters
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo_animateLine | animateLine | = true, if a line shape between frame_a and frame_b shall be visualized | Scalar | true |
mo_animateMass | animateMass | = true, if point mass shall be visualized as sphere provided m > 0 | Scalar | true |
mo_m | m | Mass of point mass on the connection line between the origin of frame_a and the origin of frame_b | Scalar | |
mo_lengthFraction | lengthFraction | Location of point mass with respect to frame_a as a fraction of the distance from frame_a to frame_b | Scalar |
| 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_lineShapeType | lineShapeType | Type of shape visualizing the line from frame_a to frame_b | String | |
mo_lineShapeWidth | lineShapeWidth | Width of shape | Scalar | |
mo_lineShapeHeight | lineShapeHeight | Height of shape | Scalar | |
mo_lineShapeExtra | lineShapeExtra | Extra parameter for shape | Scalar | |
mo_lineShapeColor | lineShapeColor | Color of line shape | Vector of size 3 | |
mo_massDiameter | massDiameter | Diameter of point mass sphere | Scalar | |
mo_massColor | massColor | Color of point mass | Vector of size 3 |
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo_length | length | length | Structure | |
mo_length/fixed | fixed | Cell of scalars | true | |
mo_length/start | start | Cell of scalars | ||
mo_s | s | s | Structure | |
mo_s/fixed | fixed | Cell of scalars | true | |
mo_s/start | start | Cell of scalars | ||
mo_r_rel_0 | r_rel_0 | r_rel_0 | Structure | |
mo_r_rel_0/fixed | fixed | Cell of vectors of size 3 | true | |
mo_r_rel_0/start | start | Cell of vectors of size 3 | ||
mo_e_rel_0 | e_rel_0 | e_rel_0 | Structure | |
mo_e_rel_0/fixed | fixed | Cell of vectors of size 3 | true | |
mo_e_rel_0/start | start | Cell of vectors of size 3 |
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 |