ReleaseNotes Rev14

LMS Imagine.
Lab Amesim
LMS Imagine.Lab Amesim 14
Highlights & Installation Manual
www.siemens.com/plm/lms
How to contact LMS Imagine.Lab
www.siemens.com/plm/lms Web site
https://support.industrysoftware.automation.siemens.com/gtac.shtml Technical support
See here for e-mail addresses for your local office:

https://www.plm.automation.siemens.com/en_us/about_us/contact/ Sales, pricing and general information
product-contacts.shtml#lms
+33 4 77 23 60 30 Phone
+33 4 77 23 60 31 Fax
Siemens Industry Software S.A.S.

7 place des Minimes Postal address
42300 Roanne - France
LMS Imagine.Lab Amesim® User’s Guides
© 2015 Siemens Industry Software NV

The software described in this documentation is furnished under a license agreement. The software may be
used or copied only under the terms of the license agreement. No part of this manual may be photocopied or
reproduced in any form without prior written consent from Siemens Industry Software NV.
TABLE OF CONTENTS
LMS Imagine.Lab Amesim 14 Windows/Linux – February 2015
1. LMS Imagine.Lab AmesimTM software 14 new features ........................................ 6

1.1. Platform Facilities ............................................................................................... 6
1.1.1. Data Import ................................................................................................ 6
1.1.2. Global Parameter Enhancements .............................................................. 6
1.1.3. Algebraic Loop Highlighting ....................................................................... 6
1.1.4. Statechart Designer with Composite & Parallel States............................... 7
1.1.5. Statechart Designer Enhancements........................................................... 7
1.1.6. GUI Performances for Huge Models with Supercomponents ..................... 7
1.1.7. Embedded Tables in Encrypted Supercomponents ................................... 8
1.2. Analysis Tools .................................................................................................... 8
1.2.1. Table Editor Filtering & Stairs Interpolation ................................................ 8
1.2.2. Table Editor Enhancements ....................................................................... 8
1.2.3. Plot Cursor Synchronization ....................................................................... 9
1.2.4. Plot Order Tracking .................................................................................... 9
1.2.5. AMETrack Enhancements ......................................................................... 9
1.2.6. 3D Animation Scene for Fuel Tanks......................................................... 10
1.2.7. 3D Animation Enhancements ................................................................... 10
1.2.8. 2D Dashboard Stateless Buttons ............................................................. 10
1.3. Optimization, Robustness, Design of Experiments .......................................... 11
1.3.1. Design Exploration APIs .......................................................................... 11
1.4. Interactive help ................................................................................................. 11
1.4.1. Amehelp Full Text Search by Category.................................................... 11
1.4.2. Welcome Page ......................................................................................... 11
1.4.3. Consistent Access for Help ...................................................................... 12
1.4.4. More Platform Manuals ............................................................................ 12
1.4.5. More Platform Demos .............................................................................. 12
1.4.6. Improved Access to Solutions Demos...................................................... 13
1.5. Simulator Scripting ........................................................................................... 13
1.5.1. Global Parameters API ............................................................................ 13
1.6. Amesim Customization .................................................................................... 13
1.6.1. App Designer Enhancements .................................................................. 13
1.6.2. App API Enhancements ........................................................................... 14
1.6.3. Extended Plots APIs ................................................................................ 14
1.6.4. Pie Chart APIs ......................................................................................... 14
1.7. LMS Amesim Suite ........................................................................................... 15
1.7.1. Ameset Compiler Settings ........................................................................ 15
1.8. Solvers and Numerics ...................................................................................... 15
1.8.1. Automated Linearization to get Maximal Frequencies ............................. 15
1.8.2. Performance Analyzer Enhancements ..................................................... 15
1.8.3. Runstatistics Enhancements .................................................................... 16
1.8.4. Run Parameters with More Info ............................................................... 16
1.8.5. 64-bit Linux [Rev 13 SL3] ......................................................................... 16
1.8.6. Compilation Settings in LMS Amesim Preferences tab ............................ 16
1.8.7. Ports 1D specifications for stdsimmanager [Rev 13 SL3] ........................ 17
1.9. MiL/SiL/HiL & Real-Time .................................................................................. 17
1.9.1. Access to Internal Variables ..................................................................... 17
1.9.2. Eigenvalues Animation............................................................................. 17
1.9.3. dSPACE Scalexio [Rev13 SL2] ................................................................ 18
1.9.4. Concurrent RT [Rev13 SL2] ..................................................................... 18
1.9.5. LMS Amesim to Simulink Interface .......................................................... 18
1.10. Software Interfaces ........................................................................................ 19
1.10.1. FMU Import Assistant............................................................................. 19
1.10.2. FMI 2.0 Co-simulation Master ................................................................ 19
1.11. 1D3D CAE...................................................................................................... 19
1.11.1. CAD2AME, productivity tool for 1D/3D applications ............................... 19
1.12. Modelica Platform .......................................................................................... 20
Highlights and installation manual 3/89

1.12.1. Modelica Editor, Save ............................................................................ 20
1.12.2. Modelica Editor, Sketch Connections..................................................... 20
1.12.3. Support of MSL Tables .......................................................................... 20
1.12.4. Modelica Import Assistant, Simplified Workflow [Rev13 SL2] ................ 21
1.12.5. Modelica Compiler, Event Semantics..................................................... 21
1.12.6. Modelica Compiler, Support of Specifications ........................................ 21
2. Library upgrades .................................................................................................... 22

2.1. 3D Mechanical ................................................................................................. 22
2.2. Aeronautics and Space .................................................................................... 23
2.3. Air Conditioning ................................................................................................ 27
2.4. Aircraft Electrics ............................................................................................... 27
2.5. Aircraft Fuel System ......................................................................................... 28
2.6. Automotive Electrics ......................................................................................... 29
2.7. Cams and Followers ........................................................................................ 29
2.8. CFD 1D Gas Dynamics .................................................................................... 30
2.9. Cooling System ................................................................................................ 31
2.10. Electric Motors and Drives ............................................................................. 31
2.11. Electrical Basics ............................................................................................. 31
2.12. Electrical Static Conversion............................................................................ 31
2.13. Electromechanical .......................................................................................... 32
2.14. Electric Storage .............................................................................................. 32
2.15. Gas Mixture .................................................................................................... 34
2.16. Hydraulic ........................................................................................................ 34
2.17. Hydraulic Component Design......................................................................... 34
2.18. Hydraulic Component Design Real Time ....................................................... 34
2.19. Hydraulic Resistance ..................................................................................... 35
2.20. IFP-Drive ........................................................................................................ 35
2.21. IFP-Engine ..................................................................................................... 36
2.22. IFP-Exhaust ................................................................................................... 39
2.23. Mechanical ..................................................................................................... 39
2.24. Moist Air ......................................................................................................... 42
2.25. Planar Mechanical .......................................................................................... 42
2.26. Pneumatic ...................................................................................................... 42
2.27. Pneumatic Component Design....................................................................... 43
2.28. Powertrain ...................................................................................................... 43
2.29. Signal, Control................................................................................................ 44
2.30. Simulation ...................................................................................................... 45
2.31. Thermal .......................................................................................................... 46
2.32. Thermal Hydraulic .......................................................................................... 46
2.33. Thermal Hydraulic Component Design .......................................................... 47
2.34. Two-Phase Flow ............................................................................................ 47
2.35. Vehicle Dynamics ........................................................................................... 48
3. Solution upgrades .................................................................................................. 49

3.1. Automotive ....................................................................................................... 49
3.1.1. Engine ...................................................................................................... 49
3.1.2. Drivetrain .................................................................................................. 50
3.1.3. Vehicle Integration ................................................................................... 52
3.1.4. Chassis .................................................................................................... 53
3.2. Off-Highway ..................................................................................................... 54
3.2.1. Drivetrain .................................................................................................. 54
3.2.2. Chassis .................................................................................................... 54
3.3. Aerospace and Defense ................................................................................... 55
3.3.1. Aircraft...................................................................................................... 55
3.4. Mechanical Industries ...................................................................................... 56
3.4.1. Fluids Systems and Components ............................................................ 56
3.4.2. Two Phase Flow Systems ........................................................................ 56
4. Platform issues resolved in LMS Amesim 14 ...................................................... 58
5. Known platform bugs ............................................................................................ 60

6. Known library bugs ................................................................................................ 61
7. Running previous version models on LMS Amesim 14 ...................................... 62
8. The LMS Amesim installation instructions .......................................................... 62

8.1. Before you start ................................................................................................ 62
8.2. Requirements ................................................................................................... 63
8.2.1. Hardware requirements............................................................................ 63
8.2.2. Software requirements ............................................................................. 64
8.2.3. Mounting the DVD drive (Linux only)........................................................ 65
8.3. The interactive installation procedure ............................................................... 65
8.3.1. Starting the LMS Amesim installation procedure ..................................... 66
8.3.2. Installing the LMS Imagine.Lab SysdmTM software client ......................... 73
8.4. The Installation procedure using scripts ........................................................... 74
9. Uninstalling LMS Amesim 14 ................................................................................ 75
10. The license manager installation instructions................................................... 76

10.1. The new license file ........................................................................................ 76
10.2. The new license daemon ............................................................................... 77
10.3. RLM setup ...................................................................................................... 77
11. License management ........................................................................................... 84

11.1. License servers and hostids ........................................................................... 84
11.2. Understanding the license file ........................................................................ 85
11.3. LMS_LICENSE environment variable ............................................................ 85
11.4. License administration tools ........................................................................... 85
11.5. Creating a local options file ............................................................................ 86
11.6. Dongle configuration ...................................................................................... 86
12. Compiler setup ..................................................................................................... 86

12.1. Windows (32 bits) ........................................................................................... 87
12.1.1. Microsoft Visual C++ .............................................................................. 87
12.1.2. Intel C compiler 10.0 (32 bits) ................................................................ 87
12.1.3. Intel Visual Fortran ................................................................................. 87
12.2. Windows (64 bits) ........................................................................................... 87
12.3. Linux .............................................................................................................. 88
13. Current platform support ..................................................................................... 89

1. LMS Imagine.Lab AmesimTM software 14 new
features
1.1. Platform Facilities
1.1.1. Data Import

The Data Import tool allows you to convert
user data to LMS Amesim directly usable
table formats.
1.1.2. Global Parameter Enhancements

Global parameter usability has been further
improved through colored tags, hyperlinks and
enumeration.
1.1.3. Algebraic Loop Highlighting

Algebraic loops are now detected and
highlighted. You can navigate between
generated loops.

1.1.4. Statechart Designer with Composite & Parallel States
You can now design more complex statecharts
using parallel and composite states.
1.1.5. Statechart Designer Enhancements

The statechart designer has undergone a
number of improvements to its compiler and
user interface.
• New syntax for timers to specify
timeouts for states
• Advanced event analysis algorithm to
reduce simultaneous event conflicts
• Revamped and optimized code
generation
• Integer input variable introduced
• Integration variables and use of
derivatives
• Improved creation and edition of
transitions
1.1.6. GUI Performances for Huge Models with Supercomponents

LMS Amesim 14 provides a significant
improvement in graphical interface
responsiveness:
• Manipulating component icons on a
large sketch is now smoother.
• Switching from Submodel mode to
Parameter mode is now faster.
• Performance bottlenecks observed
on particular models are removed.

1.1.7. Embedded Tables in Encrypted Supercomponents
The process of embedding tables in encrypted
supercomponents has been redesigned with a
global display of table path and format.
1.2. Analysis Tools
1.2.1. Table Editor Filtering & Stairs Interpolation

The Table Editor provides a filtering tool to
modify input date (through low-pass filters).
1.2.2. Table Editor Enhancements

The Table Editor provides new data
processing tools, and an improved Graphic
User Interface for easy access:
• Toolbar for data
interpolation/extrapolation
• Tool menu for data processing
• Stairs interpolation
• Spatial arrangement functions of data
samples
• Table properties based on
parameters

1.2.3. Plot Cursor Synchronization
Like all post-processing tools, the plot
now has a replay cursor that can be
synchronized with all other tools.
1.2.4. Plot Order Tracking

The order tracking facility now allows you to
define several orders and/or bandwidths to
plot on the same graph.
1.2.5. AMETrack Enhancements

AMETrack provides new options to get
more realistic bridges, improved ground
modeling and real roads through GPS
format support.

1.2.6. 3D Animation Scene for Fuel Tanks
The 3D Animation scene for fuel tanks
allows you to check the model
parameterization and visualize the results
in a 3D view.
1.2.7. 3D Animation Enhancements
3D Animation now provides fast 3D object

location and property edition, as well as
standard CAD format import.
1.2.8. 2D Dashboard Stateless Buttons

The 2D Dashboard proposes stateless
buttons to improve interactive simulation
with dynamic input change.

1.3. Optimization, Robustness, Design of Experiments
1.3.1. Design Exploration APIs

The Design Exploration API provides a
powerful “offline” use of the Design Exploration
functionalities of LMS Amesim through
scripting.
1.4. Interactive help
1.4.1. Amehelp Full Text Search by Category

The search facility in LMS Amehelp has
been redesigned for an improved user
experience, the appropriate information
can be obtained more easily.
1.4.2. Welcome Page

The Welcome Page provides information for
new users, and access to recent files in a
preview list.

1.4.3. Consistent Access for Help
Access to documentation pages has been
improved through various contextual help
links.
1.4.4. More Platform Manuals

New Platform manuals have been created,
and existing Platform manuals updated.
1.4.5. More Platform Demos

New demo pages propose examples of use for
Platform features.

1.4.6. Improved Access to Solutions Demos
Solution demo pages provide a new look and
feel through thumbnail images and tables.
1.5. Simulator Scripting
1.5.1. Global Parameters API

The Global Parameters API provides a
complete set of C functions to handle global
parameters. This allows you to:
• Customize global parameters sent to
a simulation.
• Read and write global parameter files
without worrying about version or
format.
• Convert legacy files to the new file
format.
1.6. Amesim Customization
1.6.1. App Designer Enhancements

The App Designer provides new menus,
toolbars, and enhanced Python and UI editors
to improve your user experience.

1.6.2. App API Enhancements
The Apps Python API provides new functions
to go further in customization and improve
development flexibility.
1.6.3. Extended Plots APIs

The Plot API provides new functions to create
graph annotations, plot manipulators, and
figure manipulation callbacks.
1.6.4. Pie Chart APIs

The Plot Python API provides new methods to
create fully customizable Pie chart
representation of results.

1.7. LMS Amesim Suite
1.7.1. Ameset Compiler Settings

You can now compile your own submodels for
64-bit Linux platforms with LMS Ameset.
1.8. Solvers and Numerics
1.8.1. Automated Linearization to get Maximal Frequencies

Automated Linearization provides automated
computation of maximum frequencies and of
maximum fixed step for stable explicit Euler
integration.
1.8.2. Performance Analyzer Enhancements

The Performance Analyzer has been improved
to strengthen model analysis.

1.8.3. Runstatistics Enhancements
The Run Statistics enhancements provide
Elapsed time, and Minimum and Maximum
integration step since last print, allowing for
more accurate information to analyze your
system.
1.8.4. Run Parameters with More Info
The Run parameters dialog box provides more

information for each solver option and
information messages appear depending on
current settings.
1.8.5. 64-bit Linux [Rev 13 SL3]

64-bit Linux platforms are now supported for
compiling and executing your LMS Amesim
models.
1.8.6. Compilation Settings in LMS Amesim Preferences tab

Available compilers are automatically
detected, and can be selected with a single
click.

1.8.7. Ports 1D specifications for stdsimmanager [Rev 13 SL3]
When performing parallel processing over a
distributed network, you can customize port
specification for each remote computing host.
1.9. MiL/SiL/HiL & Real-Time
1.9.1. Access to Internal Variables

With this feature you can sense internal
variables of components for control
applications within, or outside the LMS
Amesim environment, or for signal
processing.
1.9.2. Eigenvalues Animation

Eigenvalues animation provides an automatic,
dynamic view of a model’s eigenvalues. With
this facility, you can define an appropriate time
step. The facility is compatible with batch and
experiment runs, and with co-simulated
systems.

1.9.3. dSPACE Scalexio [Rev13 SL2]
You can now export and run LMS Amesim
Real-Time models on dSPACE SCALEXIO.
1.9.4. Concurrent RT [Rev13 SL2]

You can now export and run LMS Amesim
models on Concurrent SIMulation Workbench.
RedHawk Linux (32 or 64 bit) is supported.
1.9.5. LMS Amesim to Simulink Interface

The interface GUI has been redesigned on the
Simulink side. Global Parameters and Run
Parameters based on the LMS Amesim
model can be synchronized.

1.10. Software Interfaces
1.10.1. FMU Import Assistant

The FMU Import Assistant is a new wizard for
importing Functional Mock-up Units (FMUs) as
standard LMS Amesim submodels.
1.10.2. FMI 2.0 Co-simulation Master

The FMU 2.0 Co-simulation master allows you
to import Functional Mock-up Units (FMUs) for
Co-simulation 2.0 into LMS Amesim.
1.11. 1D3D CAE
1.11.1. CAD2AME, productivity tool for 1D/3D applications

With this tool, you can create, import and
modify CAD files.
• Import/Export Parasolid CAD files
(x_t, x_b)
• Standard CAD file format : STEP
• Basic modeling operations: split, fill,
hole…
• CAD measurements: distance,
length, angle, area, mass and volume
• Property calculation: mass, center of
gravity, and moment of inertia

1.12. Modelica Platform
1.12.1. Modelica Editor, Save

The new save function improves and clarifies
the save workflow in the Modelica Editor.
1.12.2. Modelica Editor, Sketch Connections

Sketch connections are now more intuitive.
Line handling is improved, and now consistent
with LMS Amesim.
1.12.3. Support of MSL Tables

Data interpolation can be performed using the
new MSL 3.2.1 table blocks.

1.12.4. Modelica Import Assistant, Simplified Workflow [Rev13 SL2]
The new, simplified workflow accelerates the
import of Modelica submodels.
1.12.5. Modelica Compiler, Event Semantics

The Modelica time model is now fully
supported, and simulator capabilities have
been extended.
1.12.6. Modelica Compiler, Support of Specifications

Support for Modelica libraries has been
improved.
• Support of “Inline” function annotation
• Support of “derivative” annotation
• Support of ModelicaUtility functions
• Improved support of redeclare and
class extends
• Build and distribution of MSL C-
source binaries

2. Library upgrades
2.1. 3D Mechanical
New submodels
M6DOFBODY10: body with variable mass and inertia [167147].
M6DOFBALL01: new junctions with contact forces having no implicit variable

[164746].
M6DOFTRBA01: new junctions with contact forces having no implicit variable

[164746].
M6DOFPIV01: new junctions with contact forces having no implicit variable

[164746].
M6DOFSLPI01: new junctions with contact forces having no implicit variable

[164746].
M6DOFPIV11: new junctions with contact forces having no implicit variable

[164746].
M6DOFTRA01: new junctions with contact forces having no implicit variable

[164746].
M6DOFSTR00 and M6DOFSTR01: slide curve junction [158513].
M6DOFPLA00 and M6DOFPLA01: planar joint [158513].
M6DOFPOI00 and M6DOFPOI01: point surface joint [158513].
M6DOFUNI00 and M6DOFUNI01: universal joint [158513].
M6DOFRIG00 and M6DOFRIG01: rigid joint [158513].

Submodels updated
M6DOFGROUND: Euler angles correctly displayed in 3D visualization
[158331].
M6DOFBODY00: Problem in Euler angles computation [162050] +

modification of minimum values for product of inertia parameters [163865].
2.2. Aeronautics and Space

New submodels
ATBENV_000: global environment definition [0168034].
ATBENVP_001: environmental properties reader [0168034].
ATB_PROP_001: environmental property for aerospace [0168034].
ATBFDLGGRD001, ATBFDLATGRD001 and ATBFD6DOFGRD001:

zero velocity source [0166300].
ATBFDLGZER001, ATBFDLATZER001 and ATBFD6DOFZER001: zero

force source [0166300].
ATBFDLGSRCFCE001: longitudinal flight - efforts generator [0166300].
ATBFDLATSRCFCE001: lateral force and torque source - expressed in

Rb [0166300].
ATBFD6DOFSRCFCE001: 6DOF force and torque source - expressed

in Rb [0166300].
ATBFDLGSLA001, ATBFDLGSLA002, ATBFDLATSLA001,

ATBFDLATSLA002, ATBFD6DOFSLA001, ATBFD6DOFSLA002: linear
acceleration sensor [0166300].

ATBFDLGSLV001, ATBFDLGSLV002, ATBFDLATSLV001,
ATBFDLATSLV002, ATBFD6DOFSLV001 and ATBFD6DOFSLV002:
linear velocity sensor [0166300].
ATBFDLGSLP001, ATBFDLGSLP002, ATBFDLATSLP001,

ATBFDLATSLP002, ATBFD6DOFSLP001, ATBFD6DOFSLP002: linear
position sensor [0166300].
ATBFDLGSRA001, ATBFDLGSRA002, ATBFDLATSRA001,

ATBFDLATSRA002, ATBFD6DOFSRA001 and ATBFD6DOFSRA002:
rotary acceleration sensor [0166300].
ATBFDLGSRV001, ATBFDLGSRV002, ATBFDLATSRV001,

ATBFDLATSRV002, ATBFD6DOFSRV001 and ATBFD6DOFSRV002:
rotary velocity sensor [0166300].
ATBFDLGSRP001, ATBFDLGSRP002, ATBFDLATSRP001,

ATBFDLATSRP002, ATBFD6DOFSRP001 and ATBFD6DOFSRP002:
Euler angles sensor [0166300].
ATBFDLGSTM001, ATBFDLGSTM002, ATBFDLATSTM001,

ATBFDLATSTM002, ATBFD6DOFSTM001 and ATBFD6DOFSTM002:
frame change sensor [0166300].
ATBFDLGB001: aircraft rigid body connected to three effort sources

[0166300].
ATBFDLATB001: body - lateral flight [0166300].
ATBFD6DOFB001: body - 6DOF flight [0166300].
ATBFDLGA001: aerodynamic efforts - longitudinal flight [0166300].

ATBFDLATA001: aerodynamic efforts - lateral flight [0166300].
ATBFD6DOFA001: aerodynamic efforts - 6DOF flight [0166300].
ATBTJ01, ATBTF01: ideal Brayton cycle jet engine [0163941].
ATBTS01: ideal Brayton cycle turboshaft engine [0163941]
ATBFDLGTHR, ATBFDLGTHR00, ATBFDLGTHR01, ATBFDLGTHR02:

ideal Brayton cycle jet engine - longitudinal flight [0163941].
ATBFDLATTHR00, ATBFDLATTHR01, ATBFDLATTHR02: ideal

Brayton cycle jet engine - lateral flight [0163941].
ATBFD6DOFTHR00, ATBFD6DOFTHR01, ATBFD6DOFTHR02: ideal

Brayton cycle jet engine - 6DOF flight [0163941].
ATBFDLGLG001: landing gear - longitudinal flight [0166300]
ATBFDLATLG001: landing gear - lateral flight [0166300]

ATBFD6DOFLG001: landing gear - 6DOF flight [0166300]
ATBPROP01: model of propeller for aerospace applications [0163941].
ATBFDLGPROP00, ATBFDLATPROP00: propeller - longitudinal and

lateral flight [0163941]
ATBFD6DOFPROP00: propeller - 6DOF flight [0163941]
ATBFDLGDYNP001: dynamic node - longitudinal flight [0168427]
ATBFDLATDYNP001: dynamic node - lateral flight [0168427]
ATBFD6DOFDYNP001: dynamic node - 6DOF flight [0168427]

2.3. Air Conditioning
Dedicated tools updated
AC Heat Exchanger calibration tool: improvement of

the GUI and possibility to have variable condition for
the external moist air [ref 155414].
2.4. Aircraft Electrics

New submodels
ACERL01, ACERL02 and ACERL03: normally-closed relay [0153554].
ACERL11, ACERL12 and ACERL13: aircraft-normally open functional relay

[0153554].
Submodels updated
ACECB01, ACECB02: handling of tabulated variable delay as a function of current

[0159091].
Documentation updated
Update Aircraft Electrics manual with best practices for electrical network modeling
[0168442].

2.5. Aircraft Fuel System
New submodels
ACFTFL032, ACFTFL042: distributed fuel pipe with heat exchange [0158848,

0162688].
ACF2THHVOR001, ACF2THHGMVOR001: thh variable orifice for tank [0158851].
ACF2THHPNVOR001, ACF2GMTHHGMVOR001: thh and pn or gm variable orifices

for tank [0158851].
ACF2PNVOR001, ACF2GMVOR001: pn or gm variable orifice for tank [0158851].
ACFFLAPV001, ACFFLAPVGM001: flap valve between two tanks [0158851].
ACF2THHCVOU001, ACF2THHGMCVOU001: check valve for tank liquid flow out

[0158851].
ACF2THHCVIN001, ACF2THHGMCVIN001: check valve for tank liquid flow in

[0158851].
ACF2THHFLOATV001, ACF2THHGMFLOATV001: thh float valve for tank

[0158851].
ACF2PNFLOATV001, ACF2GMFLOATV001: pn or gm orifice with float vent valve

[0158851].
ACF2PNCVOU001, ACF2GMCVOU001: check valve for tank gas flow out

[0158851].
ACF2PNCVIN001, ACF2GMCVIN001: check valve for tank gas flow in [0158851].
ACF2THHPNCVOU001, ACF2GMTHHGMCVOU001: check valve for tank gas or

liquid flow out [0158851].

ACF2THHPNCVIN001, ACF2GMTHHGMCVIN001: check valve for tank gas or
liquid flow in [0158851].
Submodels updated
ACFWOR003: hole in tank wall allowing liquid and gas flow. Improvement:
Orifice orientation varies with the aircraft attitude [0158641].
ACFTNK00, ACFTNKGM00, ACFTNK001 and ACFTNKGM001: simple tank

model (not handling acceleration) and complex shape tank handling inerting
and accounting for aircraft attitude and acceleration brief description.
Improvement: Tanks can go from completely empty to completely full
[0158674].
2.6. Automotive Electrics

Obsolete submodels
AEFUS01, AEFUS02 and AEFUS03 are now considered as obsolete and should
be replaced by AEFUS11, AEFUS12 and AEFUS13 [0167189].
Wire, Fuse and Gearmotor parameter setting tools

have an improved layout [0166247].
2.7. Cams and Followers

Submodels updated
CFROL00, CFROL00A and CFROL10: full compatibility with data files produced by
Cam Designer [169656].

CFFLAT00, CFFLAT00A and CFFLAT10: full compatibility with data files produced
by Cam Designer [169656].
Utilities updated
CF_loadprofND: this function can read cam profiles including velocity and acceleration produced
by Cam Designer [169656].
New dedicated tools
Cam Designer: this new tool enables the user to

create its own cam profile with respect to specific
design constraints [164459].
New documentation
New manual dedicated to Cam Designer [164459].
2.8. CFD 1D Gas Dynamics

New submodels
CFD1DPIPEBENTTHSNR00: bent pipe with thermal and sensor ports [ref
0163533].
CFD1DPIPESIMPLE01: straight pipe with absorbent material [ref 0099256].
CFD1DGLBP000: definition for mesh size, solver type and gas properties
used in CFD 1D components [ref 0169290]. Possibility to run multi-thread
simulations, specifying the number of threads [ref 0158760]. Relaxation of
mesh size locally in the sketch [ref 0096086]. This submodel replaces
obsolete submodels CFD1DGLBP01 and CFD1DGLBP00.
The CFD1D library user manual has been updated. In particular there is a new section
dedicated to the CPU time optimization, giving insights on available solver types and
the multithread option for simulations [ref 0164127].

2.9. Cooling System
Update equations in the Cooling System documentation thanks to LateX [ref 154992].
2.10. Electric Motors and Drives

New submodels
EMDDCSSRFW01: direct current machine with series windings and saturation,

relay and freewheel diode. Use this submodel to represent a starter motor with
fast CPU performance.
2.11. Electrical Basics

New submodels
EBPS11, EBPS12 and EBPS13: power source or sink. In these submodels, there is
no state variable. In some cases, it reduces the computation time [0154893].
2.12. Electrical Static Conversion

New demo
DC motor drive with DC/DC converter: this demonstration

illustrates how different DC-DC converters can drive a motor
and recover energy.

2.13. Electromechanical
New submodels
EMLTR2C01 and EMLTR2C02: linear magnetic transducer with 2 coils

[0157974].
EMLTR2C02, EMLTR2C03: linear magnetic transducer with 2 coils with thermal

ports [0157974].
EMLTR2C11 and EMLTR2C12: linear magnetic transducer with 2 coils with data
relative orientation [0157974].
Submodels updated
EMLTR01 and EMLTR02: Simulations used to freeze when the inductance

tended toward zero. A new protection stops the simulation before it occurs and
raises an error message [0166071].
EMLTR03, EMLTR04, EMLTR11 and EMLTR12: Simulations used to freeze

when the inductance tended toward zero. A new protection stops the simulation
before it occurs and raises an error message [0166071].
EMME11, EMME12, EMME13, EMME21, EMME22, EMME23, EMME31,

EMME32 and EMME33: eddy current computations can be disabled. It may
reduce the computation time.
EMMR11, EMMR12, EMMR13, EMMR21, EMMR22, EMMR23, EMMR31,

EMMR32 and EMMR33: eddy current computations can be disabled. It may
reduce the computation time.
Utilities updated
CreateBHSpline: vacuum permittivity is used to extrapolate B(H) characteristics with a constant
slope in cubic interpolation mode. Magnetic material models are now more accurate for high
magnetic intensity in cubic interpolation mode [0157833].
2.14. Electric Storage

New submodels
ESSBATCSQS03, ESSBATCQS03, ESSBATCDY03, and ESSBATCTO03:

battery cell with current source causality. This new causality enables to directly
connect several cells in parallel [0140253].

ESSBATCSQS03, ESSBATCQS03, ESSBATCDY03 and ESSBATCTO03:
battery pack with current source causality. This new causality enables to directly
connect several packs in parallel (for example: a battery pack and an
ultracapacitor pack) [0140253].
ESSUCAPCS03, ESSUCAPC03: ultracapacitor cell with current source causality.

This new causality enables to directly connect several cells in parallel [0140253].
ESSUCAPPS03, ESSUCAPP03: ultracapacitor pack with current source

causality. This new causality enables to directly connect several packs in parallel
(for example: a battery pack and an ultracapacitor pack) [0140253].
ESSSCU02: Safety Control unit based on power look-up tables.
New pre-calibrated submodels

LIION_NCAC_HP_ESSBATCQS01/02/03: Li-ion NCA-C High Power quasi-static
battery cell with aging [0164580].
LIION_NCAC_HE_ESSBATCQS01/02/03: Li-ion NCA-C High Energy quasi-static
battery cell [0164580].
LIION_NCAC_HP_ESSBATPQS01/02/03: Li-ion NCA-C High Power quasi-static

battery pack with aging [0164580].
LIION_NCAC_HE_ESSBATPQS01/02/03: Li-ion NCA-C High Energy quasi-static
battery pack [0164580].
Utilities updated
ESSInitOCV is now obsolete. It is replaced by ESSInitOCV2 that features a specific discontinuity
handling for the entropic coefficient. It only applies to linear interpolation mode when the entropic
coefficient is computed from the OCV derivative [0148576].
IFP_ESSdUdT is now obsolete. It is replaced by IFP_ESSdUdT2 that features a specific
discontinuity handling for entropic coefficient. It only applies to linear interpolation mode when the
entropic coefficient is computed from the OCV derivative [0148576].
Battery identification assistant: A new section shows the

difference between the measurement and the identified model
corresponding result to evaluate the identification accuracy
[0158046].

2.15. Gas Mixture
Implementation of the fog in the Gas Mixture and-Moist Air libraries [ref 157749].
2.16. Hydraulic
New submodels
PEG02, PEG03: .new gear pumps models with uneven numbersof teeth [0154822]
EJECT020: model of ejector pump with geometrical parameters [0124613]
Submodels updated
FP04: new fluids for aeronautic applications. [0120914], and correction of the
viscosity for several fluids [0165790]
2.17. Hydraulic Component Design

Submodels updated
BAP27, BAP28, BRP027, BRP028: correction of the mean pressure value for
negative lift values [0168457].
BASEN02: correction of the handling of a null value for the clearance on

diameter [0140393] and corrected numerical errors [0162860].
2.18. Hydraulic Component Design Real Time

Submodels updated
BAP27RT, BAP28RT: correction of the mean pressure value for negative lift values
[0168457].

2.19. Hydraulic Resistance
New submodels
component
Additional causalities added for bends and pipes [0158588].
Submodels updated
HRBEA0010, HRBEA0011, HRBEA0012, HRBEA0013, HRBEA0040,
HRBEA0041: corrected min/max values of some parameters in bearing
submodels [0154848]
2.20. IFP-Drive
New submodels
DRVDRV02A, DRVDRV02B and DRVDRVRMT02: update pull-away [ref
168068]. These submodels replace DRVDRV01A, DRVDRV01B and
DRVDRVRMT01 that are now considered as obsolete.
DRVDRVRMTD01 and DRVDRVRATD01: need for reverse driver with

target speed function of vehicle displacement [ref 166257].
DRVDRVRMTNC01: reverse driver with gearbox management without

clutch [ref 166068].
DRVVCUE01, DRVVCUSH01 and DRVVCUPH01: update VCU to use with

reverse drivers [ref 166068]. These submodels replace DRVCUE0A,
DRVCUSH1A and DRVCUPH1A that are now considered as obsolete.
DRVMG11, DRVMG12, DRVMGC11, DRVMGC12, DRVAG11, DRVAG12,

DRVDCT11 and DRVDCT12: use efficiency or losses in gearbox [ref 12083
& 148883]. These submodels replace DRVMG01, DRVMG02, DRVMGC01,
DRVMGC02, DRVDCT01, DRVAG01 and DRVAG02 that are now
considered as obsolete.
DRVELMT01: electric motor with maximum/minimum torque at port for

control purpose [ref 166068]. This submodel replaces DRVELMT0A that is
now considered as obsolete.

Submodels updated
DRVMP2A: need to include WLTC driving cycle in the IFP-Drive mission

profile [ref 139417].
DRVICE01E: maximum torque is never zero even if engine is stopped [ref

166948].
New dedicated tools

Driver Selection: this tool is an assistant to select the correct driver for
your application [ref 166770]:
DRVICE Table Creator: this tool is dedicated to the creation of the IFP-
Drive engine maps from very simple parameters:
2.21. IFP-Engine
New submodels
ENG_DIESEL_EU, ENG_GASOLINE_EU: specific fuel for European

reference [ref0162431].

ENG12MD02, ENG12_DIESEL, ENG12_DIESEL_EU,
ENG12_GASOLINE_UNLEADED, ENG12_GASOLINE_EU,
ENG12_E05, ENG12_E10, ENG12_E85, ENG12_E10,
ENG12_NATURAL_GAS: customized fuels for the 12 gas fluid definition
[ref0162431].
ENGDEF02: engine stroke is now computed according to the piston pin

offset [ref 0158663]
An app has been created to help users setting up the submodel
parameters with clear and visual representations [ref 0161640].
ENGVDEF03: the number of valves is a new parameter of the submodel

for effective area mode [ref 0159670]
An app has been created to help users setting up the submodel
parameters with clear and visual representations [ref 0161640].
ICEMVEMG01: user-defined MVEM with full flexibility to handle data or

maps [ref 0166076]
ENGMVEMSIVVT00: MVEM submodel which takes into account the
Variable Valve Timing [ref 0166302]
ICEM12MVEMCI00: MVEM with emissions for Diesel application [ref
0165550].
ENG12THROT01, ENG12THROT02: Throttle to handle 12 gas mixture.
ICE12COMP02, ICE12COMP03: compressor models to handle 12 gas

mixture [ref0120123].
ICE12TURBSS00, ICE12TURBTS00, ICE12TURBVG00: turbine model to

handle 12 gas mixture [ref0120123].
Submodels updated
ENGPARAMDFM: added an optimization algorithm in order to calibrate the

ENGDFM02 submodel [ref0162930].
ENGCFM50, ENG12CFM50: more physical turbulence model and handling

of the combustion cyclic variability [ref 0162939].
ENGDFM02, ENG12DFM02: deal with the ignition delay up to 11 injections

[ref 0162939].
ENGLAMSE11, ENGLAMSE12, ENGLAMSEL11 and ENGLAMSEL12:

updated to take into account the oxygenated fuel [ref 0157538].

New dedicated tools
ENGDEF02: a tool has been created to help users setting up the engine definition
parameters with clear and visual representations [ref 0161640]:
ENGVDEF03: a tool has been created to help users setting up the cylinder head
definition parameters with clear and visual representations [ref 0161640]:
Dedicated tool updated

ENGPARAMDFM: added an optimization algorithm in order to calibrate the
ENGDFM02 submodel [ref0162930]:

2.22. IFP-Exhaust
New submodels
EXHCC3WCTRL05: 3 Way Catalytic Converter submodel adapted for FTS and HIL
applications [0168499].
EXHDOCCTRL05: Diesel Oxidation Catalyst submodel adapted for FTS and HIL
EXHLNTRCTRL05: Lean NOx Trap submodel adapted for FTS and HIL
EXHSCRCTRL05: Selective Catalyst Reduction submodel adapted for FTS and

HIL applications [0168499].
EXHGPF05: Gasoline Particulate Filter submodel adapted for Gasoline engine with
a particulate filter [0167127].
EXHCC3W05, EXHDOC05, EXHLNTR05, EXHSCO05, EXHSCR05, EXHDPF05,

EXHSCRF05 and EXHEGP05: add the possibility to set kinetic parameters with
normalized units [159276].
New methodology guides to explain the parameters setting for the submodels 3WCC,
DOC, LNT and SCR [0169490].
2.23. Mechanical
New submodels
MECFR1TK0: increased usability. This submodel replaces FR1TK000

that is now considered as obsolete [96239].
MAS32: equivalent to MAS31 with reversed causality [120221].

MECFR2TK0: increased usability. This submodel replaces FR2TK000
that is now considered as obsolete [96239].
BELWSR0 and BELWSR0A: Belleville spring [152652-164282].
MECFR1T0A and MECFR1T0B: increased usability. These new

submodels replace FR1T000, FR1T001, FR1T0010, FR1T0011,
FR1T020, FR1T021, FR1T010 and FR1T031 that are now considered
as obsolete [96239].
MECFR2T0A, MECFR2T0B, MECFR2T0C and MECFR2T0D:

increased usability. MECFR2T0A and MECFR2T0C replace FR2T000,
FR2T0010, FR2T020 and FR2T030 that are now considered as
obsolete. MECFR2T0B and MECFR2T0D replace FR2T001,
FR2T0011, FR2T021 and FR2T031 that are now considered as
obsolete [96239].
MECRL31A and MECRL32A: rotary loads with moving envelope

including endstops [166456].
MECFR1R0A: increased usability. This submodel replaces FR1R000,

FR1R0010, FR1R020 and FR1R030 that are now considered as
obsolete [96239].
MECFR2R0A: increased usability. This submodel replaces FR2R000,
FR2R0010, FR2R020 and FR2R030 that are now considered as
obsolete [96239].
MECFR1RK0 and MECFR1RK0A: increased usability. These

submodels replace FR1RK000 and FR1RK000A that are now
considered as obsolete [96239].
MECFR2RK0 and MECFR2RK0A: increased usability. These
submodels replace FR2RK000 and FR2RK000A that are now
considered as obsolete [96239].
RRUB01A, RRUB02A, RRUB03A, RRUB11A and RRUB12A: include

rotation angle at port [92494].
CAM00A: includes rotation angle at port [92494].
CRANK0A: includes rotation angle at port [92494].

RSHE002A: includes rotation angle at port [92494].
RSHE001A: includes rotation angle at port [92494].
WINCH01A: includes rotation angle at port [92494].
Submodels updated
RN010, RN011, RN010A and RN011A: added power, energy and activity
calculations [124590].
RACK02 and RACK02A: added power, energy and activity calculations [124590].
SRWNT1 and SRWNT1A: added power, energy and activity calculations

[124590].
SRWNT2 and SRWNT2A: added power, energy and activity calculations

[124590].
WORMGR1 and WORMGR1A: added power, energy and activity calculations

[124590].
WORMGR2 and WORMGR2A: added power, energy and activity calculations

[124590].
VRL000, VRL3A, VRL001 and VRL4A: angle miscalculation corrected [167689].
ROP0001, ROP0011, ROP0012 and ROP0013: unexpected warning message

corrected [152683].

2.24. Moist Air
Submodels updated
MACND010: corrected a bug which prevented the condensation chamber to work
properly with only one species [0131222].
2.25. Planar Mechanical

New submodels
PLMTO1D10: 1D to 2D connector computing automatically the acceleration
[153865].
PLMDVMBOD00: new body with variable mass and inertia, replaces

PLMDVMBOD0 [166862].
Submodels updated
PLMROPE0: specify initial tension [151630].
PLMTO1D0: rotary angle added as external variable [153864].
2.26. Pneumatic
New submodels
PNVS003, PNVS004: new pneumatic source components with modified units at

signal ports [7269339].
Additional causalities added for bends and pipes [0158588].

Submodels updated
TPEX001: changed range of Reynolds for laminar/turbulent transition

[0171026].
Corrected gas type index title in pneumatic pipes TPGLxx [0163140].
2.27. Pneumatic Component Design

Submodels updated
PNAP27, PNAP28, PNRP027, PNRP028: correction of the mean pressure value

for negative lift values [0168457].
2.28. Powertrain
New submodels
TRBLCSH0: balance shaft is an eccentric weighted shaft that cancels out vibrations
in unbalanced engine designs [0135659].
TRVS0A, TRVS0B: linear velocity sensor compatible with TRVEH04 submodel

[0166260].
TRVDENGMOUNT02: engine mount with variable damping [0161472].
TR2DTOPLM01A, TR2DTOPLM01B: connector between the ports of Transmission

(TR) tyres and suspensions and the ports of Planar Mechanical (PLM) bodies
[0154083].
TRTLEXPORT01: export LMS Amesim simulation results into .unv file that can be
read by LMS Test.Lab Desktop [0161530].
TRCPA01: centrifugal pendulum vibration absorber [0150546].

Submodels updated
TRDB00*, TRDC00*: enhancement of parameters groups “slipping velocity”

and “thermal” [0136293] and [0137949].
TRSUSP3B: fix of the longitudinal forces calculation [0169745].
TRCS004, TRCS005: fix of the torque reaction calculation [0167881].

TRCS004, TRCS005: add parameter angular position of the crank throw
center of gravity [0165839].
TR2DVEH01A/B/C/D: fix of Newton’s second law in horizontal direction

[0159229].
TRDMF0A: fix of auto-initialization [0163311].

TRDMF0A: fix discontinuity issues [0168286].
TRTC00A: fix readTCtable function to check the values returned by rtable1d

[0170104].
TRTC00A: fix readTCtable function to handle decreasing order for the overrun
table values
2.29. Signal, Control

Many icon names in the Signal library have been renamed to be clearer [96914].
New submodels
SIGLOGICAL0: new logic components [161312].
SIGLOGICALNOT0: new logic components [161312].
SIGNLOGICAL0: new logic components [161312].

Submodels updated
SIGUDA01: stairs interpolation [112186] and corrected display of slopes for

out of range mode [167706].
SIGWRITE0: possibility to disable the write operation [120630].
SIGWRITE1: possibility to disable the write operation [120630].
SIGSSP: X values no longer overwritten by X at linearization time [170086].
RIN00: the state variable is no longer reset at each call [169542].
SIGFXA01: stairs interpolation [112186] and corrected display of slopes for

FXYA001: stairs interpolation [112186] and corrected display of slopes for out
of range mode [167706].
FXYA02: corrected display of slopes for out of range mode [167706].
FXYZA001: stairs interpolation [112186] and corrected display of slopes for

FXYZA002: corrected display of slopes for out of range mode [167706].
NDFXA0: stairs interpolation [112186] and corrected display of slopes for out
of range mode [167706].
2.30. Simulation
Submodels updated
SIMP00: new variables for min and max time step reset at each call [156934] and
possibility to set the fixed solver step [153838 + 168294].
Utilities updated
rtable1d, rtable2d, rtable3d, rtablend, rtablemd, rtablem3d and rtablexy: improved robustness
with respect to incorrect table formats [168014 + 160593].
splinitnd: reduce memory size required for cubic spline interpolation [135187].

2.31. Thermal
Submodels updated
THMAS00: define the moist air boundary conditions thanks to the wet bulb
temperature [ref 159864]
2.32. Thermal Hydraulic

Submodels updated
TFPU000: improvement of the mass and energy conservation [ref 154846].
TFHA0010 and TFHA0011: add precharge in the accumulator [ref 161144].
TFAC000 and TFAC001: add precharge in the accumulator [ref 161144].
TFEX001: changed range of Reynolds for laminar/turbulent transition [0171026].
HRBEA0010, HRBEA0011, HRBEA0012 and HRBEA0013: corrected min/max

values of some parameters in bearing submodels [0154848].
HRBEA0040 and HRBEA0041: corrected min/max values of some parameters in

bearing submodels [0154848].
NTU regression tool: various updates in the tool to

improve the accuracy [ref 168373, 165774, 159425,
171026 and 163629].

2.33. Thermal Hydraulic Component Design
New submodels
THBAO0041, THBAO0042, THBRO0041, THBRO0042: spool with circular hole
upgraded so that the computation does not assume a planar geometry anymore
[0155464].
Submodels updated
THBAP27, THBAP28, THBRP027 and THBRP028: correction of the mean pressure

value for negative lift values [0168457].
2.34. Two-Phase Flow

New submodels
TPFPU000: Two phase flow centrifugal pump [120376].
TPFCVINT00/01/02/03: TPF pipe with heat exchange and two thermal ports
[0132152].
enhance TPF nodes (3 and 4 ports, all causality) [ref 165708].
Submodels updated
TPF_FP01: Add R407c fluid and model the glide effect below the saturation curve
[0166274, 0168379 and 162032].
TPFMAS00: define the moist air boundary conditions thanks to the wet bulb
temperature [ref 159864].

2.35. Vehicle Dynamics
New submodels
VDTIRESOFT0A: tire for soft soil [0157602].
VDSRTIREFORKIN0: replace the belt, tire and road as seen from the kinematic
[0121265].
VDSRKIN_BELT01: kinematic source for belt submodel [0121265].
Submodels updated
VDTIRE02A, VDTIRE03A: default values for Pacejka 97 and 2002 result in
reversed camber forces [0170937].
VDTIRE03A: fix error in lateral stiffness computation [0170959].
VDGROUNDCTC0: sinus ground computation and animation do not match

[0170886].

3. Solution upgrades
3.1. Automotive
3.1.1. Engine
New demos
LMS Amesim demo help > Solutions > Automotive > Engine > Control
units for Mean Value Engine Model (ECU) > Gasoline engine (MVEM)
with an electric supercharger (Engine_SI_electricSuperCharger.ame):
the demo purpose is to simulate an in–line four cylinders gasoline
engine connected to an electric supercharger.
LMS Amesim demo help > Solutions > Automotive > Engine > Exhaust
system > Management of Additional Species in IFP-Exhaust
(ManagementAdditionalSpecies1.ame): the demo purpose is to explain
the workflow to manage additional species in the IFP-Exhaust Library.
LMS Amesim demo help > Solutions > Automotive > Engine >
Valvetrain system > Electro-hydraulic variable valve actuation and air
content (VVA_LMS_THH.ame): the demo purpose is to demonstrate the
impact of air content on the behavior of a VVA system.
Demo updated
LMS Amesim demo help > Solutions > Automotive > Engine > Stop &
Start application > Diesel engine with starter and battery
(Engine_DID_Start_Stop.ame): the electrical starter has been updated in
order to improve CPU time.
LMS Amesim demo help > Solutions > Automotive > Engine > Complete
vehicle modeling with controls for MIL / SIL / HIL applications > Detailed
powertrain plant models ( PWT_ENG4T_AT6_MIL/SIL/HIL.ame): a
predictive model for combustion chamber has been implemented.
Migration to up to date softwares (64 bits, Matlab 2013, dSpace Next
Generation).

3.1.2. Drivetrain
New demos
LMS Amesim demo help > > Solutions > Automotive > Drivetrain >
Transmission / Gearbox> Automatic gearbox > Park lock mechanism for
automatic transmission (ParkLockMechanism.ame): the demo purpose is
to model and simulate the park lock mechanism of a standard automatic
transmission.
Transmission / Gearbox> Manual gearbox > Losses analysis of a
manual transmission (MT6_losses_analysis.ame): the demo purpose is
to introduce the app for gear parameters setting and to analyze and
optimize the losses of a gearbox.
Driveline / Differentials > Reaction torque Front Wheel Drive
(reactionTorque_FWD.ame): the demo purpose is to deal correctly with
the reaction torque acting on the engine block and coming from the
engine moving parts and the gearbox.
Clutch / Torque Converter / Dual Mass Flywheel > Centrifugal Pendulum
Vibration Absorber (CPVA_filtration.ame): the demo purpose is to show
how to use of a Centrifugal Pendulum Vibration Absorber (CPVA) in
order to improve the filtration efficiency of a Dual-Mass Flywheel (DMF).
LMS Amesim demo help > Libraries > Powertrain > Engine crankshaft
with twin balance shafts (L4_engine_balance_shafts.ame): the demo
purpose is to highlight the role of twin balance shafts in a L4 cylinders
engine that is to say to balance the vertical force generated by the
crankshaft resulting in a smooth running engine with minimal vibration.

Demo updated
LMS Amesim demo help > Libraries > Powertrain > Engine >
Torsional Vibration Analysis of LMS Amesim simulations
using LMS Test.Lab post-processing: new tutorial based on
the demo L4_engine_step2 to export LMS Amesim simulation
results into a universal file format and how to apply the post-
processing features of LMS Test.Lab to these results for
Torsinal Vibration analysis.
New apps
Configuration tool for simple gears: help parameters setting of
the simple gear submodels. The geometry tab offers a 2D
view of the gear set that dynamically changes accordingly to
the parameters [0152979].
LMS Amesim export to LMS Test.Lab: this tool is able to

export the current LMS Amesim simulation results into a .unv
file that can be read by LMS Test.Lab Desktop [0161530].
Apps updated
Shape Editor: fix modulo display in case of simple dog
geometry option [0169111].
Modal Projection tool: several enhancements to improve

usability including GUI improvements, state variables filtering
and sorting, selection of the submodel related to the selected
state variable [0165209].

Engine block app: several enhancements including the Mount
Design Assistant which determines the optimal engine mounts
properties in order to decouple the powertrain modes
[0154479].
DMF app: fix global parameters reset [0165188].
Engine harmonics app: several enhancements to improve

usability [0163417].
3.1.3. Vehicle Integration
New demos
LMS Amesim demo help > Solutions > Automotive > Vehicle
Integration> Electric vehicle > Battery aging and charging strategy :
Assess battery aging in the context of a vehicle usage for 5 different
charging strategies.
LMS Amesim demo help > Solutions > Automotive > Vehicle
Integration > Hybrid vehicle > Multi-criteria analysis > Maneuvers and
control made with Statechart (ManeuversSequence_Statechart.ame):
the demo purpose is to model a sequence of maneuvers and the
vehicle subsystems controllers thanks to the Statechart feature.

3.1.4. Chassis
New demos
LMS Amesim demo help > Solutions > Automotive > Chassis > Axle system
> Kinematics and Compliance (K&C) test bench template > Multibody
McPherson Axle System (Multibody_Axle_KandC_Bench_McPherson.ame):
the demo purpose is to generate the K&C functional characteristics of a
given axle system, knowing the hard-point location and bushing stiffness.
LMS Amesim demo help > Solutions > Automotive > Chassis > Integration
of vehicle dynamics systems > 4 wheels drive tractor with oscillating front
axle pulling a trailer (tractor_soft_soil.ame): the demo purpose is to model
and simulate the interactions of driveline and chassis (weight transfer) in a
realistic environment (soft soil + slopes + bumps + turn). The tractor has a
front oscillating axle and is pulling a trailer, this results in complex weight
transfers that affect available traction. In that context the limited slip
differentials must balance mobility, manoeuvrability, tire wear…
App updated
Trajectory designer app enhancement to handle long
trajectories [0159791].

3.2. Off-Highway
3.2.1. Drivetrain
New demos
LMS Amesim demo help > Solutions > OffHighway > Drivetrain >
Transmission / Gearbox > Hydrostatic transmission > Hydrostatic
transmission of tractor (HydrostaticTransmission_Tractor.ame): the
demo purpose is to analyze the power losses and monitor the global
efficiency of an hydrostatic transmission in function of the vehicle speed.
3.2.2. Chassis
New demos
LMS Amesim demo help > Solutions > Off-Highway > Chassis > Tractor
with trailer on uneven soft soil (tractor_soft_soil.ame): the demo purpose
is to model and simulate the interactions of driveline and chassis (weight
transfer) in a realistic environment (soft soil + slopes + bumps + turn).
The tractor has a front oscillating axle and is pulling a trailer, this results
in complex weight transfers that affect available traction. In that context
the limited slip differentials must balance mobility, manoeuvrability, tire
wear…

3.3. Aerospace and Defense
3.3.1. Aircraft
New demos
LMS Amesim demo help > Solutions > Aerospace and Defense >
Aircraft & Space > Hydraulic Systems > Hydraulic and AC Emergency
Power Generation (RATHyd.ame): the demo purpose is to show the
power flow and power transformation from the relative wind power
extracted by the RAT to hydraulic and electrical power.
Aircraft & Space > Hydraulic Systems > Aircraft Hydraulic Network
(HydraulicAircraft.ame): the demo purpose is to perform a high level
power analysis, in order to assess the flow balance between the
hydraulic power generators and consumers.
Aircraft & Space > Environmental Control Systems > Global thermal
management > Thermal cabin modeling: series of demos to assess the
thermal behavior: ECS requirements validation (simple cabin model),
detailed thermal model of the cabin and integration with the ECS (air
conditioning pack).
Aircraft & Space > Electrical Systems > Network > Power Budget:
Twinjet Electrical Network interactive simulation
(ACE_ELECNetworkInteractive.ame): dashboard interactive simulation
to reconfigure and simulate an electrical network in a "pseudo" real-
time way.
Aircraft & Space > Electrical Systems> Network > Power Systems
multiphysics integration (MultiPhysicsNetwork.ame): this demo
interfaces the electrical network with other aircraft subsystems (flight
controls, fuel pumps, ECS) to gather/validate nominal and dynamic
requirements on generators and converters.
Aircraft & Space > Engine Equipment > Burst duct event
(Burst_duct_event.ame): bleed pipe burst: study pressure wave in a
confined space, the nacelle compartment for example, where
equipment must be protected from overpressure.

Aircraft & Space > Satellite propulsion Systems > Satellite propulsion
(Satellite_propulsion.ame): propellant reservoir pressurized with a high
pressure helium tank and associated control.
3.4. Mechanical Industries
3.4.1. Fluids Systems and Components
New demos
LMS Amesim demo help > Solutions > Mechanical Industries > Fluids
Systems and Components > Hydraulic components> Hydraulic vane
pump (VanePump_THH.ame): the demo purpose is to demonstrate the
effect of air dissolution dynamics on a vane pump’s behavior.
3.4.2. Two Phase Flow Systems
New demos
LMS Amesim demo help > Solutions > Mechanical Industries > Two
Phase Flow Systems > Refrigerator freezer with on/off control
(RefrigeratorFreezerWithOnoffControl.ame): the demo purpose is to
show the way to model a refrigerator freezer using an on/off control
command.
Phase Flow Systems > Refrigerator freezer with inverter control
(RefrigeratorFreezerWithInverterControl.ame): the demo purpose is to
show the way to model a refrigerator freezer with an inverter control
command.

Phase Flow Systems > AC with office floor (ACWithOfficeFloor.ame):
the demo purpose is to show the way to model an air conditioning
system connected to an office floor.

4. Platform issues resolved in LMS Amesim 14
If you know of an issue ID that is not listed below, please feel free to contact your local support
office for details about this ID. Contact details are available at:
https://support.industrysoftware.automation.siemens.com/gtac.shtml.
ID Description
8143498 Files and folders with spaces were not supported as text global parameters
Using a real global parameter in the expression of an integer parameter was allowed
8150139
but did not work at simulation time
8170780 The '-axWP' Intel compiler option could generate different results
Performance analyzer was not correctly updated when a simulation was run from
8172210
Amepilot
8174796 The Adams manual specified an unsupported compiler
In the Excel scripting API, the ‘ameputgpar’ script failed if two global parameters had
8178364
very similar names
8187302 The RLM statistics could be wrong for token based licenses
8189058 If a parameter value was empty after a ‘Check submodels’ or a submodel assignment, it
8189210 was not replaced by its default value
8189297 With the Statechart, it was difficult to create transitions between states
8189762 The variable print interval submodel did not work correctly with the standard simulator
The HEAT assistant displayed an error message, in velocity mode, on radiator
8189876
parameter change
8190151 The C API was not working under Red Hat Enterprise 5
8191210 Legend position was not restored correctly when loading saved plot styles
8191580 The open simulator could fail at discontinuity restart with DASSL
A poor message was generated for unknown global paramters with the standard
8191921
simulator
8193879 In the Python scripting API, the ‘amebode’ function always created a plot
8195570 Supercomponent exposed variables could be used in an optimization
8195571 Exposed global parameters were not updated after renaming supercomponents
8195986 Issues could appear in column size of batch dialog boxes when importing batch files
8196442 Wrong unit conversions occurred on FFT plots
8196862 The plot ‘batch’ status was wrongly stored in plot configurations
8197675 A Confusing message could be displayed when compiling encrypted supercomponents
Values displayed in batch run selection dialog boxes did not take unit conversions into
8197892
account
Editing some LMS Ameset source code with an external editor could fail if a submodel
8197948
path contained spaces
8197949 The RLM installation from the LMS Amesim DVD could fail
8198237 The ‘Save next’ option did not work for common parameters
8198482 The contextual help of some submodels was not displayed
8198802 A license error could occur when opening ICAR models using LMS Amerun
8199575 Writing auxiliary files was sometimes not taken into account before saving a model
8199611 Memory limitations existed in the ‘ameloadvarst’ Python script

It was impossible to access results from slaves of a Discrete Partitioning system after
8200186
renaming the master system
When customizing supercomponents, expressions using real global parameters could
8200451
be corrupted
Expressions containing real global parameters could be corrupted when saving a
8200452
supercomponent in a category
8200828 Custom time units were sometimes lost after plot updates
Bode plots could crash when using an observer that was duplicate of a variable of an
8200932
encrypted supercomponent
8174642 Using a file path global text parameter did not work at simulation time if the pointed file
8183984 name contained spaces
8199247
8199304 Default LMS Ameset and LMS Amesim compilers were not synchronized
8199406

5. Known platform bugs
office for details about this ID. Contact details are available at:
https://support.industrysoftware.automation.siemens.com/gtac.shtml.
ID Description
The ‘Check submodels’ blocks when updating dynamic blocks in a local
7282321
supercomponent
Selected states info message is no longer displayed in the Modelica import assistant
7288010
messages window
729105 It is not possible to convert unsaved models to a Native LMS Amesim submodel
7291111 CAD position is wrong in the case of several assembly levels
When putting a Simulink interface block in a supercomponent, the resulting S-function
8140075
makes Matlab crash
8145952 Points after the simulation final time can be printed during simulation
8148193 The solver sometimes fails because of a bad discontinuity handling in some submodels
When using the Simulink Co-Simulation interface, the option to create files for blackbox
8156347
in the ‘File’ menu is still available
8160979 The ‘Discontinuity Printout’ option is always activated with co-simulation using DASSL
There can be a drift of print points when co-simulation interval and LMS Amesim print
8165894
interval are the same
8183393 Discrete Partitioning is not compatible with continuation run
There is no check between the unit of a global parameter and the unit required where
8183987
the global parameter is used
The print interval is not taken into account when a co-simulation model has an implicit
8184038
loop
LMS Motion Co-simulation interface in LMS Amesim: interface blocks cannot handle
8186982
backslashes
8189933 Numerical noise produced when changing equations due to supercomponent creation
8190229 A buffer overflow with 'amefprintf' in Simulink can occur and crash the Matlab GUI
8192267 The ‘ameputp’ Matlab script wrongly considers requests ending with wildcards
Removing submodels in sketch mode does not work for line submodels in the Hydraulic
8193957
Library
It is not possible to run coupled simulation between LMS Amesim and LMS Motion
8196062 when external files are referenced in relative folders of the LMS Amesim working
directory
The Simulink interface manual claims that short names are needed for Matlab, which is
8199274
no longer true
8199963 When a comma is used in a parameter value, it cannot be replaced by a dot character
GUI issues when pasting multiline text into the ‘Add Class’ dialog box of the Modelica
8201041
Editor
8201043 Modelica models can be seen as packages in the Library Tree
8201056 Crashes occur when loading batch files then removing batch sets out of the range set
8256276 The ‘AMEGetCompilers’ API function does not work as expected

6. Known library bugs
office for details about this ID. Contact details are available at www.lmsintl.com/support.
ID Library Description
All units for American System of Unit are not appropriate with respect to
8178060 all
SAE standard.
Stability problems when considering pressure losses in multi-port
8190447 CFD1D
junctions
8170666 CF Bad cam profile can generate NaNs
All the variables of CSDATA000 should be visible whatever the output
8189428 CS
chosen.
8190377 DRV DRVDRV1C does not correctly manage gear ratio.
8156735 ENG There are turbine preprocessing robustness issues.
The display of GM partial pressure and fractions are not consistent when
8198775 GM
fog is considered.
8200350 GM Compilation issue with half heat exchanger depending on user path list.
Interference between the Regulation Tool Apps linked to THPHIREG1
8201295 GM
and all its connected components
Turbine pre processing issues: accuracy may be low and efficiency
8156735 ICE
extrapolation may be improved.
The display of partial pressure and fractions are not consistent when fog
8198775 MA
is considered.
Mass conservation issue in the moist air condensation chamber
8170375 MA
MACND010.
8140956 MEC Under some circumstances, CAM00 can miss some discontinuities.
8171882 PLM PLM assembly can miss some over-constrained configurations.
Pneumatic line PNL00R: add explanations in the documentation about
8157612 PN
the velocity calculation when pressure ratio is close to 1.
PN mixture domain of validity is not given for all the gas properties
8189198 PN
submodels.
8200350 PN Compilation issue with half heat exchanger depending on user path list.
8201295 PN
and all its connected components.
7282406 SIG SIGHULL0 not compatible with 64 bit platforms.
In THGCV2 convective exchange, wrong temperature is used in the
8200286 TH computation of the absolute humidity of moist air leading to inconsistent
warning.
8200350 TH Compilation issue with half heat exchanger depending on user path list.
8201295 TH
In TFPHE** submodels, some numerical noise could appear when
7269049 THH
pressure changes.
8200350 THH Compilation issue with half heat exchanger depending on user path list.
8201295 THH
8193954 TR Planar contact sometimes ignores some contact events

7. Running previous version models on LMS
Amesim 14
Please note that when you open a system created using an old version (prior to LMS Amesim
14), LMS Amesim 14 will detect that it is an old system and lead you through a compulsory
Check submodels. A new executable will be created when you switch to Parameter mode and as
you save it, the whole model will be converted to the LMS Amesim 14 format. If (due to changes
in submodels) there is any doubt about the value of certain parameters, these can be seen in a
special tab (Parameters to check) of the Watch view dock window.
It is important to remember that LMS Amesim 14 models cannot be read by versions of LMS
Amesim earlier than LMS Amesim 14.
8. The LMS Amesim installation instructions

This section contains information necessary to install LMS Amesim, you should read it before
you begin the installation process.
Once LMS Amesim is installed, you must set up its license manager (Reprise License
Manager) in order to be able to start it. For more information, please refer to the section The
License manager installation.
Basic knowledge of the Operating System of your machine is required for the installation but also
and above all for the setup of the license manager. Please ask for the assistance of your local
system administrator if needed.
LMS Amesim is distributed on a DVD. This media contains:
• The LMS Amesim applications set.

• Related utility files, such as the license manager (RLM).
• Any program options, libraries and solutions you purchased.
• Demonstration models and libraries.
• Online documentation in PDF and HTML formats.
• The current document in PDF format.
8.1. Before you start

Before installing LMS Amesim, you must have a valid license file from Siemens. The license file
includes licenses for all the applications and libraries in the LMS Amesim family for which you
are licensed.
In addition to this license file, you must have an activation key to start the setup application. This
activation key is composed of 25 characters.
Both your license file and your activation key are usually supplied by e-mail. If you already have
them, you can proceed with the installation. If you do not have them, please contact your local
Siemens representative (see the Contact section at the beginning of this document).
For any request, please have ready, or include in your e-mail or fax, the following three items:
• Your License Contract Number if you have already used a previous version of LMS
Amesim.
• The hostname and hostid of the server (or servers) on which you will execute the RLM
license manager. For a node-locked license and/or a stand-alone workstation, this is the
hostname and hostid of your workstation. For a floating license, this is your server
hostid(s) and hostname(s), not your client workstation information.

• Your e-mail address.
A utility is provided on your DVD (in the LicensingTools folder) to get the required hostname and
hostid information:
• Under Windows: it is a script called hostids.bat.

• Under Linux: it is an executable called rlmhostid.
Just run this utility on your server(s) and copy the output information into your e-mail message or
fax. Please refer to the section License servers and hostids for more details. Send this data to
your local Siemens office with the signed license agreement.
You will not be able to go through the installation procedure of LMS Amesim
without your activation key.
8.2. Requirements
The LMS Amesim software is ordinarily installed on a single file system. This can be an
individual user's computer in case of a stand-alone workstation, or a central file server for
networked installations.
Multiple different versions of LMS Amesim can be installed on the same server, possibly for
heterogeneous platforms. All of these versions can access the same license file using a common
license server.
All machines that are to use LMS Amesim must be able to access the installation folder (also
known as %AME% or $AME, under Windows or Linux respectively).
If you have an older version of LMS Amesim on your PC and you still want to be
able to use this version, you should install LMS Amesim 14 in a different folder
and use the batch files supplied in the misc subfolder of the installation folder to
run the old version.
8.2.1. Hardware requirements

• Most Intel and compatible processors are supported: Intel Pentium, Intel Core, AMD
Athlon, AMD Opteron…
• The following processors are NOT supported: Intel Itanium 1 and 2.
• Read access memory: 1 GB of RAM is recommended for LMS Amesim only.
• Drive: DVD drive.
• Hard disk space required by the installation:
Platform Disk space required

Windows 2.5 – 7.3 GB
Linux 2.5 – 6.7 GB
All 3.3 – 9.2 GB

8.2.2. Software requirements
8.2.2.1. Windows
To run LMS Amesim on Windows Vista /7/8, you need:
• The LMS Amesim software Suite.

• A Windows ‘Vista/7/8’ Operating System.
• A compiler for LMS Amesim and LMS Ameset: GNU GCC or Microsoft Visual C++
2005 (or higher).
• A properly functioning TCP/IP networking (for floating licenses).
• The RLM license server (supplied with LMS Amesim).
• A PDF reader for the PDF documentation.
Windows 2003 Server has the same compatibility constraints as Windows XP.
Windows 2008 Server has the same compatibility constraints as Windows
Vista.
Windows 2012 Server has the same compatibility constraints as Windows 7
The Microsoft Visual C++ compiler is not supplied on the CD. If you do not want
to use GCC, you have to buy the Microsoft Visual C++ compiler and install it
independently. Express editions of the Microsoft Visual C++ compiler are free.
The license file is not on the DVD, it is specific to each computer. Please refer to the section
Before you start for more details.
8.2.2.2. Linux
The following requirements apply to Linux systems running LMS Amesim:
• The LMS Amesim software Suite.

• A supported version of Linux: Linux x86 / OS 2.6 and libc 2.5.
• An ANSI C compiler for LMS Amesim and LMS Ameset.
• A properly functioning TCP/IP networking (for floating licenses).
• The RLM license server (supplied with LMS Amesim).
• A PDF reader to read the PDF documentation.
LMS Amesim is compatible with other Linux versions: SUSE 10.0, Fedora, RedHat Enterprise
5.0, Ubuntu 8.04, etc. (always require at least a GLIBC 2.5)
In case of compatibility questions with your platforms and/or operating system versions, please
contact your local Siemens Technical Support (see the Contact section at the beginning of this
document).
To use the API in C under Linux, you need a GCC compiler version 4.4.7 or higher.
8.2.2.3. Linux 64 bit versions

As LMS Amesim is not a native 64-bit application, you need to install 32-bit compatibility
packages. In Addition, since LMS Amesim also needs a GCC which includes the support of 32
bits compilation, you also need to install the required packages for GCC 32-bit support before

installing LMS Amesim. Models generated with LMS Amesim can be compiled using a Linux 64-
bit compiler.
Here is the list of packages to install on some Linux distribution:
RedHat EL 6.x 64 bits Ubuntu 14 64 bits

glibc.i686 libc6:i386
zlib.i686 zlib1g:i386
libx11-6:i386
libXrender.i686 libxrender1:i386
libXext.i386 libxext6::i386
libXrandr.i686 libxrandr2:i386
mesa-libGLU.i686 libglu1-mesa:i386
openssl.i686
libgssapi-krb5-2:i386
readline.i686 libreadline5:i386
libncursesw5:i386
xterm.x86_64 xterm
glibc-devel.i686 gcc-multilib
libstdc++-devel.i386 g++-multilib
gcc-c++.x86_64 g++
fontconfig.i686 libfontconfig1 :i386
freetype.i686 libfreetype6 :i386
libpng.i686 libpng12-0 :i386
Other linux distributions mays also require the following packages:

• Openssl-libs.i686
• Libpng.i686 (or libpng12-0:i386)
8.2.3. Mounting the DVD drive (Linux only)

If you do not have a mounted DVD drive yet, mount one with the following procedure.
You can use either a local or remote DVD drive to access the LMS Amesim installation file sets.
The instructions given below are for mounting a local DVD drive; for a remote DVD drive please
ask
for the assistance of your local system administrator. The LMS Amesim DVD is in ISO 9660
format.
1. Log in with the root account and make a DVD drive mount point. For example:
mkdir /dvdrom
2. Then execute the command below to mount the DVD drive on your system where
DVDROMDIR refers to the DVD drive mount point:
mount -t iso9660 -r /dev/dvdrom DVDROMDIR
8.3. The interactive installation procedure

This is the common way to install LMS Amesim, the user is guided through all steps with wizard
pages to configure the installation.
There is also another way for advanced user to install LMS Amesim in silent mode using scripts.
For more details, refer to section The Installation procedure using script.

Under Windows:
1. Log in as Administrator.
2. Place the LMS Amesim DVD into the drive.
3. The auto-run configuration should start the setup automatically and the Welcome page should
appear. If not, start the setup.bat file located in the root folder of the DVD.
Under Linux:
1. Login as root.
2. Place the LMS Amesim DVD into the drive.
3. If necessary, mount the DVD drive on your system as described in section 8.2.3
4. Move to the DVDROMDIR:
cd DVDROMDIR
5. Run the DVD installation script. Use either the upper-case or lower-case version as
appropriate for your platform (do an ls to see the file name on your system):
./INSTALL.SH AMEHOME
The AMEHOME argument is the chosen installation directory (also known as $AME). The
installation script is self-explanatory and will ask for which optional libraries you want to install.
6. If you want to add extra libraries after the initial installation, just re-run the installation
command.
7. Unmount the DVD drive if required:
umount DVDROMDIR
9. Log out.
8.3.1. Starting the LMS Amesim installation procedure
Make sure that there is no anti-virus program running during the installation
process since this, for LMS Amesim (and other software), has proven to result
in a faulty installation. After the installation is complete you should of course turn
on the virus protection again.
8.3.1.1. Welcome
During the LMS Amesim installation, there will be a sequence of dialog boxes displayed; we will
show some of them in this document with some comments on what to choose in each of them.
The default options have been selected so that they suit the majority of installations.
To navigate forwards or backwards in this sequence of dialog boxes, you need to press
respectively the Next or Back buttons (or Cancel if you wish to quit the installation).The first
Welcome dialog box is simply to introduce the LMS Amesim installation.
8.3.1.2. License agreement

The subsequent Software License Agreement window is a reminder of the license agreement
under which LMS Amesim and its supporting software are distributed. Read it carefully and
select Accept the terms of the license agreement if you want to install the software and accept
the agreement.

8.3.1.3. Release information
Two dialog boxes show some information about LMS Amesim and you are invited to specify:
• the user name,

• the company name,
• the activation key (provided with the license file) and
• the license file.
LMS Amesim and its components are protected by a license manager application named RLM,
the installation process will install all the files needed for this tool. However, the license file and
the activation key are provided by Siemens separately.
If you already have the license file, the dialog box asks you to enter the folder where it is stored.
At the end of the installation process, this file will be copied from this folder to the licensing
subfolder of the installation folder.
If you do not have the license file and/or the activation key, please ask your local Siemens
representative to provide you with what you need (see section Before you start).
Figure 1: Customer information of the installation process
Regarding the new license daemon, please refer to section New license daemon for more
information.

8.3.1.4. Predefined installation types
You have the choice between various installation types: Full, Custom, Run, and IFP-C3D.
If you have a license specific for LMS Amerun, select the Run option. If you have an evaluation
license, select Full which gives a full installation. By default you will get a full installation but you
can customize it as you want by selecting Custom.
Figure 2: Setup type
If you selected the Custom installation you get an extra dialog with which you can select which
parts of the product you want to install. There are some dependencies between some features,
not all parts can be installed independently.

8.3.1.5. Installation folder
With the following dialog box you select where you want LMS Amesim to be installed.
Under Windows only, this folder can contain blank characters (such as
C:\Program Files). This is not permitted under Linux.
Figure 3: Setting the destination folder

8.3.1.6. Check list
This is the last step before the installation starts. Look at the settings and make sure that they suit
your needs.
The installation starts when you press the Next button.
Figure 4: Last check before we start
8.3.1.7. Check system settings (Windows only)

A special page for Windows is displayed to show the situation of the installed compilers detected
by the setup and checks on environment variables.
For compilers, we recommend you to use the GNU GCC which is supplied with LMS Amesim. If
the Microsoft Visual C++ compiler is not installed, GNU GCC will be the only one used by LMS
Amesim and LMS Ameset.
If you want to use the LMS Amesim /Simulink interface, you must use Microsoft Visual C++
since GNU GCC is not compatible with Simulink. To use the Microsoft Visual C++ compiler, it
is necessary to buy it and install it independently.
By using LMS Ameset, it is possible to compile submodel code written in Fortran. To compile this
code, you can either use g77 which is supplied with GNU GCC or the Microsoft Visual Fortran
compiler. In this last case, it is necessary to buy it and install it independently.

Figure 5: Installation summary
8.3.1.8. Setting environment variables and shortcuts under

Windows
A few additional settings are required for the Windows environment:
• Specifying which application must be used by default for .ame files
If you have chosen to install both LMS Amesim and LMS Amerun you must specify
which software must be started by default when double-clicking on a model file from the
Windows Explorer. If you plan to use both applications we recommend that you set
LMS Amesim as the default program to launch.
• Adding shortcuts
Shortcuts are added to the Start menu and to the desktop.
• Defining the default working folder
In this dialog box you are asked for a default working folder for LMS Amesim, this will
determine where it will start.
Under Windows only, folder names can contain blank characters (such as
C:\My Work). This is not permitted under Linux.

Figure 6: Settings for Windows environment
8.3.1.9. Setting environment variables under Linux
This crucial part of the installation procedure is specific to Linux versions of

LMS Amesim.
In order to run any applications of the LMS Amesim suite under Linux, you
need to define an environment variable named AME and set it to the LMS
Amesim installation directory.
You also need to add the $AME environment variable to your command search
path. The following instructions explain how to get this done automatically each
time you log in to your machine.
1- If you use the C shell
You may put the following two lines in your .cshrc file which is in your home directory:
setenv AME AMEHOME

set path=($AME $path)
Replace AMEHOME by the name of the LMS Amesim installation directory and check these two
lines are placed after any other set path command lines in the file.
2- If you use the Bourne shell
You may put the following lines in your .profile file which is in your home directory:
AME=AMEHOME
export AME

PATH=$AME:$PATH
export PATH
Replace AMEHOME by the name of the LMS Amesim installation directory and check these four
lines are placed after any other set path command lines in the file.
Once you have modified your .cshrc or .profile file, you have to log out and log in again so that
the changes take effect. If you use the C shell, you can run the following command from a
terminal window to avoid the login/logout process:
source ~/.cshrc
When these environment variables are set properly, the LMS Amesim applications can be
started by typing LMS Amesim, LMS Ameset, LMS Amecustom… as appropriate.
8.3.2. Installing the LMS Imagine.Lab SysdmTM software client

At this stage, the installation of LMS Amesim is finished but you can continue with the installation
of the LMS Imagine.Lab Sysdm Client application (LMS Sysdm) if you need it and if you have a
license for it.
Once you have installed LMS Amesim we recommend that you do not modify
your installation manually (adding or removing files), otherwise we cannot
guarantee that the application will function correctly. Moreover, any hotfix
installations will be rendered impossible by such modifications.
LMS Sysdm is a model management tool supplied with LMS Amesim. If you
have the necessary license, you can install its Client version.
Once the setup wizard finishes installing LMS Amesim, the following message appears:
Figure 7: LMS Sysdm Client installation message
You can click the Get more info button to learn more about the capabilities LMS
Sysdm.
You can click the Help button to launch the LMS Sysdm Client Installation guide
(which can be found in the third_party/sysdm folder of the installation media).

8.4. The Installation procedure using scripts
LMS Amesim can be installed using a script to avoid any interactions with the user (silent mode).
This is particularly interesting for network installations. To start this type of installation, it is
necessary to prepare a configuration file containing options for the installation.
On the LMS Amesim DVD, there is an example of this file called install_config.dat
USER_NAME=user_name_of_the_owner
COMPANY_NAME=Siemens Industry Software
CD_KEY=replace_this_label_with_your_activation_key
SETUP_TYPE=Full
DESTINATION_DIRECTORY=E:\AMESim
WORKING_DIRECTORY=E:\AMETest
PLATFORM=windows
FILE_ASSOCIATION_TO_AMESIM=yes
SHORTCUT_ON_DESKTOP=yes
SHORTCUT_IN_START_MENU=yes
This is an example for Windows. For Linux, keywords FILE_ASSOCIATION,

SHORTCUT_ON_DESKTOP and SHORTCUT_IN_START_MENU should be removed.
Some information about each keyword:
USER_NAME: user name
COMPANY_NAME: name of the company
CD_KEY: activation key to activate the installation
SETUP_TYPE: setup type like Full, Run and others special setup types. Custom type is not
configurable for scriptable installation
DESTINATION_DIRECTORY: full path for the location of the LMS Amesim installation
folder
WORKING_DIRECTORY: default working folder
PLATFORM: define the platform(s) to install: windows, linux
For Windows only:
FILE_ASSOCIATION_TO_AMESIM: to associate .ame files to the LMS Amesim products

(Open, Explode and Purge actions)
SHORTCUT_ON_DESKTOP: add a shortcut on the desktop to start LMS Amesim
SHORTCUT_IN_START_MENU: add shortcuts into the Start menu to start main

applications, documentation and the license administration tools
To start the installation, the following command must be executed:
Under Windows:
setup –s name_of_config_file
Under Linux:
INSTALL.sh –s name_of_config_file
An example of installation script for Windows is provided on the DVD: install_script.bat.

9. Uninstalling LMS Amesim 14
Before uninstalling LMS Amesim, you must first:
• Log in as Administrator or root as required.

• Stop any LMS Amesim application currently running.
• Stop the RLM server if it is running locally.
• Stop your antivirus.
To uninstall LMS Amesim, use one of the following procedures:
Under Windows:
• Select the Uninstall shortcut in the LMS Amesim entry of the Start menu.
• Use the uninstall.bat file located in %AME%.
• Start the setup.bat file on the installation DVD.
Under Linux:
• Use the AMEUninstall.sh script located in $AME.
When you launch the uninstallation facility from the DVD under Windows, you obtain the dialog
box shown below. Select the Uninstall option and click the Next button.
Figure 8: Uninstalling LMS Amesim – Setup Wizard (from DVD)

When you use the shortcut in the Start menu, the uninstall.bat or the AMEUninstall.sh script
under Linux, the following dialog box appears:
Figure 9: Checking the version to uninstall
If you want to uninstall a different version of LMS Amesim, you can click the Change location
button, and then browse to select the version you want to uninstall.
10. The license manager installation instructions

The software which controls LMS Amesim 14 licenses is named Reprise License Manager
(RLM); it uses a license file which identifies the host machine and the expiry date of each feature
available. LMS Amesim is supplied with its own version of RLM. It is not recommended to use a
different version.
10.1. The new license file

Together with the new license manager (RLM), license files of a new format
(LMS_HOSTNAME_HOSTID.lic) are supplied with LMS Amesim 14. These new license files
replace the previous license files used so far (license.dat and LMS_INTL.lic).
In order to use LMS Amesim 14, you must ask for a new license file since
license files in older formats are not compatible (Rev 11 SL1 and below).
To use LMS Amesim 14, you must have a valid license file named
LMS_HOSTNAME_HOSTID.lic from Siemens, see section Before you start for more details. This
license file includes all the features you are allowed to use.

10.2. The new license daemon
Together with the new license manager (RLM), a new licensing daemon (LMS) is supplied with
LMS Amesim 14 which replaces the previous daemons used so far (AMED and LMS_INTL).
This new daemon is installed by default with LMS Amesim 14 and it is the only one required if
you do not need to use previous versions of LMS Amesim at the same time (only the 14 version
will be used). In this case, just run the default installation: the new daemon (LMS) and license file
(LMS.lic) will be used.
If you plan to continue using previous versions of LMS Amesim (Rev 11 SL1 and below) along
side LMS Amesim Rev11 SL2, then two license servers with two different license files will be
required:
• The new daemon (LMS) and license file (LMS.lic) will be used by LMS Amesim 14.
• The old daemons (AMED or LMS_INTL) and license files (license.dat or LMS_INTL.lic)
will be used by previous versions.
10.3. RLM setup

You must first have received a license file from your local Siemens office; this file must be
renamed as LMS.lic and copied into the licensing subfolder of the LMS Amesim installation.
LMS Amesim is licensed on a per-computer or a per-user basis. Depending on the type of

license you have, there are two possibilities:
1. You have a node-locked license (no access to a license server):
• RLM must be configured locally on your machine (see instructions below)
2. You have a floating license (access to a license server):
• On the server specified in the license file: RLM must be installed and configured (see
instructions below).
• On every client machine accessing the server: no installation or configuration of RLM is
required, only a copy of the license file (renamed as LMS.lic) is required in the licensing
subfolder of the LMS Amesim installation. Alternatively the LMS_LICENSE environment
variable can be used in this case, please refer to the section LMS_LICENSE
environment variable for more information.
Under Windows:
To install the license manager, you must run the RLMLicenseServer.exe utility which is located in
the %AME%\licensing\install folder. The Welcome screen for installing RLM
appears.
You just need to click Next and the Destination Folder Location screen opens.

Figure 10: Installation folder
A default destination path is filled in. If there is a need to, it can be changed. The path in the
picture might be different depending on the operating system you are working on.
Click Next to open the License File Location screen.

Figure 11: License file
With the upper part of this dialog box, you have the ability to select the license file that will be
used by the license server. The installer will copy the license file to the location specified in the
lower field of the dialog box.
The destination folder of the license file can be set with two possible options:
• The default place to store the license file is the folder {Common application
data}/LMS/Licensing. The folder {Common application data} can be different depending
on the OS. On Windows 7, the license file will be stored in the folder
C:\ProgramData\LMS\Licensing. On Windows XP this will be C:\Documents and
Settings\All Users\Application Data\LMS\Licensing.
• Alternatively, you can override the default place, and browse to any other existing
folders.
If you have no license file yet, you can leave the input field for the license file
blank. The installer will point to the selected destination folder and once you
retrieve the license file, you can copy it into this folder manually. To easily
retrieve this folder, the installer creates a shortcut to access it from the Start >
LMS RLM 9.3.0 License Server >Tools >LMS license folder menu.
Click Next to continue, this opens the Options screen.

Figure 12: Options
From the RLM web-interface or from command lines (see License management for more details),
it is possible to shut down the license server. The check box can be selected to disable this
possibility.
You can also define the places where the log files of both the server (rlm.exe) and the daemon
(LMS.exe) are stored.
Click Next to continue, this opens the Dongle driver screen.

Figure 13: Dongle driver
Selecting the check box will launch the FLEXNet installation package for dongles. With this, you
will have support for recent dongles. Although the installation is based on RLM, we keep
supporting FLEXNet dongles.
Click Next to continue, this opens the Firewall settings screen.

Figure 14: Firewall
Selecting the check box will alter the firewall settings on your computer. The daemon will be
allowed to pass the firewall for domain, home/work and public.
Click Next to continue, this opens the Ready to install screen.

Figure 15: Installation
Click Install to start the installation. A status screen shows progress of the installation process. At
the end of the process, you will see a screen indicating that the installation is complete. Click
Finish to complete the license server installation. You do not need to reboot your machine.
Under Linux:
Please note that dongles are not supported under Linux.
Before you can start any LMS Amesim application, you must place a copy of the license file
(renamed as LMS.lic) in the licensing subfolder of the LMS Amesim installation, and the license
manager daemon must be started by the command:
lmstart
The lmstart script is in the $AME/licensing directory. You can check the
$AME/licensing/lmslm_hostname.log file to check that the license server is running correctly.
There is no part of RLM, vendor daemon or application that requires root

permissions. In fact, it is recommended that you do NOT run the license server
(rlm) as root, since root processes can introduce security risks. If rlm is started
as root, as in a system boot script, it is recommended that you use the /bin/su
command to run rlm as a non-privileged user. You will have to ensure that the
vendor daemons listed in the license file have execute permissions for the
username. The path to the vendor daemon in the license file is listed on the ISV
line.
To ensure that the license manager daemon starts at boot time, add the following startup
command to a boot script on your system as described hereafter (as one line):

/bin/su username -c “umask 022; AMEHOME/licensing/lnx/rlm -c
AMEHOME/licensing/LMS.lic -l AMEHOME/licensing/amelm.log”
where username is a non-privileged user and AMEHOME the LMS Amesim installation directory.
11. License management

LMS Amesim uses the RLM license manager from Reprise Software to manage the per-
computer or per-user licensing. RLM daemons must be running on a server node in order to run
an LMS Amesim product. All the files required to run RLM are supplied in the:
• %AME%\licensing folder for Windows

• $AME/licensing directory for Linux
where %AME% (resp. $AME) is the LMS Amesim installation folder.
This includes:
• the RLM license file (LMS.lic),

• the RLM daemon (rlm),
• the LMS Amesim daemon (LMS)
• and a set of RLM utilities.
This section is intended to give the system administrator a general overview of RLM and how
licenses are managed.
The complete RLM End-User Manual is provided in the

'%AME%\licensing\EndUser\ RLM_Enduser.htm' (resp.
'$AME/licensing/EndUser/ RLM_Enduser.htm') file. You will find the answers of
all your questions about RLM in this documentation.
11.1. License servers and hostids

Before running any RLM licensed program using node-locked or floating licenses, you must set
up your license server node (or nodes). Select which node or nodes to run your license servers
on, and provide the hostname and hostid of those machines to your local Siemens office, so that
we can generate your license file(s).
• Under Windows: On the LMS Amesim DVD there is a folder named LicensingTools
that contains a command file named hostids.bat and two executables called
rlmhostid.exe and lmshostid.exe. Copy these files to a temporary folder and execute
the command hostids.bat. This command will create a file named hostids.txt which will
contain the data used for establishing the license file.
• Under Linux: On the LMS Amesim DVD there is a directory named LicensingTools/lnx
that contains an executable named rlmhostid. Copy this file to a temporary directory
and execute it: this command will display the data used for establishing the license file.

11.2. Understanding the license file
The license file (LMS.lic) contains configuration information:
• A HOST line which specifies the license server daemon.

• A ISV line which specifies the vendor daemon.
• A series of LICENSE lines, which define your licenses for the LMS Amesim products,
optional libraries and tools you purchased.
Any time you make changes to the license file, you must reread the license file
or restart the license daemons by running lmstop and then lmstart. These utilities
are available in the licensing folder of LMS Amesim. Alternatively, the web-
server application can be used. For more information, please refer to the section
License administration tools.
For a complete description of the license file, please refer to the License File section of the RLM
End-User Manual (RLM_Enduser.htm) which lives in the EndUser subfolder of the LMS Amesim
licensing folder.
11.3. LMS_LICENSE environment variable

By default, LMS Amesim will use the information from the license file (named LMS.lic) located in
the licensing subfolder of its installation folder. However, you can set an environment variable to
specify one or several license file(s) or host name(s). For the LMS daemon, this variable must be
named LMS _LICENSE, and it can be set to the following values:
• A list of full paths to license files (including the name of the license files), these are separated
by a colon ( : ) on Linux or a semicolon ( ; ) on Windows.
• A list of port@host where port and host are the TCP/IP port number and the host name from
the HOST line in the license file. Alternatively, use the shortcut specification, @host, if the
license file HOST line uses the default TCP/IP port (5053). A list of several port@host can be
used for a server redundant configuration. For example:
port1@host1: port2@host2
or
port1@host1; port2@host2
You can create a list containing both port@host and full license path files.
When several license files or hostnames are set, LMS Amesim licenses are first taken from the
first license or hostname of the list.
11.4. License administration tools

RLM also provides tools to manage the administration of the license server:
• There is a built-in web-server application to monitor the activity and manage the license
server.
• There are command line utilities such as rlmutil which provide the same facility as the
web-server, but from a command prompt/terminal window.
• There is a built-in diagnostics tool which generates reports with all information regarding
the license server: version information, license file, relevant environment variables,
debug log… This will be the first source of information for troubleshooting.

For a complete description of the license administration tools, please refer to the License
Administration Tools section of the RLM End-User Manual (RLM_Enduser.htm) which lives in the
EndUser subfolder of the LMS Amesim licensing folder.
11.5. Creating a local options file

You can instruct the RLM license manager to:
• Reserve one or more licenses for a user, group of users, or host.

• Reserve one or more licenses for users or groups logging in from a specific host.
• Specify the users, groups of users, or hosts that have permission to access one or more
products.
• Etc.
The licensing folder contains a template (named lms.opt) which contains the
following command:
TIMEOUTALL 900
All options files must contain at least this command.
To use these options, you or your users can create local options files. For a complete description
of the options files, please refer to the RLM Options File and ISV Options File sections of the
RLM End-User Manual (RLM_Enduser.htm) which lives in the EndUser subfolder of the LMS
Amesim licensing folder.
11.6. Dongle configuration
Please note that dongles are not supported under Linux.
In order to use a dongle-based license, the following procedure must be used:

1. Install the dongle driver. The driver can be found in the following locations:
• On the DVD in LicensingTools\install\FLEXId_Dongle_Driver_Installer.exe
• In the LMS Amesim installation directory:
%AME%\licensing\install\FLEXId_Dongle_Driver_Installer.exe
2. Connect the dongle.
3. Configure your license as described previously.
12. Compiler setup

LMS Amesim and LMS Ameset need to use a compiler to build model executables or submodel
objects.
LMS Amesim is only able to generate C code and consequently only needs a C compiler.
LMS Ameset can, in addition, manage also Fortran code for submodels.
While using LMS Amesim and LMS Ameset, you can choose the compiler you want to use from
the Preferences dialog box.

• You can get the Visual Express compiler from Microsoft.
• You can get the Intel compiler from Intel
12.1. Windows (32 bits)

On Windows 32 bits, we can manage following compilers:
• GNU GCC,
• Microsoft Visual C ++,
• Intel C.
If you plan to use only the GNU GCC compiler, no other configuration is needed since it is
provided in the LMS Amesim distribution.
For the other compilers, if the compiler is installed after the installation of LMS
Amesim, additional setup is needed as described below.
12.1.1. Microsoft Visual C++

Copy a command file called vcvars32.bat from the Microsoft Visual C++ installation folder to the
LMS Amesim folder. You can normally find this file in the folder where Microsoft Developer
Studio is installed (C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\bin for instance).
This will take care of the environment variables required by the Microsoft Visual C++ compiler.
In order to use the Simulink interface, you must install Microsoft Visual C++
since the GNU GCC compiler is not compatible with Simulink.
12.1.2. Intel C compiler 10.0 (32 bits)
A similar procedure must be applied with the iclvars.bat command file located by default in the
C:\Program Files (x86)\Intel\Compiler\C++\10.0.027\IA32\Bin\ folder.
12.1.3. Intel Visual Fortran

A similar procedure must be applied with the ifortvars.bat command file located by default in
C:\Program Files (x86)\Intel\Compiler\Fortran\10.0.027\IA32\Bin folder.
12.2. Windows (64 bits)

A similar procedure must be applied with the vcvarsamd64.bat command file located in the folder
where Microsoft Visual Studio is installed (for instance C:\Program Files\Microsoft Visual
Studio\Setup\VC\bin\amd64).
The 64 bit compiler may not be included in Express editions of Microsoft

Visual C++.

12.3. Linux
You must check whether you have access to a C compiler and optionally a Fortran compiler.
When you type:
which cc
or
which gcc
you should see the full path name of the executable cc (or gcc). Otherwise, you need to include
the path for the C compiler in your .cshrc or.profile file. The same applies to the Fortran compiler
with f77 or g77.

13. Current platform support
Below, you will find the list of platforms with their Operating Systems supported by LMS
Imagine.Lab Amesim for current versions.
LMS Amesim product releases are available and supported on this platform. You can get
technical support for this platform through the standard support mechanisms.
LMS Amesim product releases are available on this platform but no technical support is
officially available.
New LMS Amesim product releases are no longer available on this platform. Technical
support will be provided as defined in the maintenance contract, depending on version used
and current version.
Nov. 2011 Mar. 2013 Nov. 2013 Feb. 2015

Platform/LMS Amesim Rev 11 Rev 12 Rev 13 14
version
Windows 32 bits
Windows 7
Windows XP
Windows Vista
Windows 8
Nov. 2011 Mar. 2013 Nov. 2013 Feb. 2015

version
Windows 64 bits
Windows 7
Windows XP
Windows Vista
Windows 8
Nov. 2011 Mar. 2013 Nov. 2013 Feb. 2015

version
Linux x86 (32 bits)
Kernel 2.6
Nov. 2011 Mar. 2013 Nov. 2013 Feb. 2015

version
Linux x86_64 (64 bits)
Kernel 2.6
LMS Amesim is not a native 64-bit application, but can be run with 32-bit
compatibility packages.
Models generated with LMS Amesim can be compiled using a Linux 64-bit compiler.

© 2015 Siemens Product Lifecycle Management Software Inc.
Siemens and the Siemens logo are registered trademarks of Siemens AG.
LMS, LMS Imagine.Lab, LMS Imagine.Lab Amesim, LMS Virtual.Lab,
LMS Samtech, LMS Samtech Caesam, LMS Samtech Samcef, LMS Test.Lab,
LMS Soundbrush, LMS Smart, and LMS SCADAS are trademarks or
registered trademarks of Siemens Industry Software NV or any of its
affiliates. All other trademarks, registered trademarks or service marks
belong to their respective holders.
Siemens Industry Software NV

Researchpark Haasrode 1237
Interleuvenlaan 68
3001 Leuven
Belgium
+32 16 384 200
www.siemens.com/plm/lms

ReleaseNotes Rev14

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

ReleaseNotes Rev14

Uploaded by

Copyright:

Available Formats

LMS Imagine.

Highlights & Installation Manual

www.siemens.com/plm/lms Web site

https://support.industrysoftware.automation.siemens.com/gtac.shtml Technical support

See here for e-mail addresses for your local office:

Siemens Industry Software S.A.S.

LMS Imagine.Lab Amesim® User’s Guides

© 2015 Siemens Industry Software NV

1. LMS Imagine.Lab AmesimTM software 14 new features ........................................ 6

Highlights and installation manual 3/89

2. Library upgrades .................................................................................................... 22

3. Solution upgrades .................................................................................................. 49

4. Platform issues resolved in LMS Amesim 14 ...................................................... 58

5. Known platform bugs ............................................................................................ 60

Highlights and installation manual 4/89

7. Running previous version models on LMS Amesim 14 ...................................... 62

8. The LMS Amesim installation instructions .......................................................... 62

9. Uninstalling LMS Amesim 14 ................................................................................ 75

10. The license manager installation instructions................................................... 76

11. License management ........................................................................................... 84

12. Compiler setup ..................................................................................................... 86

13. Current platform support ..................................................................................... 89

Highlights and installation manual 5/89

1.1. Platform Facilities

1.1.1. Data Import

1.1.2. Global Parameter Enhancements

1.1.3. Algebraic Loop Highlighting

Highlights and installation manual 6/89

1.1.5. Statechart Designer Enhancements

1.1.6. GUI Performances for Huge Models with Supercomponents

Highlights and installation manual 7/89

1.2. Analysis Tools

1.2.1. Table Editor Filtering & Stairs Interpolation

1.2.2. Table Editor Enhancements

Highlights and installation manual 8/89

1.2.4. Plot Order Tracking

1.2.5. AMETrack Enhancements

Highlights and installation manual 9/89

1.2.7. 3D Animation Enhancements

3D Animation now provides fast 3D object

1.2.8. 2D Dashboard Stateless Buttons

Highlights and installation manual 10/89

1.3.1. Design Exploration APIs

1.4. Interactive help

1.4.1. Amehelp Full Text Search by Category

1.4.2. Welcome Page

Highlights and installation manual 11/89

1.4.4. More Platform Manuals

1.4.5. More Platform Demos

Highlights and installation manual 12/89

1.5. Simulator Scripting

1.5.1. Global Parameters API

1.6. Amesim Customization

1.6.1. App Designer Enhancements

Highlights and installation manual 13/89

1.6.3. Extended Plots APIs

1.6.4. Pie Chart APIs

Highlights and installation manual 14/89

1.7.1. Ameset Compiler Settings

1.8. Solvers and Numerics

1.8.1. Automated Linearization to get Maximal Frequencies

1.8.2. Performance Analyzer Enhancements

Highlights and installation manual 15/89