Modelica.Mechanics.Rotational.Examples

Demonstration examples of the components of this package

Information

This package contains example models to demonstrate the usage of the Modelica.Mechanics.Rotational package. Open the models and simulate them according to the provided description in the models.

Extends from Modelica.Icons.ExamplesPackage (Icon for packages containing runnable examples).

Package Content

Name Description
Modelica.Mechanics.Rotational.Examples.First First First example: simple drive train
Modelica.Mechanics.Rotational.Examples.FirstGrounded FirstGrounded First example: simple drive train with grounded elements
Modelica.Mechanics.Rotational.Examples.Friction Friction Drive train with clutch and brake
Modelica.Mechanics.Rotational.Examples.CoupledClutches CoupledClutches Drive train with 3 dynamically coupled clutches
Modelica.Mechanics.Rotational.Examples.LossyGearDemo1 LossyGearDemo1 Example to show that gear efficiency may lead to stuck motion
Modelica.Mechanics.Rotational.Examples.LossyGearDemo2 LossyGearDemo2 Example to show combination of LossyGear and BearingFriction
Modelica.Mechanics.Rotational.Examples.LossyGearDemo3 LossyGearDemo3 Example that failed in the previous version of the LossyGear version
Modelica.Mechanics.Rotational.Examples.ElasticBearing ElasticBearing Example to show possible usage of support flange
Modelica.Mechanics.Rotational.Examples.Backlash Backlash Example to demonstrate backlash
Modelica.Mechanics.Rotational.Examples.RollingWheel RollingWheel Demonstrate coupling Rotational - Translational
Modelica.Mechanics.Rotational.Examples.HeatLosses HeatLosses Demonstrate the modeling of heat losses
Modelica.Mechanics.Rotational.Examples.SimpleGearShift SimpleGearShift Simple Gearshift
Modelica.Mechanics.Rotational.Examples.EddyCurrentBrake EddyCurrentBrake Demonstrate the usage of the rotational eddy current brake
Modelica.Mechanics.Rotational.Examples.GenerationOfFMUs GenerationOfFMUs Example to demonstrate variants to generate FMUs (Functional Mock-up Units)
Modelica.Mechanics.Rotational.Examples.OneWayClutch OneWayClutch Drive train with actively engaged one-way clutch
Modelica.Mechanics.Rotational.Examples.OneWayClutchDisengaged OneWayClutchDisengaged Drive train with disengaged one-way clutch
Modelica.Mechanics.Rotational.Examples.Utilities Utilities Utility classes used by rotational example models

Modelica.Mechanics.Rotational.Examples.First Modelica.Mechanics.Rotational.Examples.First

First example: simple drive train

Information

The drive train consists of a motor inertia which is driven by a sine-wave motor torque. Via a gearbox the rotational energy is transmitted to a load inertia. Elasticity in the gearbox is modeled by a spring element. A linear damper is used to model the damping in the gearbox bearing.

Note, that a force component (like the damper of this example) which is acting between a shaft and the housing has to be fixed in the housing on one side via component Fixed.

Simulate for 1 second and plot the following variables:
angular velocities of inertias inertia2 and 3: inertia2.w, inertia3.w

Extends from Modelica.Icons.Example (Icon for runnable examples).

Parameters

NameDescription
amplitudeAmplitude of driving torque [N.m]
fFrequency of driving torque [Hz]
JmotorMotor inertia [kg.m2]
JloadLoad inertia [kg.m2]
ratioGear ratio
dampingDamping in bearing of gear

Modelica.Mechanics.Rotational.Examples.FirstGrounded Modelica.Mechanics.Rotational.Examples.FirstGrounded

First example: simple drive train with grounded elements

Information

The drive train consists of a motor inertia which is driven by a sine-wave motor torque. Via a gearbox the rotational energy is transmitted to a load inertia. Elasticity in the gearbox is modeled by a spring element. A linear damper is used to model the damping in the gearbox bearing.

Note, that a force component (like the damper of this example) which is acting between a shaft and the housing has to be fixed in the housing on one side via component Fixed.

Simulate for 1 second and plot the following variables:
angular velocities of inertias inertia2 and 3: inertia2.w, inertia3.w

Extends from Modelica.Icons.Example (Icon for runnable examples).

Parameters

NameDescription
amplitudeAmplitude of driving torque [N.m]
fFrequency of driving torque [Hz]
JmotorMotor inertia [kg.m2]
JloadLoad inertia [kg.m2]
ratioGear ratio
dampingDamping in bearing of gear

Modelica.Mechanics.Rotational.Examples.Friction Modelica.Mechanics.Rotational.Examples.Friction

Drive train with clutch and brake

Information

This drive train contains a frictional clutch and a brake. Simulate the system for 1 second using the following initial values (defined already in the model):

inertia1.w =  90 (or brake.w)
inertia2.w =  90
inertia3.w = 100

Plot the output signals

tMotor      Torque of motor
tClutch     Torque in clutch
tBrake      Torque in brake
tSpring     Torque in spring

as well as the absolute angular velocities of the three inertia components (inertia1.w, inertia2.w, inertia3.w).

Extends from Modelica.Icons.Example (Icon for runnable examples).

Parameters

NameDescription
startTimeStart time of step [s]

Modelica.Mechanics.Rotational.Examples.CoupledClutches Modelica.Mechanics.Rotational.Examples.CoupledClutches

Drive train with 3 dynamically coupled clutches

Information

This example demonstrates how variable structure drive trains are handled. The drive train consists of 4 inertias and 3 clutches, where the clutches are controlled by input signals. The system has 2^3=8 different configurations and 3^3 = 27 different states (every clutch may be in forward sliding, backward sliding or locked mode when the relative angular velocity is zero). By invoking the clutches at different time instances, the switching of the configurations can be studied.

Simulate the system for 1.2 seconds with the following initial values:
J1.w = 10.

Plot the following variables:
angular velocities of inertias (J1.w, J2.w, J3.w, J4.w), frictional torques of clutches (clutchX.tau), frictional mode of clutches (clutchX.mode) where mode = -1/0/+1 means backward sliding, locked, forward sliding.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Parameters

NameDescription
fFrequency of sine function to invoke clutch1 [Hz]
T2Time when clutch2 is invoked [s]
T3Time when clutch3 is invoked [s]

Modelica.Mechanics.Rotational.Examples.LossyGearDemo1 Modelica.Mechanics.Rotational.Examples.LossyGearDemo1

Example to show that gear efficiency may lead to stuck motion

Information

This model contains two inertias which are connected by an ideal gear where the friction between the teeth of the gear is modeled in a physical meaningful way (friction may lead to stuck mode which locks the motion of the gear). The friction is defined by an efficiency factor (= 0.5) for forward and backward driving condition leading to a torque dependent friction loss. Simulate for about 0.5 seconds. The friction in the gear will take all modes (forward and backward rolling, as well as stuck).

You may plot:

Inertia1.w,
Inertia2.w : angular velocities of inertias
powerLoss  : power lost in the gear
gear.mode  :  1 = forward rolling
              0 = stuck (w=0)
             -1 = backward rolling

Note, powerLoss (= sum of the power flows of the connectors) and gear.powerLoss (= gear.tau_loss*gear.w_a, where gear.tau_loss is determined in a non-trivial way from the stuck/sliding situation of the bearing and teeth friction; = equation (16) in [Pelchen2002]) should be identical, or the difference should be close to zero, if model LossyGear is correctly implemented.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.LossyGearDemo2 Modelica.Mechanics.Rotational.Examples.LossyGearDemo2

Example to show combination of LossyGear and BearingFriction

Information

This model contains bearing friction and gear friction (= efficiency). If both friction models are stuck, there is no unique solution. Still a reliable Modelica simulator should be able to handle this situation.

Simulate for about 0.5 seconds. The friction elements are in all modes (forward and backward rolling, as well as stuck).

You may plot:

Inertia1.w,
Inertia2.w          : angular velocities of inertias
powerLoss           : power lost in the gear
bearingFriction.mode:  1 = forward rolling
                       0 = stuck (w=0)
                      -1 = backward rolling
gear.mode           :  1 = forward rolling
                       0 = stuck (w=0)
                      -1 = backward rolling

Note, powerLoss (= sum of the power flows of the connectors) and gear.powerLoss (= gear.tau_loss*gear.w_a, where gear.tau_loss is determined in a non-trivial way from the stuck/sliding situation of the bearing and teeth friction; = equation (16) in [Pelchen2002]) should be identical, or the difference should be close to zero, if model LossyGear is correctly implemented.

Note: This combination of LossyGear and BearingFriction is not recommended to use, as component LossyGear includes the functionality of component BearingFriction (only peak not supported).

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.LossyGearDemo3 Modelica.Mechanics.Rotational.Examples.LossyGearDemo3

Example that failed in the previous version of the LossyGear version

Information

This example demonstrates a situation where the driving side of the LossyGear model is not obvious. The version of LossyGear up to version 3.1 of package Modelica failed in this case (no convergence of the event iteration).

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.ElasticBearing Modelica.Mechanics.Rotational.Examples.ElasticBearing

Example to show possible usage of support flange

Information

This model demonstrates the usage of the bearing flange. The gearbox is not connected rigidly to the ground, but by a spring-damper-system. This allows examination of the gearbox housing dynamics.

Simulate for about 10 seconds and plot the angular velocities of the inertias housing.w, shaft.w and load.w.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.Backlash Modelica.Mechanics.Rotational.Examples.Backlash

Example to demonstrate backlash

Information

This model demonstrates the effect of a backlash on eigenfrequency, and also that the damping torque does not lead to unphysical pulling torques (since the ElastoBacklash model takes care of it). Furthermore, it shows the differences of the ElastoBacklash and ElastoBacklash2 components (the ElastoBacklash2 component generates events when contact occurs and the torque changes discontinuously).

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.RollingWheel Modelica.Mechanics.Rotational.Examples.RollingWheel

Demonstrate coupling Rotational - Translational

Information

This model demonstrates the coupling between rotational and translational components:
A torque (step) accelerates both the inertia (of the wheel) and the mass (of the vehicle).
Du to a speed dependent force (like driving resistance), we find an equilibrium at 5 m/s after approx. 5 s.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.HeatLosses Modelica.Mechanics.Rotational.Examples.HeatLosses

Demonstrate the modeling of heat losses

Information

This model demonstrates how to model the dissipated power of a drive train, by enabling the heatPort of all components and connecting these heatPorts via a convection element to the environment. The total heat flow generated by the elements of the drive train and transported to the environment is present in variable convection.fluid.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.SimpleGearShift Modelica.Mechanics.Rotational.Examples.SimpleGearShift

Simple Gearshift

Information

This model shows how an automatic gear shift is built up from a planetary gear, a brake and a clutch.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.EddyCurrentBrake Modelica.Mechanics.Rotational.Examples.EddyCurrentBrake

Demonstrate the usage of the rotational eddy current brake

Information

An eddy current brake reduces the speed of a rotating inertia. Kinetic energy is converted to thermal energy which leads to a temperature increase of the thermal capacitance of the brake, which can be assumed as adiabatic during the rather short time span of the braking.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.GenerationOfFMUs Modelica.Mechanics.Rotational.Examples.GenerationOfFMUs

Example to demonstrate variants to generate FMUs (Functional Mock-up Units)

Information

This example demonstrates how to generate an input/output block (e.g. in form of an FMU - Functional Mock-up Unit) from various Rotational components. The goal is to export such an input/output block from Modelica and import it in another modeling environment. The essential issue is that before exporting it must be known in which way the component is utilized in the target environment. Depending on the target usage, different flange variables need to be in the interface with either input or output causality. Note, this example model can be used to test the FMU export/import of a Modelica tool. Just export the components marked in the icons as "toFMU" as FMUs and import them back. The models should then still work and give the same results as a pure Modelica model.

Connecting two inertias
The upper part (DirectInertia, InverseInertia) demonstrates how to export two inertias and connect them together in a target system. This requires that one of the inertias (here: DirectInertia) is defined to have states and the angle, angular velocity and angular acceleration are provided in the interface. The other mass (here: InverseInertia) is moved according to the provided input angle, angular velocity and angular acceleration.

Connecting a force element that needs angles and angular velocities
The middle part (SpringDamper) demonstrates how to export a force element that needs both angles and angular velocities for its force law and connect this force law in a target system between two inertias.

Connecting a force element that needs only angles
The lower part (Spring) demonstrates how to export a force element that needs only angles for its force law and connect this force law in a target system between two inertias.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.OneWayClutch Modelica.Mechanics.Rotational.Examples.OneWayClutch

Drive train with actively engaged one-way clutch

Information

The drive train consists of a one-way clutch and driving and driven inertias. The one-way clutch is engaged periodically thus forcing both the inertias to match their rotational velocity. When disengaged, only the freewheel functionality of the one-way clutch is available and is active as long as the relative angular velocity w_rel becomes zero.

Simulate for 2 seconds and compare inertias' velocities inertiaIn.w and inertiaOut.w to each other. Check also the engagement of the clutch oneWayClutch.f_normalized and its lossy power oneWayClutch.lossPower.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Modelica.Mechanics.Rotational.Examples.OneWayClutchDisengaged Modelica.Mechanics.Rotational.Examples.OneWayClutchDisengaged

Drive train with disengaged one-way clutch

Information

The drive train consists of a one-way clutch and driving and driven inertias. To demonstrate the behavior of the clutch's freewheel only, the clutch stays disengaged for all the time. The sine torque is applied on the driving inertia forcing inertia's speed change. On the driven side there is applied constant load torque only.

Simulate for 2 seconds and compare inertias' velocities inertiaIn.w and inertiaOut.w to each other.

Extends from Modelica.Icons.Example (Icon for runnable examples).

Automatically generated Thu Oct 1 16:07:55 2020.