Rotor1D
1D inertia attachable on 3-dim. bodies (3D dynamic effects are taken into account if world.driveTrainMechanics3D=true)
Library
Modelica/Mechanics/MultiBody/Parts
Description
This component is used to model the gyroscopic torques exerted by a 1-dim.inertia (so called rotor) on its 3-dim. carrier body. Gyroscopic torquesappear, if the vector of the carrier body's angular velocity is not parallelto the vector of the rotor's axis. The axis of rotation of the rotor is defined bythe parameter n, which has to be given in the local coordinate systemof frame_a. The default animation of this component isshown in the figure below.
This component is a replacement forModelica.Mechanics.Rotational.Components.Inertiafor the case, that a 1-dim.-rotational mechanical system should be attached with a 3-dim.carrier body.
The Boolean parameter exact was introduced due to performancereasons. If exact is set to false, the influence of the carrier bodymotion on the angular velocity of the rotor is neglected. This influence is usuallynegligible if the 1-dim.-rotational mechanical system accelerates much faster as the base body (this is,e.g., the case in vehicle powertrains). The essential advantage isthat an algebraic loop is removed since then there is only anaction on acceleration level from the powertrain to the base bodybut not vice versa.
Reference
Schweiger, Christian ;Otter, Martin:Modelling3D Mechanical Effects of 1-dim. Powertrains. In: Proceedings of the 3rd InternationalModelica Conference. Linköping : The Modelica Association and Linköping University,November 3-4, 2003, pp. 149-158
Parameters
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo_animation | animation | = true, if animation shall be enabled (show rotor as cylinder) | Scalar | true |
mo_J | J | Moment of inertia of rotor around its axis of rotation | Scalar | |
mo_n | n | Axis of rotation resolved in frame_a | Vector of size 3 | |
mo_e | e | Unit vector in direction of rotor axis, resolved in frame_a | Vector of size 3 | |
mo_phi | phi | phi | Structure | |
mo_phi/fixed | fixed | Cell of scalars | true | |
mo_phi/start | start | Cell of scalars | ||
mo_w | w | w | Structure | |
mo_w/fixed | fixed | Cell of scalars | true | |
mo_w/start | start | Cell of scalars | ||
mo_a | a | a | Structure | |
mo_a/fixed | fixed | Cell of scalars | true | |
mo_a/start | start | Cell of scalars |
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo_r_center | r_center | Position vector from origin of frame_a to center of cylinder | Vector of size 3 | |
mo_cylinderLength | cylinderLength | Length of cylinder representing the rotor | Scalar | |
mo_cylinderDiameter | cylinderDiameter | Diameter of cylinder representing the rotor | Scalar | |
mo_cylinderColor | cylinderColor | Color of cylinder representing the rotor | Vector of size 3 | |
mo_specularCoefficient | specularCoefficient | Reflection of ambient light (= 0: light is completely absorbed) | Scalar |
| Name | Label | Description | Data Type | Valid Values |
|---|---|---|---|---|
mo_stateSelect | stateSelect | Priority to use rotor angle (phi) and rotor speed (w) as states | Structure | |
mo_stateSelect/choice1 | StateSelect.never | Number | 0 | |
mo_stateSelect/choice2 | StateSelect.avoid | Number | 0 | |
mo_stateSelect/choice3 | StateSelect.default | Number | 0 | |
mo_stateSelect/choice4 | StateSelect.prefer | Number | 0 | |
mo_stateSelect/choice5 | StateSelect.always | Number | 0 | |
mo_exact | exact | = true, if exact calculations; false if influence of bearing on rotor acceleration is neglected to avoid an algebraic loop | Scalar | true |
| 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 | ||
mo__modifiers/attribute | Attribute | Cell of strings | 'start' | |
mo__modifiers/value | Value |
Ports
| Name | Type | Description | IO Type | Number |
|---|---|---|---|---|
flange_a | implicit | (left) driving flange (flange axis directed INTO cut plane) | input | 1 |
flange_b | implicit | (right) driven flange (flange axis directed OUT OF cut plane) | output | 1 |
frame_a | implicit | Frame in which rotor housing is fixed (connector is removed, if world.driveTrainMechanics3D=false) | input | 2 |