Professional Documents
Culture Documents
Release Guide
Corporate Europe, Middle East, Africa
MSC Software Corporation MSC Software GmbH
4675 MacArthur Court, Suite 900 Am Moosfeld 13
Newport Beach, CA 92660 81829 Munich, Germany
Telephone: (714) 540-8900 Telephone: (49) 89 431 98 70
Toll Free Number: 1 855 672 7638 Email: europe@mscsoftware.com
Email: americas.contact@mscsoftware.com
Japan Asia-Pacific
MSC Software Japan Ltd. MSC Software (S) Pte. Ltd.
Shinjuku First West 8F 100 Beach Road
23-7 Nishi Shinjuku #16-05 Shaw Tower
1-Chome, Shinjuku-Ku Singapore 189702
Tokyo 160-0023, JAPAN Telephone: 65-6272-0082
Telephone: (81) (3)-6911-1200 Email: APAC.Contact@mscsoftware.com
Email: MSCJ.Market@mscsoftware.com
Worldwide Web
www.mscsoftware.com
Disclaimer
This documentation, as well as the software described in it, is furnished under license and may be used only in
accordance with the terms of such license.
MSC Software Corporation reserves the right to make changes in specifications and other information contained
in this document without prior notice.
The concepts, methods, and examples presented in this text are for illustrative and educational purposes only,
and are not intended to be exhaustive or to apply to any particular engineering problem or design. MSC Software
Corporation assumes no liability or responsibility to any person or company for direct or indirect damages resulting
from the use of any information contained herein.
User Documentation: Copyright 2017 MSC Software Corporation. Printed in U.S.A. All Rights Reserved.
This notice shall be marked on any reproduction of this documentation, in whole or in part. Any reproduction or
distribution of this document, in whole or in part, without the prior written consent of MSC Software Corporation is
prohibited.
This software may contain certain third-party software that is protected by copyright and licensed from MSC
Software suppliers. Additional terms and conditions and/or notices may apply for certain third party software. Such
additional third party software terms and conditions and/or notices may be set forth in documentation and/or at
http://www.mscsoftware.com/thirdpartysoftware (or successor website designated by MSC from time to time).
Portions of this software are owned by Siemens Product Lifecycle Management, Inc. Copyright 2013. Portions
1998
The MSC Software logo, MSC, MSC Adams, MD Adams, and Adams are trademarks or registered trademarks of
MSC Software Corporation and/or its subsidiaries in the United States and other countries. FLEXlm and FlexNet
Publisher are trademarks or registered trademarks of Flexera Software. Parasolid is a registered trademark of
Siemens Product Lifecycle Management, Inc. All other trademarks are the property of their respective owners.
ADAM:V2017.1:Z:Z:Z:DC-REL-PDF
Contents
Adams 2017.1 Release Guide
Preface
Welcome to Adams 2017.1 viii
Technical Support x
Web x
Phone and Email x
Training x
1 Whats New
Whats New 2
General 3
Last Release for Python 2 3
Issues Resolved 3
Adams Car 4
Issues Resolved 4
Known Issues 7
Adams Car-AT 8
Issues Resolved 8
Adams Car-Ride 9
Issues Resolved 9
Adams Chassis 10
Issues Resolved 10
Known Issues 10
Adams Controls 11
Direct Communication Mode for FMI Co-simulation 11
CONTENTS iv
Adams Driveline 15
Issues Resolved 15
Adams Durability 16
Issues Resolved 16
Adams Explore 17
Issues Resolved 17
Known Issues 17
Adams Flex 18
Issues Resolved 18
Adams Insight 19
Known Issues 19
Adams Machinery 20
Issues Resolved 20
Known Issues 21
Adams MaxFlex 23
Issues Resolved 23
Known Issues 23
Adams Mechatronics 25
Direct Communication Mode for FMI Co-simulation 25
FMU Export for SIMulation Workbench 26
Heterogeneous FMU Export 26
Forward Compatible FMU 26
SMP Support for Co-simulation FMU 26
Issues Resolved 27
Adams PostProcessor 28
Plot Panning Improvements 28
Issues Resolved 28
CONTENTS v
Known Issues 30
Adams SmartDriver 36
Issues Resolved 36
Adams Solver 37
Fixed Step Integrator Option 37
Issues Resolved 39
Known Issues 40
Adams Tire 41
Local Tire Solver 41
High Performance Setting Management 42
Issues Resolved 43
Adams Vibration 44
Issues Resolved 44
Known Issues 44
Adams View 45
Last Release for Precision Shaded and Z Short Shaded Render Options 45
Issues Resolved 45
Known Issues 47
Setting Preferences 57
Setting Preferences on LINUX 57
Setting Preferences on Windows 57
3 Getting Help
Tool Tips 60
Online Help 61
Versions of Web Browsers 61
Accessing the Online Help 62
Searching 63
Printing 64
Index 64
Preface
Welcome to Adams 2017.1
About MSC Software
Technical Support
Internet Resources
viii Adams 2017.1 Release Guide
Welcome to Adams 2017.1
Overview
MSC Software Corporation is the leading global provider of virtual product development (VPD) tools,
including simulation software and professional services. MSC Software helps companies make money,
save time, and reduce costs associated with designing, testing, producing, and supporting manufactured
products.
MSC Software works with thousands of companies worldwide, in hundreds of industries, to develop
better products faster by using information technology, software, and services to enhance and automate
the product design and manufacturing process. Simulating your product performance reduces
development costs, time to market, and warranty costs.
Technical Support
For help with installing or using an MSC Software product, contact MSC technical support. Our technical
support provides technical assistance on questions related to installation and use of the software. For
further details please see the Technical Support Usage Guide, which is accessible via our support web
site.
You can reach MSC technical support on the web, by telephone, or e-mail.
Web
Go to the MSC Software web site at www.mscsoftware.com, and click on Services -> Technical
Support. Here, you can find a wide variety of support resources including Product Updates, Discussions,
Technical Articles, and Documentation updates.
In addition, we provide several excellent sources of online information:
SimCompanion - Find solutions to problems in this repository of troubleshooting tips,
examples, and frequently asked questions. To access the SimCompanion, go to:
http://simcompanion.mscsoftware.com
VPD Community - The VPD community is where to go when you are looking for peer support,
as well as technical expertise. Many of our consultants, developers, and technical support staff
monitor the forums. To sign up for the forums, go to:
http://forums.mscsoftware.com
Then:
To view the Adams discussions, select Adams.
To view product alerts and company news and events, select MSC News.
Training
MSC Software training provides comprehensive training in Virtual Product Development. We offer
standard and customized training courses in the application of CAE tools to solve from basic to complex
problems within any industry. We offer over 100 courses in our state-of-the-art classroom facilities and
individual computer graphics laboratories at training centers throughout the world. All of our courses
emphasize hands-on computer laboratory work to facilitate skills development. We are uniquely
positioned to optimize your investment in design and simulation software tools.
xi
Preface
Our industry experienced expert staff is available to customize our course offerings to meet your unique
training requirements. For the most effective training, we also offer many of our courses at our
customer's facilities.
We specialize in customized training based on our evaluation of your design and simulation processes,
which yields courses that are geared to your business. In addition to traditional instructor-led classes, we
also offer video courses, interactive multimedia training, web-based training, and a specialized
instructor's program.
Internet Resources
MSC Software (www.mscsoftware.com)
MSC Software corporate site with information on the latest events, products and services for the
CAD/CAE/CAM marketplace.
Whats New
The following are highlights of additions to existing products. Subsequent updates to the Known Issues
and Resolved Issues lists may be found in the MSC SimCompanion articles linked above.
General, 3
Adams Car, 4
Adams Car-AT, 8
Adams Car-Ride, 9
Adams Chassis, 10
Adams Controls, 11
Adams Co-simulation Interface, 14
Adams Driveline, 15
Adams Durability, 16
Adams Explore, 17
Adams Flex, 18
Adams Insight, 19
Adams Machinery, 20
Adams MaxFlex, 23
Adams Mechatronics, 25
Adams PostProcessor, 28
Adams Real Time, 31
Adams SmartDriver, 36
Adams Solver, 37
Adams Tire, 41
Adams Vibration, 44
Adams View, 45
CHAPTER 1 3
Whats New
General
Last Release for Python 2
Issues Resolved
Issues Resolved
ADMS-28431 Adams2015.1 Install guide under "Licensing on Linux" topic one of the
weblink is not working (pdf page no. 56)
ADMS-38997 Incorrect graphcis requiremets listed in Adams 2017 installation guide
4 Adams 2017.1 Release Guide
Adams Car
Adams Car
Issues Resolved
Known Issues
Issues Resolved
ADMS-37422 Dialog box help (F1 Help) not working for ACar Actuation Input Files
dialogs
ADMS-38822 typo in the help doc (Add testrig)
ADMS-38825 typo in the help doc (Modify Adjustable forcce)
ADMS-38768 SPMM analysis has an error with an instant axis model(multi link
suspension.)
ADMS-27430 Both rack motion and steering wheel motion are active during statics when
tra steering is used
ADMS-38661 Adams Car session crash while modifying Curve Manager Points value
(from default to 1)
ADMS-39371 F1 help and general help document not available for Create BSpline
Geometry dbox in ACar
ADMS-33961 Problem with the event builder dialog box, the relative option is greyed out
ADMS-34788 Adams/Car contact UDE creation dialog must contain the option to refer to
I and J- solids internal to the template or otherwise update the
documentation
ADMS-35807 While modifying the shape of "Nonlinear Beam-FE part" behaviour is not
proper in Adams Car
ADMS-35788 Error message appears when try to modify the FE part centerline to new
outline in Adams Car
ADMS-35790 Warning message of deleting the shell geometry appears while creating the
Nonlinear Beam with FE part method in Adams Car
ADMS-39042 Unable to Create an Adams User Library on Linux Using a DOS Created
List File.
ADMS-38533 Getting an error message while selecting request from database navigator
in Request Map Editor dialogbox
ADMS-38917 Actuator Table is grayed out and rows have different heights by default
ADMS-37206 Switch Part modify generate an error message when a rigid body is
switched to flexible
ADMS-35825 Spline Checker: Backup Property Files option cannot retain the original file
ADMS-37733 ARB is not properly migrated while opening chassis model into Adams Car
ADMS-37057 Cannot create leaf spring properly when shackle location is selected as
front
ADMS-24618 Difference in shackle length for leaf spring
ADMS-24154 Error while creating auxiliary leaf spring in Adams Car
ADMS-36776 Airspring drive axle from demo truck database fails for suspension analysis
Known Issues
ADMS-24253 Name of the Filter is also added to Group if user creates a Group by using
'Add to Group' option (Template Builder Mode)
ADMS-24971 Fit View is unsupported for the standalone OGL animation view in Adams
PostProcessor
8 Adams 2017.1 Release Guide
Adams Car-AT
Adams Car-AT
Issues Resolved
ADMS-35869 errors submitting file driven event with output prefix left empty
ADMS-39173 additional measures from compliance matrix method do not show up in
PPT
ADMS-14165 Error occurs while selecting postprocessing type - Test Suite for Static
Aligning Torque in Vehicle.asy
CHAPTER 1 9
Whats New
Adams Car-Ride
Issues Resolved
ADMS-36923 Request Map editor dosent work correctly when General Bushing is used
ADMS-37453 Problem with Initial jerk on Four poster when the Road is modeled using
table function
10 Adams 2017.1 Release Guide
Adams Chassis
Adams Chassis
Issues Resolved
Known Issues
Issues Resolved
Known Issues
ADMS-21716 Flex Generation event does not work with rear twist beam
CHAPTER 1 11
Whats New
Adams Controls
Direct Communication Mode for FMI Co-simulation
FMU Export for SIMulation Workbench
Heterogeneous FMU Export
Forward Compatible FMU
SMP Support for Co-simulation FMU
Issues Resolved
Known Issues
With this release of Adams a new "Direct" communication option for FMI-based co-simulation has been
implemented. This option is meant to improve the communication performance between the FMU
master and slave during co-simulation. It is accessed from the Adams Controls Plant Export dialog and
is available only for Adams co-simulation with a master process based in another FMI-compliant tool.
It does not support any Adams-as-the-master co-simulation scenarios. And, it is restricted to use with
Adams Solver C++ (it does not support Adams Solver FORTRAN).
Previously existing FMI co-simulation communication modes continue to be supported. The table below
compares these three options.
Communication
Mode Adams Master FMI Master Speed
TCP/IP X X lower
Pipes X X medium
Direct X high
12 Adams 2017.1 Release Guide
Adams Controls
See the "Real Time Analysis with SIMulation Workbench" entry under the Adams Real Time section of
this document for further details on these kinds of analyses.
Issues Resolved
ADMS-39466 Docs keyword search: "debug controls" not matching obvious things
ADMS-37959 Adams crashes when importing dll created using simulink model having
parameters defined using multi-level structures
ADMS-38635 Session will crash trying to run interactive simulation on model ion which
one imported Easy5 generated dll without using any input and output signal
ADMS-38086 Adams Car model FMU contains references to tire using database alias in
ADM file packaged a resourses
ADMS-37324 mnf files are included in the FMU when doing a plant export FMU
ADMS-38515 Changing value of FMU fixed parameter has no effect on results
ADMS-38549 Warning message about MSVS requirements while exporting FMU v2
needs to be generic
ADMS-38452 Adams issues diagnostic message listing wrong compiler versions during
FMI Export
ADMS-19054 Update Simulink block limitation documentation
ADMS-6446 Adams Controls cannot handle EASY5 timed switch events correctly
ADMS-37072 Leaving two single quotes ('') in Output files Prefix tab in Adams Plant in
Simulink causes "Error in Initialization''
ADMS-7377 Function evaluation produces incorrect results with model of coor. repar.
Known Issues
ADMS-39685 On Linux, the Controls Plant Export dialog will hang if Adams Car was
started from the command line like so: "<install_dir>/mdi -c acar ru-
standard i" instead of via the toolbar like so: "<install_dir>/mdi and then
select the Adams Car icon". The workaround is to enter a carriage return in
the startup terminal window to avoid the hang.
ADMS-39685 On Linux, the Controls Plant Export dialog, when target software is set to
either FMU option, will not close after clicking OK if DIRECT
communication mode was selected. Click Cancel or "x" to close the dialog
after clicking OK.
14 Adams 2017.1 Release Guide
Adams Co-simulation Interface
* The ACSI 2016 and ACSI 2017.X versions require a workaround for the case of Adams models co-
simulating with Marc versions 2014.2 and 2015. Marc 2016 does not require this workaround. For details
see the "Special requirements to run Marc" section of the Adams product documentation (online Help)
under "Adams Co-simulation Interface."
Known Issues
ADMS-34101 Cannot export .adm files from AView which were setup for ACSI without
ACSI_Adams.dll present in working directory
ADMS-33986 Adams-Marc co-simulation with two Marc process and with single thread
option set as "Yes" will issue the following error for the second Marc
process: "An Adams-Marc co-simulation analysis was aborted due to a
program interruption or a communication error"
CHAPTER 1 15
Whats New
Adams Driveline
Issues Resolved
Adams Durability
Issues Resolved
Adams Explore
Issues Resolved
Known Issues
Issues Resolved
Known Issues
ADMS-16820 Browsing for Adams Explore Excel files is not working in MS Edge
Browser on Windows10 if the original is still open in Excel when
submitting the job. Workaround is to close the file or simply use another
browser like IE or Firefox.
ADMS-20717 Launching the Adams Explore web server and job server from the Adams
View or Adams Car GUI on a Linux machine through remote access from
a Windows machine via some tools (e.g., Exceed and Putty), the Adams
View or Adams Car session will lock up while the web server and job server
are running. One must close those windows to regain control of the session.
A workaround is to not launch the Explore web server and job server from
an Adams GUI but, instead, launch it from the Adams command line (e.g.,
"adams2016 aexplore ru-jobserver" and "adams2016 aexplore ru-
webserver").
18 Adams 2017.1 Release Guide
Adams Flex
Adams Flex
Issues Resolved
ADMS-15189 Description about "preserve stress and strain modes" feature of Flex toolkit
ADMS-36959 FEA_MEM_SETTING and similar are missing in FLEX_BODY
statement docs
ADMS-28936 equation has a typo in the Flex theory document in the online help
ADMS-32394 Interface node created at different location than the specified in
Adams/Viewflex import mesh method
ADMS-19066 The Flexbody .MTX file not updated when Marker attached to the flexible
body is deleted.
ADMS-12631 Blue columns are not related to Refresh Table button on Modify Modal ICs
window.
CHAPTER 1 19
Whats New
Adams Insight
Known Issues
ADMS-18145 Exported HTML Report from Insight is not working with MS Edge
Browser on Windows10; may work in later versions of Edge; iini the
meantime use another browser like IE or Firefox
20 Adams 2017.1 Release Guide
Adams Machinery
Adams Machinery
Issues Resolved
Known Issues
Issues Resolved
ADMS-35207 Update Adams/Machinery GUI plot with the latest Adams version plot in
Adams Online help
ADMS-37398 Problem with belt tension calculation
ADMS-39277 Crash detected when modify the parameter 'number of contact planes' in the
gear set
ADMS-38581 Adams 2017 cannot solve Planetary Gear Set externally.
ADMS-39238 "Intel Visual Fortran run-time error" appears when try to modify the
Planetary Advanced 3D Contact gear
ADMS-36054 Error occurs while executing "Machinery Cable Tutorial" from Adams
online help
ADMS-33994 "division by zero" error while importing a cable cmd model.
ADMS-37452 Cannot use simplified formulation gear sets on rotating parts
ADMS-35705 A/Machinery - Simplified Spur Gear model does not work properly if
driven gear is fixed
ADMS-32078 Gears not rotated properly when two racks are using the same pinion
Known Issues
ADMS-32062 An error message appears if the user deletes the design variables created for
Detailed bearing geometry parameters
ADMS-32055 Duty cycle bearing life does not support analyses run via external
Adams/Solver launched from Adams/View or via standalone
Adams/Solver.
ADMS-31992 Some instances of bin file corruption observed which result in inability to
open them in Adams 2013.2 and later without error. Workaround is to
export .cmd files.
ADMS-32143 When copying a cam system its follower motion will not be copied. Both
cam systems will reference the same follower motion object.
ADMS-31994 Span requests do not persist when modifying chain (open and closed) and
belt
ADMS-31900 Chain system guide tensioner's piston & housing mass properties are
uneditable.
22 Adams 2017.1 Release Guide
Adams Machinery
ADMS-31886 Duplication of gear set occurs when merging models including gear
systems
ADMS-22363 Unable to chage direction of motor in runtime with curve based method for
motor.
ADMS-31960 If users run the motor with the exact rated condition of voltage and fluency
and the external load (load on motor) is within the motor torque limit, then
the AC motor is showing abnormal behavior since current is remaining
constant but torque is changing as per load applied. Workaround is for the
user to specify slightly lower supply voltage and frequency than is rated.
CHAPTER 1 23
Whats New
Adams MaxFlex
Issues Resolved
Known Issues
Issues Resolved
Known Issues
ADMS-30608 MaxFlex body does not appear initially in animation when opening a .bin
file; one must click play or load animation for it to appear.
ADMS-28164 When animating MaxFlex bodies with stress contours two progress meters
will be shown (one for calculating the stresses and the other for applying
the colors) when ideally only one should be shown
ADMS-26175 On Linux systems while browsing for a .bdf it defaults to the last browsed
.bdf directory as opposed to the current working directory
ADMS-25798 Outline graphics generated for nonlinear flexible bodies do not respond to
hide/show toggle
ADMS-20258 In MaxFlex bodies' BDF definitions all independent degrees of freedom of
RBE2 must have non-zero stiffness value or else the model may have
difficulty solving in Adams. For example, if dependent GRIDs of RBE2 are
only connected to solid elements, they won't have rotational stiffness, so the
independent degrees of freedom of the RBE2 should be specified in the
BDF as 123 instead of 123456. In addition, the number of dependent
GRIDs of RBE2 should be more than 2 in this case to avoid the singularity
of the independent degrees of freedom computation.
ADMS-28656 Extraneous messages in the Info window ("calling ESTIMATE
Program...") when simulating via external solver from A/View and the
model contains a nonlinear flexible body.
CHAPTER 1 25
Whats New
Adams Mechatronics
Direct Communication Mode for FMI Co-simulation
FMU Export for SIMulation Workbench
Heterogeneous FMU Export
Forward Compatible FMU
SMP Support for Co-simulation FMU
Issues Resolved
With this release of Adams a new "Direct" communication option for FMI-based co-simulation has been
implemented. This option is meant to improve the communication performance between the FMU
master and slave during co-simulation. It is accessed from the Adams Mechatronics Control System
Creation dialog and is available only for Adams co-simulation with a master process based in another
FMI-compliant tool. It does not support any Adams-as-the-master co-simulation scenarios. And, it is
restricted to use with Adams Solver C++ (it does not support Adams Solver FORTRAN).
Previously existing FMI co-simulation communication modes continue to be supported. The table below
compares these three options.
Communication
Mode Adams Master FMI Master Speed
TCP/IP X X lower
Pipes X X medium
Direct X high
26 Adams 2017.1 Release Guide
Adams Mechatronics
See the "Real Time Analysis with SIMulation Workbench" entry under the Adams Real Time section of
this document for further details on these kinds of analyses.
Issues Resolved
Adams PostProcessor
Plot Panning Improvements
Issues Resolved
Known Issues
Issues Resolved
ADMS-36912 Multiple plot config file reading creates undesired curve layout
ADMS-34963 Symbol of the scatter plot does not update automatically in the legend of
the plot
CHAPTER 1 29
Whats New
ADMS-34835 Plot disappears while switching between the table and plot if the active
layout is to another plot.
ADMS-24163 When deleting a plot page, the names of the plot becomes the defaults
name.
ADMS-14238 h-axis and v-axis overlaps the curve when fit the entire extend button is
clicked
ADMS-18898 Plot panning is not logical
ADMS-28176 Plotting FFT results in the error 'SPLINE requires that X values be in
strictly ascending order'.
ADMS-39149 Adams View session crash when click on Reload Simulations icon in APPT
ADMS-38095 Friction output result differs between "Request" and "Result set".
ADMS-7304 Flex Body recaches stress when I change Start frame in Animation tab
30 Adams 2017.1 Release Guide
Adams PostProcessor
ADMS-26742 Reading a plot config file containing a bode plot will make adams throw an
error
ADMS-21310 Curve editing on imported rsp plot is not working.
ADMS-25306 Poor Flexbody Vertex Matrix Performance when animation flex bodies in
Adam Car on Windows
Known Issues
ADMS-30608 MaxFlex body does not appear initially in animation when opening a .bin
file; one must click play or load animation for it to appear.
ADMS-28164 When animating MaxFlex bodies with stress contours two progress meters
will be shown (one for calculating the stresses and the other for applying
the colors) when ideally only one should be shown
ADMS-26175 On Linux systems while browsing for a .bdf it defaults to the last browsed
.bdf directory as opposed to the current working directory
Real time simulation can be defined as the ability for the Adams model to complete at a rate equal to, or
faster than, the actual "wall clock" time at which the physical system would run. Real time simulation
enables hardware-in-the-loop (HiL) and some software-in-the-loop (SiL) workflows. Adams Real Time
is a set of capability to help Adams models run at real time both "online" (that is, on real time operating
systems) and "offline." Offline real time simulations might be done to satisfy SiL scenarios in which it
is desired that the Adams model run at real time so as provide the other software tools(s) in the loop with
realistic response (for example, a mechanical system responding in real time to an electronic controller).
Online real time simulations might include either HiL or SiL usage or both.
Three primary factors determine an Adams model's suitability for real time simulation: model
complexity, model excitation and hardware. As model complexity (for example, degrees-of-freedom,
contact, flexible bodies and so on) decreases the chance of achieving real time speed increases. As model
excitation frequency decreases and actuation functions get smoother the chance of achieving real time
speed increases. And, naturally, as the hardware environment upon which the model is more powerful
(especially CPU speed and sometimes the amount of available memory to some extent) the chance of
achieving real time speed increases.
Beyond the fast solving Adams model itself, two key capabilities are frequently required to achieve real
time workflows and have been introduced in this initial release of Adams Real Time: a fixed step
32 Adams 2017.1 Release Guide
Adams Real Time
integrator and the ability to run on real time environments. New features in Adams 2017.1 related to these
items are described below.
The third output is the number of real time violations (RTI>1) across all sampling intervals. This is
provided for users whose real time systems allow some limited number of violations per simulation.
If not running in eprint mode (that is, DEBUG/EPRINT) then only the overall RTI is printed at the end
of the analysis. If suppressing the .msg file output completely, as may be the case on the real-time
environment to improve performance, then of course none of these new real time reporting statistics are
available.
Below is an example use case scenario illustrating how a user attempting to run an Adams model in real
time at given sampling time might proceed employing this new report information in conjunction with
the new fixed step integrator option:
1. Run simulation on target system using GSTIFF or HHT and default settings, in order to generate
a baseline solution.
2. Run simulation on target system using fixed step GSTIFF, having chosen reasonable values of
the INTEGRATOR parameters FIXIT and HRATIO.
3. Examine message file output for report on real time, paying particular attention to real time index
and minimum achievable sampling time output.
a. If report indicates simulation ran in real time, then check the fixed step solution against the
baseline.
i.If errors are acceptable, then finished.
ii.If not, then re-try with increased FIXIT, increased HRATIO, or a combination of the two.
b. If not real time, then either
i.Re-try with decreased FIXIT, decreased HRATIO, or a combination of the two.
ii.Further simplify the model.
4. Repeat step 3 until simulation meets all criteria.
Mockup Interface (FMI). A functional mockup (FMU) unit exported from Adams Controls or Adams
Mechatronics within Adams View or Adams Car can now be imported into SimWB.
In terms of specific version support, MSC has certified Adams Solver in the following two environments:
iHawk running RedHawk Linux 6.5 with SIMulation Workbench Control Center 7.5
RedHawk Linux 7.0 with SIMulation Workbench Control Center 7.4
For both of these environments it is the Adams RedHat Linux 6.7 installer which must be installed on the
RedHawk machine. Do not use the Adams RedHat Linux 7.1 installation with either environment.
As for hardware for Adams we recommend faster CPU (clock speed) over number of cores. For example,
we have found the clock speed to have more impact on Adams performance than having a system with
more than 8 cores.
Also, when participating in co-simulations performed in the SimWB real time environment, Adams Car
based FMU models support the Logitech G27 automobile input devices (steering wheel, gear selector,
and accelerator and brake pedals).
See the new feature example, "A17-1_003_RT_Solver_on_SIMultionWorkbench", included with this
release for detailed usage steps.
Note: There is a problem within SIMulation Workbench where its FMU Master is unable to run
an Adams FMU. A patch from Concurrent for SIMulation Workbench to address this issue,
"SImWB_updated_file.zip", is provided with this release of Adams. It updates a file in the
SimWB installation ("fmuMain.c" installed under /usr/local/ccursim/FMIL).
CHAPTER 1 35
Whats New
Licensing
In order to build Adams models and run them in real time scenarios one will need the following pre-
requisites licensed:
A user interface in which to build the Adams model typically, but not limited to, Adams View or
Adams Car (note: this is not required during runtime of the real time scenario)
Adams Solver to solve baseline results via the traditional variable step integrators and to enable
runtime of any real time scenario
Adams Controls to export the FMU of the Adams model for participation in real time co-
simulations and to solve it during runtime
Additionally, the following two license features are specific to real time workflows:
Adams_Solver_FixedStep: this enables use of the Adams Solver fixed step integration option
in any scenario offline or online
Adams_Solver_RealTime_OS: this enables Adams Solver to function in any of the supported
real time operating system environments
Known Issues
ADMS-39753 The Getting Started with Adams Real Time tutorial "Using the Fixed Step
Integrator" will exhibit different behavior on Linux platforms for steps 16
and 18. While consistency with these particular steps is difficult to achieve
accross platforms due to the fact that the analysis is purposely running at
high error, the edition of this tutroial published in the 2017.1 New Feature
Example "A17-1_002_Fixed_Step_Integrator" employs settings that are
more likely to produce consistent effects.
36 Adams 2017.1 Release Guide
Adams SmartDriver
Adams SmartDriver
Issues Resolved
ADMS-39234 The vehicle can't run the second lap when the first and last points are not
coincident in some road formats
CHAPTER 1 37
Whats New
Adams Solver
Fixed Step Integrator Option
Issues Resolved
Known Issues
It should be noted that the integration step size remains 'constant' or 'fixed' throughout the simulation
when the fixed step option is selected. The combination of DTOUT and HRATIO settings specifies the
integration step size.
The dependencies of the other INTEGRATOR statement/command arguments when FIXIT is specified
are as follows:
MAXIT will be ignored
ERROR will be ignored
INTERPOLATE will be ignored and always treated as though it is set "OFF"
PATTERN can still be specified; note that default for GSTIFF remains T:F:F:F:T:F:F:F:T:F. This
is suitable for values of FIXIT less than or equal to 4. If larger values of FIXIT are necessary one
may want to consider setting PATTERN = T:F:F:F:F:F:F:F:F:F so as to avoid the time
consuming Jacobian re-evaluation during newton iterations for real-time performance
HINIT can still be specified, but if set >DTOUT/HRATIO then Adams Solver will reset it =
DTOUT/HRATIO
HMIN will be ignored
HMAX can still be specified but will be ignored if less than DTOUT/HRATIO
KMAX can still be specified but will have no effect since the fixed step GSTIFF always runs
with K=1 and HHT always runs with K=2. So, in effect we have a fixed step and fixed order
integrator
CORRECTOR will have no effect
An example of adm/acf language usage for employing the fixed step option:
INTEGRATOR/GSTIFF, I3, FIXIT=3, HRATIO=4, MAXERR=0.05
Employing the Fixed Step Option via Adams View and Adams Car
The Solver Settings dialog accessed through either Adams View or Adams Car has been extended to
include the three new options related to the fixed step option (part of the parameters exposed via the
"More" checkbox). There is now a "Fixed Iterations" option menu which defaults to "Off" (for traditional
Adams Solver integration) but can also be set 1-10. If set 1-10, then there are optional fields available to
set the other two fixed step related parameters, "HRatio" and "Max Error". See the descriptions of these
items above in "Employing the Fixed Step Option in the Adams Solver Language"
CHAPTER 1 39
Whats New
Issues Resolved
ADMS-38982 When only the Intel Fortran compiler is installed, the script should use the
gnu C compiler for linking when Intel C isn't installed.
ADMS-28188 initial conditions tables lack information for point_mass and fe_part bodies
ADMS-32427 CNFSUB and CFFSUB does not provide geometry IDs in the
sAdamsContactFriction struct
Known Issues
Adams Tire
Local Tire Solver
High Performance Setting Management
Issues Resolved
In the Adams Car wheel subsystem file (.sub), the keyword 'HIGH_PERFORMANCE' can be set for the
tire model. The default value for the keyword (when not present) is 'NO'. When
HIGH_PERFORMANCE is set to 'YES', the PAC2002 is set to a high performance mode which should
reduce the required CPU time of the simulation.
When HIGH_PERFORMANCE = 'YES' in the subsystem file (.sub), the keywords with extension _HP
in the tire property file (.tir) are taken instead of the base keywords, these are:
CHAPTER 1 43
Whats New
[MODEL]
LOCAL_SOLVER_HP = 'YES'
[CONTACT_COEFFICIENTS]
N_WIDTH_HP = 2
N_LENGTH_HP = 2
ROAD_SPACING_HP = 0.001 $ in (mm)
Thus, the LOCAL_SOLVER_HP setting replace the LOCAL_SOLVER setting and so on. When the _HP
settings are not defined by the user in the tire property file (.tir), the values mentioned above are used by
default.
Of course one must take care to ensure that the proper balance between performance and accuracy is
achieved when employing this new high performance mode. Currently this available only for the
PAC2002 tire model.
Issues Resolved
ADMS-38723 F1 help is not opened for PAC2002 TDFT... Convert to PAC2002 dbox
ADMS-33552 Tire radius is determined incorrectly during straight and skidpad static set-
up for some roads
ADMS-38928 Example aircraft tire file and directory missing from installation
ADMS-38769 Time values of TDFT plot is different from TDX
ADMS-38588 opencrg code showing compiler warnings
ADMS-39572 Adams tire 3D contact documentation error
ADMS-37881 TDFT support for MSCADS optimizer not useful
44 Adams 2017.1 Release Guide
Adams Vibration
Adams Vibration
Issues Resolved
Known Issues
Issues Resolved
ADMS-35727 Need to update Adams Vibration Modal Coordinates Plot in Adams online
help
ADMS-39255 Error has happended when simulating vibration analysis while displaying
modal energy
ADMS-36836 "Marker Mode" feature in Adams/Vibration not working.
ADMS-35282 Frequency Range fields option are not displayed after used Import Settings
From Existing Vibration Analysis option
ADMS-37514 Dialog to enter cross correlation has wrong title
ADMS-35294 modal info computation upper frequency range value integer
Known Issues
ADMS-22060 Vibration analysis won't launch after a dynamic analysis has been run first
and animated in Adams PostProcessor
ADMS-16221 OUTPUT variables referencing deactivated BUSHING forces cause
analysis failure. Workaround is to comment out or otherwise deactivate the
OUTPUT variables.
ADMS-17558 Import of vibration result incorrectly requires user to associate it with an
existing analysis and auto analysis naming is incorrect. Workaround is to
manually rename the analysis object.
CHAPTER 1 45
Whats New
Adams View
Last Release for Precision Shaded and Z Short Shaded Render Options
Issues Resolved
Known Issues
Issues Resolved
ADMS-33167 Adams 2015.1 Release guide still shows CATIAV5 .crg files can be
imported into Adams
ADMS-38868 Update "View Options" - 'Setting Up the Window Layout' Adams GUI
image in Adams Online Help Image
ADMS-35730 Update Create Chain dbox with latest Adams Version dbox in Adams
Online help
ADMS-39193 STR_REPLACE_ALL() missing from DOCS
ADMS-26328 When you create a flexible tube with Centerline in ViewFlex, one can no
longer give the node numbers of attachments
ADMS-39156 ViewFlex attachment definition produces wrong results when using the
solid feature.
ADMS-26025 Experiencing regular crashes on Linux
ADMS-17135 Errors writing Coupler Results Set
46 Adams 2017.1 Release Guide
Adams View
ADMS-35779 Python "info" property, when called on an object from a previous session
can cause session termination
ADMS-26740 Online help doc is not available for the geometry translation option
"TranslateCoordinateSystem"
ADMS-14205 Update Adams Online Help for Solidworks and Inventor CAD model files
are not supported on Linux Platforms same as CatiaV5
ADMS-38529 Adams View session crash while opening cmd FTire model
ADMS-27220 Adams allows to create more than one outline (geometry) under ground
part.
ADMS-15635 Random crash found precceded by "NVIDIA OpenGL Driver" error dialog
box.
ADMS-38158 Need to change chinese translation string for "Current"
ADMS-25655 All the geometries comes under one part with parasolid import.
ADMS-13347 Inserted row numbers are visible after deleting selected rows in ViewFlex
attachments.
ADMS-32824 Adams terminates while Merging two model with FE part and DFL
Known Issues
ADMS-38479 Random and unreliably reproducible session failure when running internal
solver from within Adams View with more then one thread (i.e., Thread
Count > 1) on Linux platforms. Due to the thusfar random nature of this
defect, it is suggested to simply try re-running the analysis as a possible
workaround or set Thread Count to 1 as a possible workaround
ADMS-23496 Error messages repeat 2-4 times when trying to apply an orthotropic or
anisotropic material in ViewFlex (which accepts only Isotropic materials)
ADMS-18024 Adams View does not allow model and analysis of same name
ADMS-28223 If .adm files imported into AView contain contacts employing revolution
type geometry, then simulations run from Adams View will not run and
issue an incorrect error message ("Geometries contain duplicates in
contact"). Workaround is to run the .adm in standalone Adams Solver.
ADMS-22432 Innocuous macro error issued when launching FELoad dialog a second
time subsequent defining one with user subroutine option
ADMS-22407 FE Parts in some conditions will assign same (duplicate) id=1 to
MATERIAL statement in .adm file
ADMS-22402 FE Part isn't translated properly in model merge operations using offsets.
ADMS-20196 Force Display ON/OFF option is not working for the FE Load
48 Adams 2017.1 Release Guide
Adams View
ADMS-35275 Importing some JT models and then exporting them as IGES models causes
Adams View session instability
ADMS-23472 Dimensioning lines and self-intersecting splines are ignored when
importing IGES geometry
ADMS-22497 "Switching the Color option during CAD data import in the same session
of Adams causes problems.
The model imported after switching the option is blank or incomplete."
ADMS-32057 Cam systems with 2 followers do not copy/paste properly if the ground
reference marker is also selected (e.g., by mistake when selecting via drag
box in graphics window). Workaround is to copy from the model browser
ADMS-16288 Some options on the View Management Orient command not working
correctly. Workaround is to rotate the View via the tools available in the
graphics window and toolbar.
ADMS-33645 Innocuous warning "Discarded range with reserved name" is found in the
log file when importing an Adams Explore workbook in Adams View
ADMS-32686 Refreshing Adams Explore web page takes you always back to main page
ADMS-32679 Hyperlinks between analysis name on Analyses tab and solver settings of
the Model tab are lost in the output workbook of Adams Explore
ADMS-37795 When exporting .adm files from Adams View, "Roundoff Values" has no
influence on the number of digits in the .adm files. Unchecking it should
cause AView to ignore the "Significant Digits" setting, but this is not the
case.
ADMS-23940 If you export an Adams model to CEI Ensight via the co-animation export
capability and that model contains a flexible body, and the flexible body
doesn't use the same length units as the model itself, the resulting bodies in
Ensight will not be scaled or located properly. A workaround is to scale the
flex body in Ensight.
ADMS-21941 Torsional springs missing when merge two models (each containing one)
via "Model assemble" command. Workaround is to use a rotational sforce
instead.
CHAPTER 1 49
Whats New
ADMS-23849 Error "An empty body was encountered when converting the parasolid to a
shell" when importing a parasolid geometry
ADMS-22004 Zero volume of cylinders with 1 or 2 segments, with angle extension less
than 360 degrees
ADMS-23976 On machines with multiple graphics hardware options, use of the "CPU
integrated" graphics hardware (for example, "Intel HD Graphics") may
cause problems with display of flexible bodies and FE parts in wireframe
mode. The workaround is to use the other graphics hardware option (for
example, the "NVIDIA Processor").
ADMS-19798 Plot Transfer Function dialog box option menu is located improperly and
too narrow.
ADMS-33723 Twice importing certain NX models with the color option off can cause the
Adams View session to terminate unexpectedly
ADMS-26617 Sixth decimal place errors in part density values when importing Creo
models of units other than kg and m.
ADMS-21230 Usage of MBFolderName in UDEs does not work if one tries to add items
to a pre-defined named entry in the model browser. One must select a new,
unique folder name.
ADMS-12740 Error in Mass property calculated for copied part with the original part
being a parasolid for some (not all) externally imported parasolid files
ADMS-17344 If one uses the Database navigator to look at Associativity and then close it
and try to modify something using the Edit Modify menu, one can see the
Database navigator stuck in "Associativity" mode. The way to recover is to
go to the Database Navigator and switch to Browse mode and close it and
then go back to the Edit Modify menu.
50 Adams 2017.1 Release Guide
Adams View
ADMS-37876 Running Adams View on a SUSE Linux 11 SP3 virtual machine using
native graphics can cause exception 11 errors leading to Adams View
termination when picking geometry. Workaround is to switch the Adams
graphics driver to HOOPS.
ADMS-34828 Creation of a flexible body via ViewFlex does not inform the user when
creation fails due to exceeding the number of nodes allowed in Adams
Student Edition
ADMS-24977 Window header text is garbled on the Function Builder's Assist dialog
ADMS-19376 Excessive memory consumption after reading in .res file with multiple
analyses using the default results parser known as "EXPAT". Workaround
is to select the "DOM" parser via and environment variable:
MSC_RESULTS_DOM=1
ADMS-34194 On Windows 10 virtual machines when VMware tools are installed to make
a full screen virtual machine, then some of the Adams-View-based product
sessions might terminate unexpectedly (Adams View, Adams Car, Adams
Driveline). Uninstalling the Vmware tools alleviates the issue.
ADMS-24771 Text color is not displaying properly (faint) for list option on RHEL6.3
Linux64 OS
CHAPTER 1 51
Whats New
ADMS-24007 The font sizes in Adams View based products in version 2014 and later are
not very clear. Menus do not take the system settings "system font size".
ADMS-23899 Some labels in the dialog box builder are obscured under Attributes: Value
when Windows font size set to 125%
ADMS-23308 Definition container is missing CT field for single component torque.
Workaround is to create the torque and modify from there.
ADMS-19599 Hitting a menu button or any other action in the .main window does not
make the main window view the active one
ADMS-16818 Some extraneous messages are printed out during ViewFlex solution
ADMS-16207 Adams session terminates while creating flexible bodies via ViewFlex and
the working directory does not have sufficient space for the generated files.
ADMS-14909 ViewFlex via extrusion with generic cross-section will only function for
cross-sections which can be safely meshed via and elliptical pattern.
ADMS-36730 On Windows the Python modules "pip", "easy_install" and "wheel" do not
function by default. Two workaround options are:
(A) Every time you want to use these first execute "adams2017 python -m
pip"
(B) Perform a one-time execution of:
adams2017 python -m pip install setuptools -U
adams2017 python -m pip install wheel --ignore-installed
adams2017 python -m pip install pip -U
Then, add $topdir/python/win64/Scripts to your PATH environment
variable
52 Adams 2017.1 Release Guide
Adams View
MD Nastran 2006 Installation and Operations GuideMD Nastran
For more information on these or other Adams Toolbar operations, see the Running and Configuring
online help (from the Help menu in any product, select Adams Help, on the left pane, select
Configuring Adams).
Note: We recommend that you use the Adams Toolbar to start your Adams products, but
if you want to automate certain operations, use the text-based Program Menu. For
more information, see the Running and Configuring online help.
CHAPTER 2 55
Running Adams Products
For more information on these or other operations, see the Running and Configuring online help.
Tip: Select the corresponding desktop icon for the product, if you installed it on your
desktop.
Check to see if you already have a PATH variable defined under User variables. If it exists
then edit it, add a semicolon ; to the end of the existing value, and then add the bin directory
under the Adams installation directory. Otherwise select New..., use PATH for the variable name
and add the bin directory under the Adams installation directory as the value. The default
location of this directory is:
Windows Adams: C:\MSC.Software\Adams\2017_1\bin
Note: Windows appends your User PATH to the System PATH environment variable, so there is
no need to copy the existing System PATH variable to your user PATH variable. This
behavior is unique to the User PATH variable. For all other environment variables, a User
variables definition overrides a System Variables definition.
CHAPTER 2 57
Running Adams Products
Setting Preferences
This section describes how you can set preferences, such as your working directory, graphics setting, and
memory model size.
3 Getting Help
Tool Tips, 60
Online Help, 61
Tutorials and Examples, 65
60 Adams 2017.1 Release Guide
Tool Tips
Tool Tips
Tool tips display information about the item the cursor is currently over in an Adams product. The
following shows the tool tip that appears when you place the cursor over the link geometry tool.
Online Help
To help you use the Adams products, MSC Software provides online help (HTML format). To view the
online help and tutorials, you can use your default Web browser. An example of online help is shown
below
Navigation arrows at the top of the pane to let you scroll through topics one at a
time.
Automatic sync to show you where your current topic is in the table of contents (TOC).
This is very helpful if you, for example, search for a topic and want to know if there are more
topics on the subject. It shows you where the topic is in the TOC, allowing you to see whether or
not there are more topics with it.
Searching
You can search all the help files in HTML format for a particular product or all Adams products.
2. Press Search button at the top of the help window, enter the search text, and then
press the Go button .
The results appear in the pane on the left, replacing the table of contents.
3. Click the topic you want to view.
Printing
To print a file:
In the help system you can select the Print button . to print the topic that you are viewing
You can select the PDF button . to see the entire PDF file pertaining to the topic and print
the file like a regular PDF file. Notice that some of the images in PDF file may be cropped.
Index
The Index tab displays an alphabetical list of keywords associated with help topics. To view index entries,
you can select a letter group to display the entries for that group. When you click on an index entry, the
related topic will display in the topic frame. You can select Indexes in a product specific help or in the
main help system.
CHAPTER 3 65
Getting Help
4 Supported Versions of
Integration Products
Support for Easy5 and MATLAB, 68
Supported Versions of Integration Products, 69
68 Adams 2017.1 Release Guide
Support for Easy5 and MATLAB
Easy5
This release of Adams Controls is certified to run with Easy5 2015, 2013, 2010, 2010.1.2, 2010.1.3 and
2010.1.4. Easy5 version support is subject to change. For the latest information, see updates to the
Release Guide here:
http://simcompanion.mscsoftware.com/.
MATLAB
The supported versions of MATLAB is R2016a and 2016b.
For more information on MATLAB platforms and compatibility, see:
http://www.mathworks.com/support
Note: If you want to co-simulate with Easy5 or MATLAB and you are running Adams Controls
on one of the platforms that Easy5 or MATLAB does not support, you should consider
using TCP/IP communication. This allows Adams Controls to communicate with Easy5 or
MATLAB even though the codes are running on different platforms.
CHAPTER 4 69
Supported Versions of Integration Products
The Mathworks, MATLAB R2016a Version 9.0.0.341360 Red Hat Enterprise Linux
Inc. MATLAB R2016b Version 9.1.0.441655 6.3 x64
Simulink Version 8.6 Adams Controls SuSe 11 SP2 x64
MATLAB Coder Version 3.0 Windows 7 x64
Simulink Coder Version 8.9
MSC Software Easy5 2015, 2013, 2010, Adams Controls Red Hat Enterprise Linux
Corporation 2010.1.2, 2010.1.3 and 6.3 x64
2010.1.4 SuSe 11 SP2 x64
Windows 7 x64
MSC Software MD Nastran R1 and above Adams Car Ride LINUX and Windows
Corporation
Adams Vibration
MSC Software MSC.Nastran V69.X and above Adams Durability LINUX and Windows
Corporation
Adams Flex
MSC Software Marc 2005 and above Adams Durability LINUX and Windows
Corporation
2003 and above Adams Flex
MSC Software Fatigue 2001 and above Adams Durability LINUX and Windows
Corporation
nCode FE-Fatigue Version 5.2 and above Adams Durability LINUX and Windows
ANSYS, Inc. ANSYS V6.0 and above Adams Durability LINUX and Windows