New Features

New Independent Suspension Linkages

Two new independent suspension linkages: fourlink and trapezoidal have been introduced. Both suspension linkages have either steerable or non-steerable configurations, as well as kinematic and multiple compliant versions.

A fourlink suspension is effectively a double wishbone suspension with either the lower or upper wishbone split into two separate fore/aft links and a steer link. Each link has a separate attachment point to the upright.

A trapezoidal suspension has a lower wishbone with a link connected to the upright, a single upper link and a steer link.

Kinematics and Compliance (K&C) Experiments Using Wheel Test Rig

In version 2.1, a live tire suspension test rig was added that allows the application of external forces and torques at either the contact patch or wheel center/hub. Experiment templates and examples have been added to allow you to perform virtual K&C experiments using this live wheel rig. K&C experiments are now broken into two groups: HubRig and WheelRig depending on which suspension test rig is used.

Example K&C experiments using the live tire rig can be found in: KCAnalysis.Examples.WheelRig.

Functional Mockup Interface Examples

Examples have been added to demonstrate how models can be both imported and exported as a Functional Mockup Unit (FMU) from VDL using the Functional Mockup Interface (FMI). The FMI allows for cross-platform deployment of models. The exported FMUs can be used with prepared example models in Simulink®, located in the VDL installation directory: VehicleDynamics/Resources/Simulink/FMI.

Using these Simulink® example models require the FMI Toolbox for MATLAB/Simulink®. The new examples can be found in Examples.FMI.

MATLAB® and Simulink® are registered trademarks of The MathWorks, Inc.


Added Static Loadcases Suspension Experiment

The live tire suspension test rig has been modified to allow the wheel pads to be driven with a force input. Previously, it was only possible to drive the wheel pads with a displacement input. A new StaticLoads controller and an example WheelRig.StaticLoads experiment have been added that demonstrate this new functionality.

Dashboard Connector Changes

The dashboardInformation connector has been eliminated from the Vehicle and Driver standard interfaces to facilitate custom interfacing between drivers and vehicles. The signalBus now carries all generic signal information between the driver and the vehicle. The dashboardInformation connector is still available inside the signalBus as signalBus.dashboard. In order to make an external connection to the dashboardInformation connector, an instance of DashboardInformation has to be added and connected to signalBus.dashboard. Ignition and Start commands for the engine are now only sent over the signalBus and not in the dashboard interface.

We suggest to now use the signalBus for sending custom signals between the driver and vehicle. The signalBus is available in the standard driver interface.

Minor Changes

  • All road files that are required in example experiments are now included in the VehicleDynamics/Resources/Data/Roads folder. Users are no longer required to run the 'Build Road' script prior to running an example experiment.

Obsolete Models

Conversion of User Libraries

User libraries will automatically be converted from version 2.2. These conversions are made using the included conversion script: VehicleDynamics/Resources/Scripts/Convert_to_2.3.mos.


Vehicle Dynamics Library 2.3 is based on Modelon Base Library 2.4 and Modelica Standard Library 3.2.2, and has been tested with:

  • Dymola 2016 FD01
  • Dymola 2017

New Features

Cornering Ground Model

A new Cornering ground model has been added. This ground model allows modification of the ground surface position, orientation and curvature based on input signals. This ground model can be used in quasi-steady state simulations to evaluate chassis states at a particular straight-line or cornering condition. The chassis velocity and curvature result in lateral, longitudinal and vertical accelerations being applied to the vehicle. This ground model is particularly useful in motorsports applications to evaluate chassis states at different points on the race track. Examples using the Cornering ground can be found in under Examples.QuasiSteadyState and Examples.QuasiSteadyState.BankedCornering.

Bushing Visualization

The bushing visualizer has been changed to make it easier to see the relative displacement between frame_b (red cylinder) and frame_a (dark grey cylinder). The updated bushing visualizer can be seen in the image below. The visualizer also makes it easier to understand the axes related to the force {fx, fy, fz} and torque {tx,ty,tz} components. This can be seen in the annotated image below.

New Strut Components

New bushing mounted strut components have been introduced. These struts are mounted to the chassis and suspension with bushings. They are found in Suspensions.Linkages.Struts.Mounted. The bushing components are replaceable, and Strut2 has two sets of translational flanges where one can be parameterized to attach either inside or outside the mount bushings. This is useful when springs and dampers are co-located in the suspension but attach on different sides of the mount bushings. Two examples are shown here:

New Pitman-Idler Steering Model

A new pitman-idler steering model has been introduced. This model has been used previously in NASCAR and military applications and is now included as another steering model option.


Changes to Steering Templates

The steering templates have been modified to have additional construction options including a replaceable steering shaft. If you were using either of these templates, you must add a connection between the steeringShaft axle flanges (axle_a and axle_b) as shown in the image below. The following templates were changed:

  • GearSteeringWheel
  • RackSteeringWheel

Ground Function Update

There was a discrepancy in how ground coordinates (sG) were defined in Grounds.Flat depending on whether the enable_sG flag was true or false. For enable_sG=false, the sG[1,2] coordinates would be defined in the x,y plane in world coordinates even when the road was inclined while when enable_sG=true they would be defined in the inclined road plane. See illustration below.

The flat_rG_0 function has now been updated so the surface coordinate (sG) are always defined in the inclined ground plane (green arrow) regardless of if sG functions are used.

User's Guide Moved

All content from the external User's guide has been migrated into online documentation in the library. Basic information is found in the User's guide section while more specific information on subcomponents is found in Information classes in each subpackage, see for example Grounds and Vehicles.Chassis.

New Hub Component

A new Hub component has been added. This component was added to properly handle alignment parameters for wheel carriers. Wheel carriers can either be aligned by toe and camber or a spin axis (n0H). The sign of these parameter is different depending on whether applied to a left or right wheel carrier. Previously, the sign change was often done in the suspension linkage. With the new hub component, the same toe/camber can be entered for both the left and right linkage and the left_linkage parameter in the Hub component will handle the sign changes.

Minor Changes

  • The wheel templates allowing external inputs have been modified to use a new Inputs contact calculation block. If you were using either of the templates listed below, you must redeclare the contact calculation block in your wheel to use the new Inputs contact calculation block. The following templates were changed:

    • ConventionalInputs
    • ConventionalInputs2

  • The sign on the output torque in Engines.Torques.TabularIgnitionControl has been corrected. The torque output is now positive for forward driving torque. If you are using the torque output from Engines.Tabular or Engines.TabularExternalControl or the VDL_eng_trq signal on the signalbus, you will need to take this sign change into account. (#580)
  • Grounds.Flat_new has been merged into Grounds.Flat, if you were using Flat_new, the conversion script will update your models to use Flat instead, all parameters can be used as before. (#697)
  • RigidSwitch2 and RigidSwitch3 have been renamed to Mounts.Switches.Switch2 and Mounts.Switches.Switch3, respectively. The conversion script will automatically update your models to reflect these changes. (#700)
  • The pedal_to_clamp_gain parameter in Brakes.Lumped has been renamed to pedal_to_pressure_gain to better reflect it's purpose. The pressure is converted to clamp force in the brake disc components.
  • The AArm component has been modified such that user-entered mass and inertia properties are resolved in frame_a, as stated in the documentation. Previously, the user-entered mass and inertia properties were incorrect in that they were resolved in frame_b. (#679)
  • The WindSpeedSensor has been modified to allow an external resolve frame. (#707)

Obsolete Models

  • Grounds.Flat_new


Vehicle Dynamics Library 2.2 is based on Modelon Base Library 2.3 and Modelica Standard Library 3.2.1, and has been tested with:

  • Dymola 2016
  • Dymola 2016 FD01

New Features

OpenCRG® Ground Model

The OpenCRG® project provides open file formats and open source tools for the detailed description and evaluation of 3D road surfaces. OpenCRG® data sets are designed to describe very detailed patches of road surfaces making them suitable for a broad range of applications including e.g. tire and driving simulations.

The OpenCRG ground model supports both binary and textual OpenCRG® data files.

More information about OpenCRG® and the OpenCRG® project can be found on its website:

OpenCRG® is a registered trademark of Daimler AG, Germany.

Planar Filtering for Wheel/Contact Calculation

A planar contact calculation filtering method has been added to the Generic contact calculation block. The planar filtering method calculates a center frame and contact frame based on a plane on the ground surface. The plane is defined by four contact points/frames. The contact frames are located on the ground surface in the hub plane, but offset from the hub as defined by the offsetGrid parameter. This method is best suited for grounds with significant variation in height and road normal, as with the Belgian Block road pictured above.

There are now three choices for the filtering parameter of the Generic contact calculation block: None, Geometry weighted, and Planar. This new filtering method is selected by choosing "Planar".

Tabular Steering Systems

Two new steering systems were added: GearTabular and RackTabular. These two steering systems allow you to define gear/rack displacements relative to steering wheel angle using tabular data. Two components, TabularLever and TabularRack were added to allow creation of these models using existing steering templates.


  • A wheel_number parameter was added to all wheel components. The wheel_number is often required in external tire force models. This parameter was previously used in the contact calculation and sensor components. For consistency, this parameter was added to the tire forces, hub and visualization interfaces. The wheel_number is now propagated to all these components in the base wheel template. (#672)
  • Some suspension linkage templates were missing switchable mounts to allow you to attach the ride spring and damper to either the lower control arm, upper control arm, or upright. The follow templates were changed: (#649)

    • DoubleWishboneSTT2
    • DoubleWishboneSTT3
    • DoubleWishboneTT2
    • DoubleWishboneTT3

Obsolete Models

  • Removed old steering templates (ConventionalRackSteeringWheel and RackPinion) that were no longer used. (#650)


Vehicle Dynamics Library 2.1 is based on Modelon Base Library 2.2 and Modelica Standard Library 3.2.1, and has been tested with:

  • Dymola 2015 FD01
  • Dymola 2016

Version 2.0 contains additional suspension and chassis test rigs, new ground sensors and new aerodynamics models. These additions, as well as some changes, are described below.

New Features

Pacejka '94 Tire Contact Force Model

Support for the Pacejka '94 'Magic Formula' contact force model has been added. The Pacejka '94 contact force model provides the benefit that it requires fewer coefficients than newer models; is more commonly used than the Pacejka '02 model; and is used in many other vehicle dynamics software products. By supporting this contact force model natively in VDL, the Pacejka '94 tire coefficients can be shared between VDL and other simulation tools. The equations for this contact force model are described in the paper: 

Pacejka, H.B., and Bakker, E. (1993): The Magic Formula tyre model
Proceedings of 1st Colloquium on Tyre Models for Vehicle Analysis, Delft 1991, ed. H.B. Pacejka, Suppl. Vehicle System Dynamics, 21, 1993.

Suspension Wheel Test Rig

A new live tire suspension test rig has been added that allows the application of external forces and torques at either the contact patch or wheel center/hub. In physical kinematics and compliance tests, it is quite common to have a wheel and tire mounted on the suspension. It is the intent of this new rig to be able to better mimic the actual physical tests. Example suspension experiments using this new rig can be found in: Examples.WheelRig.

Chassis Kinematics & Compliance Experiments

Two new chassis-level kinematics and compliance experiments have been added: FourPostNoWheels & KinematicsCompliance. These rigs not only allow vertical excitation of the chassis, they also allow the application of external forces and torques at either the contact patch or wheel center/hub. 

Ground Proximity Sensors

Ground proximity information is commonly required in vehicle dynamics simulations. Most commonly, this information is used in the contact calculations for wheels. Other applications include ride heights for aerodynamics calculations and ground impacts. Three new sensors have been added to report the proximity of a frame to ground:

  • ClosestPoint - outputs the closest point located on the ground surface to the sensor
  • ClosestPointInPlane - outputs a point located on the ground surface at the point of intersection of a plane and ground
  • IntersectionAlongLine - outputs a point located on the ground surface at the point of intersection of a line and ground

Existing ground sensors that were previously located in Chassis.Sensors have been moved to Ground.Sensors. This includes the following sensors:

  • FrameInPlaneThreePoints
  • FrameOnGround
  • GroundCurvature
  • GroundHeight
  • VelocityOfGround

Ride Height Dependent Aerodynamics Models

Four new aerodynamics models have been added that are dependent on front/rear ride heights. The different models demonstrate how to represent lift/drag/side aerodynamic forces using either a polymonial or tabular data: 

  • PitchPolynomialLD
  • PitchPolynomialLDS
  • PitchTabularLD
  • PitchTabularLDS


An overview of some of the changes that have been made and issues that have been fixed in this version are included in the following lists. 

Uncritical issues (i.e., issues that do not affect simulation results): 

  • RevoluteSB has been recreated to be consistent with RevoluteBB. The old RevoluteSB has been renamed to RevoluteSB_. This old version is deprecated and will be removed in the next release. A new RevoluteBS option was also added. (#640)
  • Renamed Suspensions.Linkages.Mechanisms.RASURLU.steeringLink to steerLink to be more consistent with other suspension linkages. (#641)
  • In Wheels.Interfaces.Base, the wheel_number parameter was changed so that it is no longer conditionally enabled based on the enable_signal_bus parameter. This parameter is now always enabled for modification. (#643)

Conversion of user libraries

A conversion script is required to convert some models from version 1.9 to version 2.0.

This library has been tested with:

  • Dymola 2015 FD01

Version 1.9 is a major maintenance release with many changes to the Wheels interface and templates. A conversion script is required to accommodate the changes described below. This will convert models from version 1.8 to the current version.

Support for TYDEX Standard Tyre Interface Tire Models

The Standard Tyre Interface (STI) was defined by the TYDEX working group, see VehicleDynamics.Vehicles.Chassis.Wheels.Information.Literature for more details.

The existing, built-in tire models in VDL have separate blocks for calculating forces and contact calculations (tire/ground interaction). For STI-compatible tire models, the forces and contact calculations are combined. Further, the VDL tire models calculate the tire forces at the contact patch, and the hub model is responsible for transforming those forces for application at the hub. STI-compatible tire models calculate the tire forces at the hub.

New Wheel Interfaces and Templates

The fundamental differences between the VDL tire models and STI-compatible tire models mean that the existing templates for wheels, forces, hubs, and contact calculations in the VDL could not be used. VDL has now been extended to support STI-compatible tire models that calculate the forces at the hub by adding new wheel, forces, and hub interfaces and templates. A partial list includes:

  • Wheels.Templates.BaseHF
  • Wheels.Templates.ConventionalHF
  • Wheels.Hubs.MultiBodyHF
  • Wheels.ContactCalculation.Templates.BaseHF
  • Wheels.TireForces.Interfaces.BaseHF

Wheel.ContactForces Renamed To Wheel.TireForces

As described above, STI-compatible tire models could be considered hub force tire models. As hub force tire models are now supported, Wheels.ContactForces was renamed to Wheels.TireForces.

Support for the Delft-Tyre family of tire models

VDL was been extended to include support of the TNO Delft-Tyre product line which includes MF-Tyre® and MF-Swift® tire force models. The Delft-Tyre wheel model fully supports VDL built-in ground models, TNO road property files, and OpenCRG road descriptions.


MF-Tyre is the Delft-Tyre standard implementation of the renowned Pacejka Magic Formula that includes the latest developments. With MF-Tyre the engineer can simulate validated steady-state and transient behavior up to 8Hz, making it the ideal tire model for handling and control prototyping analyses. Pure cornering and braking as well as combined conditions are accurately described. The robust extrapolation properties of MF-Tyre make the model suitable for the simulation of conditions that go beyond the measurement conditions.


MF-Swift is the high frequency (100Hz) extension to MF-Tyre. MF-Swift adds generic 3D obstacle enveloping and tire belt dynamics to MF-Tyre's tire-road contact force and moment simulation. Typical application areas for MF-Swift are vehicle comfort analysis, suspension vibration analysis, development of vehicle control systems, such as ABS or ESC, and handling and stability analysis like braking and power-off in a turn on an uneven road.

Please see the Delft-Tyre Forces block for more information, requirements, and limitations.

Changes from Version 1.8

An overview of some of the changes that have been made and issues that have been fixed in this version are included in the following lists.

Uncritical issues (i.e., issues that do not affect simulation results):

  • The Modelon-specific StateSelection type in the Modelon Library has been removed. All VDL components that referenced that type now use the Modelica predefined StateSelect enumeration.
  • There were changes in the Modelon Library Visualizers where references to the Modelon-specific type Finish have been changed to Modelica standard type Color. This effects some VDL components.

Available for: Dymola 2015
Modelica Standard Library Version: 3.2.1

Version 1.8 is a major maintenance release with many changes and assured compatibility with the updated Modelica Language Specification (Version 3.2.1). A conversion script is required to accommodate the changes described below. This will convert models from version 1.6, 1.7 and 1.7.1 to the current version.

Additional Tuners, Tunables and Setup Experiment

Tuners and tunables can be used to adjust many different properties of the vehicle, such as camber, toe, and ride heights. For example, the length of the tierods in a suspension are often adjusted until a desired static toe is achieved.

Chassis tuning or setup is applicable in both OEMs and Motorsports. Tuning tasks can range from simply automating ride height adjustments to fully replicating a physical setup procedure used in Motorsports, such as adjustments for toe/camber, ride heights, trackbar height, driver in/out, fuel, and ballast position. Please see the new Setup experiment for more information and a detailed example.

Examples using the Modelon.DataAccess package

The Modelon.DataAccess is an architecture for data management allowing users to populate models with data from sources outside the Modelica environment. In this release, an example has been added to demonstrate how a vehicle model can be completely parameterized to data from external files using the DataAccess functionality. Please see the new DataAccess example in the top-level Examples package.

Elimination of Booleans in Wheel Visualization

In the continued efforts to improve real-time performance, the boolean visualization modes in wheels have been modified to be Reals:

Sliding visualization warning: The tire is considered to be sliding if the slidingState > slidingThreshold. If the tire is sliding, it will be displayed in red ({255,0,0}).

Contact visualization warning: The tire is considered to be in contact with the road if the contactState >= contactThreshold. If the tire is not in contact, i.e. has lifted off the road, it will be displayed in yellow ({255,255,0}).

Valid visualization warning: The tire is considered to be valid if the validState >= validThreshold. If the tire is invalid, it will be displayed in blue ({0,0,255}).

Changes to Powertrain.Engine Models

The Tabular engine and it's torque block (TabularIgnitionControl) were restructured to make is easier to add custom engine torque models. The TabularIgnitionControl was changed to focus purely on a rotational 1D representation of the engine's torque characteristics. As such, the multi-body frame mount has been removed and the inertia and visualizers have been moved out of this component and into the engine component. Also, the torque block has been modified in the engine so that it is replaceable.

Changes to ShakerN and PivotingPlanes Ground Models

The parameters and input connectors to the ShakerN and PivotingPlanes ground models have been changed. Previously, the location of the posts and size of the input connectors was based on two parameters, grid_x and grid_y. The size of the input connector was then [size(grid_x,1),[size(grid_y,1)]]. For a typical 4 post configuration, this size was [2,2]. It was determined that this approach was confusing and inconsistent between the two models. It was confusing because it was difficult to determine how the grid actually corresponded to an individual wheel.

As such, there is now a single parameter grid_x_y. The size of each input connector is then defined as [size(grid_x_y,1)]. For a typical 4 post configuration, this size is [4]. The post locations and input connector index now corresponds directly to the wheel_number. Therefore, the inputs for the left front wheel are index #1, right front wheel are index #2, etc. Please see the information layer for each ground model for more information: ShakerN and PivotingPlanes.

Changes from Version 1.7.1

An overview of some of the changes that have been made and issues that have been fixed in this version are included in the following lists.

Uncritical issues (i.e., issues that do not affect simulation results):

  • Removed obsolete visualization parameters in Wheels.
  • Removed obsolete parameters {housing_position,clutch_position} in Powertrain.Visualizers.
  • Removed obsolete parameters {gear_position,clutch_position} in Powertrain.Transmissions.
  • Removed obsolete parameters {r0MT,r0DT,n0MT,q0MT,n0DT,q0DT} in Vehicles.Templates.FrontEngineCar.

Available for: Dymola 2014 FD01
Modelica Standard Library Version: 3.2.1

Version 1.7.1 is a minor maintenance release. 

Added Flatpad Chassis Experiment

The flatpad is a simulation of the chassis sitting stationary on a flat pad/ground. The chassis is constrained from moving laterally, longitudinally and in yaw by the fixedRig robot. The steering is also locked by inputting a constant zero steer input into the steerRobot. This type of simulation is useful to look at the static balance of the car. This allows you to adjust spring preloads as necessary to trim the chassis as necessary based on either changing payloads or changes in spring rates. This is also a good simulation to use to evaluate the static toe and camber of the vehicle. By changing the steering input to a different source, the steering effect on the chassis can also be characterized.

Improvements to Online Help

  • Added Frequently Asked Questions found in the VDL User's Guide to the online help.
  • Updated Examples Information to include links to many of the examples found throughout VDL.
  • Improved documentation of tabular suspensions to better describe contents of tables.

Changes from Version 1.7

Some of the changes that have been made and issues that have been fixed in this version are included in the following lists.

Minor library additions:

  • Added an example for a steerable suspension in a rig.
  • Added two examples for steering systems in a rig.

Critical issues:

  • Modifications to tabular suspensions to ensure proper behavior in different vehicle coordinate systems.
  • The longitudinal acceleration in the quasi-static cornering events were incorrect in version 1.7. This error has been resolved and the acceleration is now correct and consistent with version 1.6.

Available for: Dymola 2014
Modelica Standard Library Version: 3.2

Version 1.7 is a major maintenance release with many changes in the underlying Modelica code to ensure better compliance to the Modelica Language Specification (Version 3.2).

Examples using the Modelon.DataAccess package

The Modelon.DataAccess is a new architecture for data management allowing users to conveniently populate models with data from sources outside the Modelica environments. Examples of using the DataAccess functionality will continually be added to VDL. In this release, some example experiments have been modified to take advantage of DataAccess. For example in SingleTrack, the parameters associated with the single track model are determined in the ParameterIdentification experiment and referenced in the DoubleLaneChangeVerification experiment.
Please see the release notes for 1.6 for more information on the capabilities of the DataAccess package.

Animation view commands added

Commands have been added to many experiments to modify the animation view in the active animation window. The commands allow the user to quickly view a vehicle, chassis, or suspension from the front, side, rear, top or isometric perspective. Most of the example experiments within VDL have these commands available. This is accomplished by extending a new experiment template called AnimationViews.

Changes from Version 1.6

An overview of some of the changes that have been made and issues that have been fixed in this version are included in the following lists.

Uncritical issues (i.e., issues that do not affect simulation results):

  • Animation of body disappears when copying examples
  • specular_coefficient parameter not propagated to visualizers in Chassis.Bodies.Visualizers
  • Correct info layer link in Examples.RunningOverCrest.RunningOverCrest
  • Added command to plot desired/actual path in plotClosedLoopDriver function
  • Added Linkages/Experiments/Examples/LinkageInRig
  • Corrected spelling error in parameter name sx_tabel_width

Available for: Dymola 2013FD01
Modelica Standard Library Version: 3.2

Version 1.6 of VDL contains the following main enhancements:


The Powertrain sub-package has been extended with components that allow for powertrain oriented analysis.

  • Template-based engine models with cycle resolved characteristics. The new models allow to study the mechanics of the engine, and engine-induced vibrations.
  • Engine, transmission and driveline mounts integrated in templates, including different options for mount characteristics.
  • Updated transmission models that can handle arbitrary number of gears, with optional gear dependent compliance and backlash for vibration analysis. Automatic transmission with torque converter and compliant lock-up-clutch. Slip-based continuously variable gear.
  • KERS, flywheel that can capture and release kinematic energy, based on rotating inertia.

The new powertrain components are designed to work well together with the rest of the vehicle and typical applications are drivability and take-off. The package has also been extended with dedicated powertrain test scenarios that makes use of test rigs to evaluate engine vibrations, acceleration performance etc.


VDL supports tuning of vehicle and chassis. This allow for automatic tuning of e.g. camber, toe, cross weight, and ride height. In the library, there are sub-packages Tunables that contains components such as mounts, seats, and links that can be adjusted during simulation. The tunables fit in the standard suspension architectures to facilitate configuration.

Grounds and Roads

Support for explicit contact point calculation so that the contact point can be performed in the ground model instead of the wheel or impact component. This allows for more convenient plug in of external ground and road models.


A new architecture for data management is introduced available in the DataAccess.

  • It allows users to conveniently populate models with data from sources outside the Modelica environments.
  • Users can also define own data hierarchies that do not have to match the model hierarchies.
  • Data can both be read from and written to the source. This gives a convenient way to link several simulations together.
  • The architecture further allows for convenient switching between different sources and source types with single changes.
  • DataAccess is especially suited for model export as it allows users to conveniently change model parameters in a consistent way regardless on how the model is exported (C-code, .dll, .exe, FMU, Simulink, etc.).
  • DataAccess can be made compatible with any format, by default it comes with support for XML.

Available for: Dymola 2013
Modelica Standard Library Version: 3.2

Version 1.5 has been improved especially with new functionalities to support steady-state, and quasi steady-state analysis.

Library additions  

  • New generic models and experiment that handles quasi steady-state driving events such as cornering, corner entry, corner exit, braking.
  • New sensors for height over ground and ground curvature. New set of linkage templates (requires the suspension option).
  • Introducing mounts that allow for more convenient customization of suspension linkage (requires the suspension option).
  • Electric vehicle example (requires the driveline option). Improved tabular suspensions.

Available for: Dymola 2012 FD01
Modelica Standard Library Version: 3.2

Version 1.4 has been improved especially with new functionalities to improve signal routing. User models from earlier versions must be converted using the included conversion script. Please refer to the Dymola User Manual for details on how to do this.

Library additions

  • A new option Active Safety that contains especially
    • models of safety systems such as ABS, ESP and more.
    • single track models with parameter identification experiment, also used as reference models for e.g. ESP models.
    • Support for traffic interaction and sensors to detect external objects. Can be used for e.g. brake assist function development and traffic interaction studies.
  • A new signal bus concept has been implemented to better support signal routing. Especially this means that no signal bus connections are required. Access to the signals can be made from anywhere within the model. Also vectorized signals are possible.
  • Improved driveline models
    • System layout also of different clutches and gears allow for easy design of different types of differentials, both active and passive. To illustrate this, examples of torque on demand clutches and active differentials are included in the library (requires the driveline option).
    • Visualization is added to improve understanding and analysis of the behaviour. It is also possible to visualize the torque flow through the driveline.
    • Improved clutch model with integrated compliance.
    • New components to support hybrid drivelines (requires the driveline option)
  • Improved initialization of shaft models, especially relevant to steering models.
  • Improved RoadBuilder format and tabular ground models.
    • New improved format that supports also closed tracks.
    • More RoadBuilder functions available, both for center-line description (x,y,z) and curvature-based descriptions.
    • Improved performance due to better numerics (numerical Jacobians eliminated).

Version 1.3.1 is a release made with Dymola 7.2 and contains minor bug fixes, primarily relating to automatic drivers and missing Simulink examples.

Version 1.3 is the first version that supports Modelica 3 and Modelica Standard Library (MSL) 3.0 User models from earlier versions must be converted using the included conversion script. Please refer to the Dymola User Manual for details on how to do this.

Conversion to Modelica 3 specification taking advantages of new language features

  • Vehicle Dynamics Library is now using MSL3.0 and is compatible with other Modelica 3 libraries.
  • The balanced-model concept has been implemented.
  • Restructuring of many models, especially the wheel models have a new structure that makes it easier to understand.
  • More flexible interfaces and templates using conditional connectors: This allow for the same templates to handle different subsystem configurations, e.g. Automatic and Manual transmission.
  • Better indication of the signal flow in test rig experiments: The use of specialized signal connectors is minimized which makes it easier to understand and modify the experiment setups.
  • New summary variable declaration that makes it easier for users to add their own variables.

Library additions

  • Support for uneven road through contact point filtering, see VehicleDynamics.Vehicles.Chassis.Experiments.Examples.WheelLoader (This example requires VDLTrucks option).
  • Support for both time- and distance-based preview in driver models: This facilitates the use of drive-cycle following drivers, see VehicleDynamics.Drivers.Experiments.Examples.DriveCycle.
  • New gear-set models suitable for handling: Manual, Automatic, CVT
  • Included length offset in links makes it easer to make adjustment studies on suspensions with design-freeze components
  • Improved structure of steering models: Predefined components for rack-and-pinion and pinion-gear makes it easer to modify and build user-defined steering models.
  • Improved structure of engine and transmission models makes it easier to add user-defined models and models from other libraries.
  • New drive shaft model with ideal characteristics: The shaft preserves the rotational velocity independently of shaft bend angles (Requires the VDLDrivelines option).
  • Default StateSelect.Always change to StateSelect.Prefer in Linkage components.
  • Humidity removed from atmosphere models

Minor maintenance release with:

  • Improved contact point calculation.
  • Improved wheel vizualization.
  • GST tire model imroved with support for similarity-based road friction variations and tabular pure-slip models.

VDL has been optimized to be used with Dymola 7.0.

  • New VDL option annotations require this version of Dymola. Currently, the available options are VDLCars, VDLTrucks, VDLSuspensions, VDLDrivelines and VDLParsfiles.
  • VDL 1.2 uses Modelica Standard Library 2.2.2.

Units can be automatically converted in this Dymola release so this VDL release will be the last release including the same variables with different units for summary tables (such as yaw rate w_z and w_z_deg). The variables with no unit suffix will remain as they exist.

Examples have been restructured to include experiments and components

  • Most main packages contain Examples packages for components (these should be duplicated to be customized).
  • Most Experiments packages contain Examples of complete models to simulate.
  • New examples for Realtime simulation (available with Dymola Realtime option).
  • New examples for simulation from Simulink (available with Dymola Simulink option).

Library additions

  • Suspension Links and Joints have cut-force summary variables and visualization vectors to easily find and see the forces transmitted by suspension joints.
  • The vehicleFrame can be rotated to a user-defined coordinate system (Forward-Leftward-Upward system, or FLU), allowing hardpoints from other coordinate systems to be directly used.
  • A linear tyre model is new.
  • New MultiBody instant rotation axis sensors can easily be attached to the hubs to visualize the roll center or kingpin axis.
  • Aggregated joint mechanisms are easier to understand and include the cut-force summary at joints.
  • A visualized dashboard example can directly animate the driver actions during the experiment.
  • Atmosphere with input signal for wind.
  • Upright with a lumped elasticity.
  • Suspension hub/axle motion sensor replacing suspension experiment variables.
  • Added tabular steering models for Cars and Trucks.
  • Chassis.Bodies package is structured more logically.
  • Interpolation methods for tabular gears (Translational and Rotational).
  • Added MultiBody sensors and visualizers.

The Trucks and Heavy Vehicles modeling extension to VDL is new (Beta status, available with VDLTrucks option)

  • Detailed truck and trailer chassis models including full and semi-trailer versions.
  • Single or twin tyres can be used with all suspension models.
  • Detailed tabular and geometric axle-based suspension models.
  • Chassis structure components (rigid or elastic frames, truck cabin with suspension, fifth-wheel and other hitches).
  • Configurable payloads, possibly dynamic (simulate a liquid tank trailer).

Driveline modeling has been extended (Beta status, available with VDLDrivelines option)

  • New shaft model includes 3-d constant-velocity (CV) or universal joints.
  • Driveline shafts have a debugging mode with visualization.
  • Rotational3D components can visualize the connector orientation.

Tabular gears have been extended to use numerical interpolation, enhancing the real-time capability.

  • Tabular gear are extended to use numerical interpolation that does not use the external LAPACK routine, enhancing real-time capability
  • SedanTEKBakker chassis parameters have been improved (rear damping)
  • Bakker tyre model load default parameter fixed
  • Improved transition between gears in gearSet

VehicleDynamics Library is a commercial and licensed Modelica™ library for the Dymola™ modeling and simulation environment. The scope of the library is simulation of complete road vehicles with focus on chassis dynamics. The chassis models are based on multibody mechanics with detailed models of wheel suspensions and tyres. The library covers all components required to build complete experiments for vehicle-dynamics analysis, including powerful road descriptions and driver models.

Main features

Highlight features of the library are:

  • Easy to build custom models and experiments from a large collection of components, templates, and test rigs
  • Intuitive and easy-to-learn user interaction for model construction and experiment analysis
  • Flexible to modify and customize subsystems, roads/maneuvers, chassis geometry, etc.
  • Most Modelica source-code is available for the user
  • Kinematic and elasto-kinematic suspensions, described with geometric linkages or tables
  • State-of-the-art tyre models
  • Detailed animation of simulation results
  • Summary records for easy plotting of variables of general interest
  • The RoadBuilder package allows complete flexibility in 3D road construction with driver reference trajectories
  • Driver models for open-loop and closed-loop driving. Custom test cases are conveniently specified using driver instructions
  • Powerful 3D driveline models, basic transmission and engine models
  • Flexible bus concept for convenient signal passing between sub-models, and also to Simulink

Changes from Version 1.0

This release of the VehicleDynamics Library provides considerable enhancements compared to earlier versions:

  • Improved library structure with enhanced set of experiment templates and components.
  • The UsersGuide is improved and distributed printed and as pdf.
  • The examples are extended with steer-by-wire application, control of active chassis systems and more.
  • The driver models are improved and contain perception, planning and tracking tasks as well as physical driver-vehicle interfaces.
  • A PowerTrain level is introduced for easier inclusion of non-conventional drives such as hybrids.
  • A new tyre model with physical extrapolation of pure slip data is included.
  • Dashboard model allow for driver-vehicle information exchange.

This is the first official release of the VehicleDynamics Library.